Bienvenue!
Cette page est réservée aux webmaster et/ou codeurs PHP qui désirent créer une nouvelle partie de LyokoCMS. Ce dernier à été conçue de façon à ce que même des débutants puissent créer des modules, ou des styles.
Cette page, comme une sorte d'initiation va vous apprendre les bases pour créer un module. Nous parlerons de la création des styles sur la page 2.
Tout d'abord, sachez que vous devez maitriser certaines choses élémentaires: les structures conditionnelles et les bases de PHP (variables...) Une connaissance de MySql est préférable pour créer des modules plus puissants.
Pour créer un module dans LyokoCMS, la première étape est d'avoir sa propre version pour pouvoir tester ses scripts. Une fois que vous aurez installés votre LyokoCMS, rendez-vous dans le dossier modules. Selon votre version, il se peut qu'il y ai déjà un module.
Commencez par créer un nouveau dossier, qui portera le nom de votre module. Une fois celà fait, vous allez pouvoir commencer à coder. Il y a plusieurs types de fichiers à connaître.
mon_module.php : ce sera la page principale qui serà incluse lorsque les utilisateurs écriront {mod:mon_module}. Elle doit OBLIGATOIREMENT avoir le même nom que votre dossier. Bien sur, elle peut elle même inclure d'autres fichiers.
mon_module.act.php : c'est le fichier qui sera exécuté lors de l'installation d'un module. Grâce à ce fichier, vous pouvez ajouter des pages d'administration (voir plus bas). Dans ce fichier, vous pouvez par exemple utiliser des fonctions comme cp() où rename(). Ce fichier peut servir aussi à créer des tables MySQL. Attention: veillez à toujours vérifier si une connexion à l'administration est active! Sinon, un utilisateur malveillant pourrait tenter d'installer votre module, donc de créer les tables mais pas de copier les fichiers.
Pour vérifier si le fichier est bien inclu dans une page de l'administration, il suffit de mettre ce code:
mon_module.del.php : à l'inverse de mon_module.act.php, mon_module.del.php doit contenir toutes les données nécéssaires à la supression du module. Si par exemple, vous avez utilisé des données MySql, ce fichier contiendra les insctructions nécéssaires à la destructions des tables que vous auriez créées.
Autres fichiers: vous pouvez créer autant de fichiers que vous en aurez besoin, rappelez-vous bien de les sécuriser quand elle doivent l'êtres.
2) Administration
Souvent, il est très utile de créer ses pages d'administration. Par exemple, le module Shootbox contient une page d'administration qui permet de supprimer des messages. Lors de l'installation, ce module se trouvait dans le dossier Shootbox. Grâce à shootbox.act.php, il à été déplacé dans le dossier adéquat pour être utilisé par les administrateurs.
Rappel: n'oubliez JAMAIS de sécuriser vos fichiers d'administration en vérifiant la connexion courante.
Pour ajouter l'une de vos pages d'administration, indiquer dans mon_module.act.php que votre fichier d'administration doit être déplacé dans le dossier admin/gestion_mods (rename()).
Astuce: les mots gestion et admin sont automatiquement supprimés des fichiers lorsque l'utilisateur choisi le module à administrer. Les tirets inférieurs ( _ ) sont remplacés par des espaces.
Sur cette sorte d'administration, il y à toujours une connexion active à MySql donc vous n'êtes pas obligés de le faire vous-même.
3) Support
Si jamais il vous arrivait d'avoir un problème, qu'il ait un rapport où non avec le système (LyokoCMS), rendez-vous sur le forum. Vous y trouverez un support adapté.
Une fois que votre module sera terminé, nous vous invitons à le publier grâce au forum.
Merci de votre utilisation!
Cette page est réservée aux webmaster et/ou codeurs PHP qui désirent créer une nouvelle partie de LyokoCMS. Ce dernier à été conçue de façon à ce que même des débutants puissent créer des modules, ou des styles.
Cette page, comme une sorte d'initiation va vous apprendre les bases pour créer un module. Nous parlerons de la création des styles sur la page 2.
Tout d'abord, sachez que vous devez maitriser certaines choses élémentaires: les structures conditionnelles et les bases de PHP (variables...) Une connaissance de MySql est préférable pour créer des modules plus puissants.
1) Différents fichiers
Pour créer un module dans LyokoCMS, la première étape est d'avoir sa propre version pour pouvoir tester ses scripts. Une fois que vous aurez installés votre LyokoCMS, rendez-vous dans le dossier modules. Selon votre version, il se peut qu'il y ai déjà un module.
Commencez par créer un nouveau dossier, qui portera le nom de votre module. Une fois celà fait, vous allez pouvoir commencer à coder. Il y a plusieurs types de fichiers à connaître.
mon_module.php : ce sera la page principale qui serà incluse lorsque les utilisateurs écriront {mod:mon_module}. Elle doit OBLIGATOIREMENT avoir le même nom que votre dossier. Bien sur, elle peut elle même inclure d'autres fichiers.
mon_module.act.php : c'est le fichier qui sera exécuté lors de l'installation d'un module. Grâce à ce fichier, vous pouvez ajouter des pages d'administration (voir plus bas). Dans ce fichier, vous pouvez par exemple utiliser des fonctions comme cp() où rename(). Ce fichier peut servir aussi à créer des tables MySQL. Attention: veillez à toujours vérifier si une connexion à l'administration est active! Sinon, un utilisateur malveillant pourrait tenter d'installer votre module, donc de créer les tables mais pas de copier les fichiers.
Pour vérifier si le fichier est bien inclu dans une page de l'administration, il suffit de mettre ce code:
if($_SESSION['connexion']) {
/* ICI vous mettez le contenu du fichier (actions à effectuer)*/ } else {
die('Cette page ne doit pas être appelée directement!'); }
/* ICI vous mettez le contenu du fichier (actions à effectuer)*/ } else {
die('Cette page ne doit pas être appelée directement!'); }
mon_module.del.php : à l'inverse de mon_module.act.php, mon_module.del.php doit contenir toutes les données nécéssaires à la supression du module. Si par exemple, vous avez utilisé des données MySql, ce fichier contiendra les insctructions nécéssaires à la destructions des tables que vous auriez créées.
Autres fichiers: vous pouvez créer autant de fichiers que vous en aurez besoin, rappelez-vous bien de les sécuriser quand elle doivent l'êtres.
2) Administration
Souvent, il est très utile de créer ses pages d'administration. Par exemple, le module Shootbox contient une page d'administration qui permet de supprimer des messages. Lors de l'installation, ce module se trouvait dans le dossier Shootbox. Grâce à shootbox.act.php, il à été déplacé dans le dossier adéquat pour être utilisé par les administrateurs.Rappel: n'oubliez JAMAIS de sécuriser vos fichiers d'administration en vérifiant la connexion courante.
Pour ajouter l'une de vos pages d'administration, indiquer dans mon_module.act.php que votre fichier d'administration doit être déplacé dans le dossier admin/gestion_mods (rename()).
Astuce: les mots gestion et admin sont automatiquement supprimés des fichiers lorsque l'utilisateur choisi le module à administrer. Les tirets inférieurs ( _ ) sont remplacés par des espaces.
Sur cette sorte d'administration, il y à toujours une connexion active à MySql donc vous n'êtes pas obligés de le faire vous-même.
3) Support
Si jamais il vous arrivait d'avoir un problème, qu'il ait un rapport où non avec le système (LyokoCMS), rendez-vous sur le forum. Vous y trouverez un support adapté.Une fois que votre module sera terminé, nous vous invitons à le publier grâce au forum.
Merci de votre utilisation!
Pages: 2