Créer, développer un plugin wordpress

Publié le 26 août 2009 par Rkueny

Comme j’en ai parlais dans mon précédent article, je me suis lancé dans la création d’un plugin wordpress. La première partie de mon périple, que dis-je de mon odyssée fut de trouver des tutoriels sur le net. J’ai pas mal cherché et pas vraiment trouvé ce qui me plaisait. En fait, il n’y a pas de tutoriel qui explique tout du début à la fin (ou alors je n’ai pas trouvé). Du coup, j’ai pas mal tâtonné, cherché dans la doc (qui est excellente mais en anglais), et regardé sur les plugins existants.

Du coup, n’ayant pas trouvé mon bonheur sur la toile je me suis dis que j’allais créer cet article que j’aurai aimé avoir. De plus, cela permettra à moi aussi de me clarifier les idées. C’est gagnant-gagnant non ? ^^Alors, commençons donc ce tutoriel qui se découpera en plusieurs parties (c’est plus facile à digérer )

Les plugins de wordpress

Avant de se lancer tête baissée dans le code, je vais vous donner quelques liens à visiter. Le premier est le listing des plugins existants. En effet, développer un plugin alors qu’il en existe déjà un… utile ? A vous de juger. Le second mène à la documentation wordpress. C’est une véritable mine et elle m’a bien souvent guidée lors de mon développement. A mettre dans vos favoris

- Les plugins wordpress
- La documentation wordpress et le guide des fonctions

Je vous mettrai souvent des liens vers ses parties pour que vous approfondissiez le sujet. En effet, je ne connais pas tout des plugins wordpress mais assez pour commencer à faire un plugin qui tient la route et assez pour vous donner les éléments pour vous débrouiller par la suite. De plus, si vous avez des questions n’hésitez pas à laisser un commentaire.

Encore un mot sur les plugins wordpress. J’imagine que vous savez où ils sont stockés : wp-content/plugins/ et où on les installe dans la partie admin : Extensions (menu déroulant sur la gauche).

Enfin, il existe quelques conventions de nommages pour votre fichier. Votre dossier et votre fichier principal doivent avoir le même nom. De plus ils doivent être unique, ainsi que votre nom de plugin d’ailleurs. En effet, cela peut entrainer des collisions sinon. Pour éviter cela –> moteur de recherche cité plus haut.

Pour ne pas vous lâcher sans que vous n’ayez ouvert votre IDE préféré, voici le début du tutoriel proprement dit.

La carte d’identité de votre plugin

Pour que le système de wordpress reconnaisse votre fichier php principal (qui porte le nom du dossier) comme un plugin wordpress il vous faut ajouter sa carte d’identité, appellée cartouche, en début en fichier. Voici la syntaxe :

1
2
3
4
5
6
7
8
9
10
<?php
/*
     Plugin Name: Le nom de votre plugin
     Plugin URI:  L'url de votre projet
     Description: La description de votre plugin (rapide)
     Author:      Votre nom ou pseudo
     Version:     La version de votre plugin
     Author URI:  Votre site/blog/forum
*/
?>

Cela identifiera donc votre plugin. Cela permettra à wordpress d’afficher ceci :

Cartouche du plugin wordpress

La classe non ? ^^

Précision : ce cartouche n’apparait que sur le premier fichier.

Je vous laisse pour aujourd’hui. La suite viendra avant la fin de la semaine avec l’activation du plugin, la création de menu dans la partie admin et peut-être l’utilisation des bases de données.

Si vous avez des envies des besoins, n’hésitez pas à laisser des commentaires. See you later