Zen-Dreams

Zen-Dreams.com

Créer son plug-in pour wordpress [Partie 3]

Pour rappel, cet article fait partie de la série intitulée Créer son plugin pour Wordpress

  1. Introduction aux plugins
  2. Squelette d’un plugin

1. Activation du plugin

Lorsqu’un plugin Wordpress devient actif il peut être interessant de faire quelques traitement (comme créer la base de donnée, pré-remplir des options, etc…). Pour cela, Wordpress fournie une fonction très pratique qui permet d’apeller votre méthode d’initialisation. Celle-ci se nomme register_activation_hook($file,$function);

Les paramètres qu’elle prend sont les suivants:

  • $file : le fichier contenant la fonction à apeller
  • $function: le nom de la fonction à apeller

Il vous suffira donc de déclarer dans le code de votre plugin la ligne précédement citée et bien sur d’y placer votre fonction. Tout code présent dans la fonction sera donc éxécuté lors de l’activation du plugin, et uniquement lors de son activation. Il existe bien évidément la fonction contraire, register_deactivation_hook($file, $function);.

Lors de l’appel à cette fonction, la constante __FILE__ peut être utilisée car elle représente le fichier actuel. Cela donnera donc un appel comme suit :

register_activation_hook(__FILE__,'ma_fonction_dinit');

Dès que wordpress recevra l’ordre d’activer le plugin, il éxécutera cette fonction. C’est nottament ici que vous allez placer les commandes pour créer votre/vos tables.

2. Variables globales importantes

Afin d’exploiter wordpress au mieux, il vous faudra utiliser des variables globales remplies par Wordpress au cours de son execution. Cela vous permet de récuperer des informations précieuses afin de s’assurer de la meilleure interraction possible avec le moteur.

La première et probablement la plus importante étant la variable $wpdb; en effet, celle-ci contient toutes les informations nécéssaire à l’utilisation de la base de donnée. $wpdb est une classe permettant le traitement de la base de donnée mais aussi de retrouver des informations primordiales telles que le nom des tables, leur préfix, etc…

3. Branchements, actions et filtres

Voila un concept bien implanté dans wordpress et il vous permettra de modifier le comportement de votre blog intégralement. Je ne vais pas présenter la liste exaustive des filtres et actions possibles, mais déjà vous expliquer en quoi cela consiste, ainsi que quelque actions/filtres bien pratiques.

Qu’est-ce qu’un filtre ?

Un filtre est un branchement dans le coeur de wordpress qui permet de modifier des paramètres avant de les repasser au moteur de wordpress. Par exemple, avant l’insertion d’un commentaire ou encore avant affichage. C’est nottament ce qui est fait par ZdMultilang pour traduire les catégories avant leur affichage.

Un filtre prend donc un certain nombre de paramètres en entrée qui seront passés à la fonction filtrante puis retournés modifiés ou non.

Qu’est-ce qu’une action ?

Une action est aussi un branchement, mais à la différence du filtre, il ne modifie pas une valeur, mais est executé en fonction d’un évennement. Par exemple, lorsque vous changez de thème, affichez la page d’administration, etc…

L’interet est par exemple de vous permettre d’ajouter un onglet dans la page d’administration:

En résumé, pour écrire un plugin il vous faudra définir dans votre squelette au moins un hook d’activation (register_activation_hook), et une series de filtres/actions pour gérer le comportement voulu.

Par Anthony

Laisser un commentaire

Votre email ne sera jamais distribué. Les champs marqués d'une * sont obligatoires

*
*