Objectif: Créer un module pour joomla qui permettra de visualiser les contenus ayant les mêmes mots clefs que le contenu que nous sommes en train de visualiser.
1 trouver un nom.
Il va falloir commencer par trouver un nom à son module. Les développeurs de joomla ont mit au point une convention, tous vos modules doivent commencer par le prefixe « mod_ ».
Nous appellerons donc notre module « mod_relcontent ».
2 créer un espace de travail
Afin de pouvoir commencer à travailler il faut créer un répertoire au sein duquel nous pourrons faire quelques expérimentations.Ce répertoire sera créé en local, il n’a y a pas encore le minimum vital pour que l’on puisse l’installer dans joomla.
(En fonction de votre environnement de travail la création d’un répertoire peux-être effectué de plusieurs façons, je vous laisse le soin de vous reporter à la documentation de votre système d’exploitation).
3 Créer ses fichiers de travail
Il va falloir créer deux fichiers, un fichier php et un fichier xml, ces deux fichiers devront être nommés en fonction du nom que vous avez choisit pour votre module.
Dans ce tutoriel notre module est appelé « mod_relcontent » nous allons donc créer deux fichiers, le premier sera appelé mod_relcontent.php et le second mod_relcontent.xml . Pour le moment ces deux fichiers restent vide.
4 Edition du fichier xml, mod_relcontent.xml
Le fichier xml sert à deux choses, premièrement définir toutes les meta-données du module (nom de l’auteur, date de création, type de licence d’exploitation etc) puis également annoncer les fichiers nécessaires au bon fonctionnement du module.
Le contenu du fichier xml est sur cette page.
5 Edition du fichier php, mod_relcontent.php
Voici le contenu du fichier mod_relcontent.php
Du code avec des commentaires étant bein souvent plus efficace qu’un long discours je vous laisse regarder le fichier.
Une fois que le fichier est prêt il faut aller dans l’interface d’administration de joomla puis dans le menu « installers » puis « modules ». Ensuite il ne vous reste plus qu’à cliquer sur parcourir et sélectionner votre fichier zip. (joomla l’uploadera, le décompressera et l’installera tout seul sur le serveur).
Voilà, c’est tout pour aujourd’hui, la suite dans les prochains épisodes.
