Zen-Dreams

Voici donc la suite promise de ma série d’articles sur la création de plugins pour Wordpress.

Dans cet article je vais vous présenter la structure d’un plugin. Plus exactement le squelette à utiliser lors de la création d’un plugin ainsi que quelques concepts spécifiques à Wordpress.

Squelette d’un plugin

Un plugin est composé d’au moins un fichier php (il n’est pas nécéssaire d’en avoir plus, mais c’est fort utile pour découper correctement le code) qui lui même à une structure bien particulière.

Le nom du fichier importe peu à vrai dire, vous pourriez très bien avoir un plugin nommé Mon_plugin_qui_déchire dans un fichier toto.php. La définition du nom du plugin se fait, en effet, dans le corps même du plugin.

Donc voici, la structure a placer dans votre plugin, qui permet de définir quelques informations. Ces informations seront très utiles si vous comptez publier votre plugin sur le wordpress.org/extend.

/*
Plugin Name[1]: Le_nom_de_votre_plugin
Plugin URI[2]: http://votresite.com/url_du_plugin
Description[3]: La description du plugin
Version[4]: 1.0.0
Author[5]: Anthony PETITBOIS
Author URI[6]: http://www.zen-dreams.com/fr/
*/

1. Le nom du plugin tel qu’il apparaitra dans votre panneau d’administration, ainsi que sur le site wordpress.org. Il est donc important de bien choisir le nom du plugin pour ne pas le noyer dans la masse de plugins.
2. Correspond a l’url qui sera utilisée pour créer un lien vers cette page dans le panneau d’administration.
3. C’est ici que vous pouvez mettre une courte description du plugin, celle-ci apparaitra aussi dans le panneau d’administration des plugins, afin que les utilisateurs sachent à quoi sert le plugin. Ici, ce n’est pas la peine de mettre toutes les fonctionalitées, mais un simple résumé suffira.
4. Le numéro de version. Celui-ci est très important si vous voulez utiliser les fonctionalitées du SVN de wordpress. En effet, cela permet de vérifier la dernière version à jour et la mise à jour automatique.
5. C’est ici que vous allez mettre votre nom, cela permet d’identifier l’auteur directement depuis le panneau d’administration des plugins.
6. Et c’est ici que vous allez pouvoir mettre le lien vers une page qui parle de vous, ou votre blog. Lorsque l’on clique sur le nom précisé en 5, cela redirigera vers cette page.

Une fois que vous avez cet entête, votre plugin sera reconnu par Wordpress en tant que tel. Ce n’est pas pour autant que votre plugin sera réellement actif, car il faut ensuite le brancher dans wordpress. Si vous ne le branchez pas, wordpress éxecutera le fichier php des le chargement du moteur.

Afin de rendre sécurisé votre plugin, il faut isoler toutes les fonctionalitées, soit dans une classe, soit dans des fonctions.

Et enfin, il vous faudra brancher vos fonctions dans le coeur de wordpress afin que celle-ci s’executent au bon moment. Par exemple avant l’affichage d’un post, lors de l’insertion d’un commentaire, au chargement du moteur, etc…

Mais ceci est le sujet du prochain article.