Après des semaines d’attentes voici mon dernier né : plg_relatedarticlestags version 1.0 ou Plugin Related Articles Tags, c’est plus joli je vous l’accorde !

Ce plugin est compatible Joomla! 1.5 NATIF. Une demo est disponible en cliquant ici : DEMO

Pour le télécharger il vous suffit de cliquer ici :

DOWNLOAD plg_relatedarticlestags_1.3.zip

Fonctionnalités :

MAJ Version 1.3 (10/10/2009) :

• Correction du bug pour l’affichage aléatoire des articles, la fonctionnalités fonctionnent dorénavant.
• Implémentation du Mootools Accordion à la place de l’infobulle, pour un rendu meilleur de l’introduction des articles.

MAJ 1.2 :

• Correction d’un bug qui faisait mal fonctionner le plugin parfois.

MAJ Version 1.1 :

• Le plugin est maintenant traduit en français et anglais ainsi qu’en italien et espagnol (pas totalement), merci à Celena et Piko
• Possibilité de trier les articles : les plus récents, les plus anciens ou aléatoire.
• Possibilité d’afficher une infobulle sur chaque lien, contenant le texte d’introduction de l’article.
• Possibilité de limiter l’affichage de cette introduction, en spécifiant un nombre de lettres à afficher.

La principale fonctionnalité de ce plugin résulte dans le fait qu’il permet d’afficher, en dessous de vos articles, des liens vers d’autres articles relatifs à celui que vous visionnez. Cette corrélation s’effectue automatiquement. En fait le plugin cherche les mots clés (TAGS) de vos articles et créé des liens entre les articles possédant des mots clés similaires.

A cela s’ajoutent plusieurs critères, qui vous permettront de mieux filtrer votre affichage :

• possibilité de définir le nombre de liens vers des articles relatifs à afficher
• possibilité de définir les sections dans lesquelles le plugin cherche à matcher des mots clés, par défaut le plugin cherche dans toutes les sections
• possibilité de définir les catégories dans lesquelles le plugin cherche à matcher des mots clés, par défaut le plugin cherche dans toutes les catégories
• possibilité de définir dans quelles sections le plugin doit apparaitre, par défaut toutes
• possibilité de définir dans quelles catégories le plugin doit apparaitre, par défaut toutes
• possibilité d’entrer des mots clés interdits, qui ne seront pas matché par le plugin

D’autre part, le plugin possède sa propre feuille de style (plugin/content/relatedArticlesTags/relatedArticlesTags.css) ainsi que ses propres fichiers de langues (disponibles de base en français et anglais), je vous laisse la joie de le traduire et de me donner vos fichiers pour que je les ajoute au pack d’installation, si traduction vous faites.

Pour toutes question ça se passe à la suite de cet article.

En espérant que ce plugin vous sera utile (pensez à me noter sur extensions.joomla.org, merci),

merci,

Grâce à ces quelques lignes de codes vous pourrez utiliser pleinement l’API avec notamment les class d’accès à la Base de données, aux informations utilisateurs, aux informations session etc… Bref tout ce qui existe dans Joomla pour vous faciliter la tâche (merci JFactory).

Voici donc le code miraculeux :

// On définie que c'est un fichier familier à Joomla
define('_JEXEC', 1 );

define('JPATH_BASE', '../../../' );

define( 'DS','/' );

// On inclue les constantes
require_once ( JPATH_BASE.DS.'includes'.DS.'defines.php' );
// On inclue le framework
require_once ( JPATH_BASE.DS.'includes'.DS.'framework.php' );

// On inclue la fameuse class JFactory
require(JPATH_BASE.DS.'libraries/joomla/factory.php');

$mainframe =& JFactory::getApplication('site');
$mainframe->initialise();

Cependant pour la constante JPATH c’est à vous de trouver le bon chemin par rapport à là où vous exécutez votre fichier (dans mon cas je suis dans dossier comme ça : modules/mod_mon_module/dossier/mon_fichier.php)

Voilà j’espère que ça vous aura aidé autant que pour moi.

Aujourd’hui nous allons donc voir comment utiliser le framework de Joomla! 1.5. Je ne vais pas me lancer dans un étalage complet du framework mais plutôt du strict minimum, indispensable pour hacker, ou même créer des modules ou composants.

1. Se connecter à la base de données

Rien de plus simple, il faut créer une instance de la class JFactory :

$database = &JFactory::getDBO();

2. Exécuter une requête (insertion de données dans la base)

Maintenant que nous avons notre objet $database il suffit d’appeler la méthode setQuery pour déterminer la requête à éxécuter :

//j'insère dans la table users et dans le champ username, le pseudo TOTO.
$database->setQuery("INSERT INTO #__users (`username`) VALUES ('TOTO')");

#__users est en fait jos_users dans ma base de données, mais Joomla! reconnait #__ comme étant le préfixe de vos tables (le mien est jos, mais le votre peut être différent, cela permet donc à Joomla! de s’adapter quelque soit le préfixe de vos tables).

Puis on éxécute la requête :

$database->query();

3. Exécuter une requête (sélection de données dans la base)

C’est bien beau d’insérer des données dans la base, mais il est parfois utile de récupérer des données, c’est très simple encore une fois, toujours avec le même objet, il suffit d’appeler la méthode setQuery encore une fois (cette fois je met la requête dans une variable, que j’appelle dans la méthode setQuery :

$query = "SELECT username FROM #__user WHERE id=1"; //Je sélectionne
le pseudo où le champs id vaut 1
$database->setQuery($query); //J'exécute la requête

Ensuite on traite les données récupérées pour en faire quelque chose (par exemple dans ce cas précis, les afficher) :

echo $database->LoadResult(); //Ce qui écrira toto si
l'utilisateur avec l'id 1 dans ma base s'appelle toto

Par contre si vous faites une requête qui renvoie plusieurs résultats vous devez appeler la méthode loadObjectList :

$query = "SELECT * FROM #__categories"; //On prépare la requête
$database->setQuery($query); //On éxécute la requête
$rows = $database->loadObjectList(); //On charge les
résultats de la requête dans l'objet $rows 

foreach ($rows as $row) {

echo $row->title ." : ". $row->description."<br />"; //On affiche le
titre de chaque catégorie et sa description

}

Et voilà vous avez les cartes en main pour effectuer des choses simples dans Joomla! 1.5 en utilisant son Framework et donc en limitant les failles de sécurités.

Pour toutes questions ça se passe à la suite de l’article dans les commentaires.

Enjoy !

Nous allons aborder un thème très utile lorsque vous souhaitez créer des modules ou composants ou même plugins dans Joomla! 1.5. Il s’agit de travailler avec les données liées à la session de l’utilisateur connecté sur votre site. Ainsi vous pourrez effectuer des scripts en fonction du statut de l’utilisateur (registered,redactor etc…) ou encore affiché simplement son pseudo, son nom, son adresse mail etc.

Pour commencer vous devez créer une instance de la class JFactory en appelant la méthode getUser(), comme suit :

$UserInfo =& JFactory::getUser();

Ensuite vous n’avez plus qu’à utiliser cet objet pour ressortir chacune des informations qui vous intéressent :

echo $UserInfo->id; //Affichera l'id de l'utilisateur
echo $UserInfo->name; //Affichera le nom de l'utilisateur
echo $UserInfo->username; //Affichera le pseudo de
l'utilisateur
echo $UserInfo->email //Affichera son addresse e-mail
echo $UserInfo->password //Le mot de passe crypté de
l'utilisateur
echo $UserInfo->usertype //Permet de connaitre le
statut de l'utilisateur (registered, administrator etc.)
echo $UserInfo->gid //L'id du statut auquel il
appartient (si le statut Administrator est enregistré
avec l'id 1 dans la base de données, alors
echo $UserInfo->gid affichera 1)
echo $UserInfo->registerDate //Affiche la date a
laquelle l'utilisateur s'est enregistré sur le site
echo $UserInfo->lastvisitDate //Affiche la date
de dernière visite de l'utilisateur sur le site
echo $UserInfo->block //Affiche 1 si l'utilisateur
est bloqué (banni du site) ou 0 s'il ne l'est pas
echo $UserInfo->guest //Affiche 1 si l'utilisateur
est un simple visiteur sur le site, 0 s'il est membre.

A partir de la on pourrait imaginer un script qui testerait si l’utilisateur est enregistré sur le site et qui auquel cas afficherait son nom, son pseudo, la date à laquelle il s’est inscrit sur le site et la date de sa dernière visite (le script en entier):

//On créer l'objet $UserInfo
$UserInfo =& JFactory::getUser();

//Si l'utilisateur est enregistré on lui écrit ses informations
if(!$UserInfo->guest)
{

echo "Salut" . $UserInfo->name . " ou plutôt
 " . $UserInfo->username . "<br />";
echo "Tu es membre de ce site depuis le
 " . $UserInfo->registerDate . " et ta
dernière visite date du " . $UserInfo->lastvisitDate;

//Si c'est un simple visiteur on lui demande de s'inscrire
}else{

echo "Vous n'êtes pas autorisé a
voir cette page, veuillez vous inscrire, merci";

}

Et voilà, ce n’est qu’un exemple, vous pouvez faire preuve de plus d’imagination.

Pour toute questions ça se passe à la suite de l’article, merci.

Download plug_cbfavouredarticles.zip

Fonctionnalités détaillées :

• Affiche les noms des contenus favorisés des utilisateurs dans leurs profils membre
• Créer un lien pointant vers le contenu favorisé
• 2 langues : français & anglais

Ce plugin est parfait pour permettre à vos membres d’échanger/partager des points de vue, des coups de cœur.

Ce plugin requiert l’installation du module mod_cd_fapa disponible en cliquant ici, et bien entendu du composant Community Builder.

Procédures d’installation :

1. Téléchargez le fichier à partir du lien ci-dessus.

2. Ouvrez l’interface d’administration de votre site Joomla!.

3. Rendez-vous dans le menu “Composants“. Survolez “Community Builder” et cliquez sur “Plug-in Management“.

4. Là vous devriez voir la liste de tous les plug-in CB installés. Allez tout en bas de la page et cliquez sur “parcourir” à côté d’ “installation d’un plug-in“.

5. Sélectionnez le package zip que vous venez de télécharger.

5. Cliquez sur “Installer“.

6. Vous n’avez plus qu’à paramétrer votre table (pour plus de précisions rendez-vous sur le site officiel de Community Builder : joomlapolis) et tester le résultat en allant sur votre profil utilisateur.

Pour toutes questions ca se passe ci-dessous (commentaires).

Voici mon dernier né, un plug-in Joomla! pour le composant Community Builder.

Ce plug-in requiert l’installation du composant Community Builder 1.1 ou 1.2 ainsi que du composant Eventlist. Il est compatible NATIF Joomla! 1.5

Download plug_cbeventlist_showevents.zip

Fonctionnalités :

CBEventlist_ShowEvents va vous permettre d’afficher dans le profil de vos membres tous les événements auxquels les utilisateurs se sont enregistrés par le biais du composant Eventlist (com_eventlist).

D’autre part il permettra à un administrateur de rajouter un événement via un lien présent dans son profil. Les utilisateurs normaux ne verront pas ce lien.

Vous pouvez visualiser une démo du plugin en cliquant sur le lien suivant : DEMO (login : test, password : test).

Procédures d’installation :

1. Téléchargez le fichier à partir du lien ci-dessus.

2. Ouvrez l’interface d’administration de votre site Joomla!.

3. Rendez-vous dans le menu « Composants« . Survolez « Community Builder » et cliquez sur « Plug-in Management« .

4. Là vous devriez voir la liste de tous les plug-in CB installés. Allez tout en bas de la page et cliquez sur « parcourir » à côté d’ « installation d’un plug-in« .

5. Cliquez sur « Installer« .

6. Vous n’avez plus qu’à paramétrer votre table (pour plus de précisions rendez-vous sur le site officiel de Community Builder : joomlapolis) et tester le résultat en allant sur votre profil utilisateur.

Pour toutes questions ca se passe ci-dessous (commentaires).