Ajout d'actions et de filtres à un plugin WordPress

wordpress-add-action-add_filter-Create_plugin-Wordpress

1 - Comprendre le fonctionnement d'un plugin WordPress

Essayons maintenant d'imaginer comment fonctionnent les plugins avant de poursuivre notre projet de création de plugin WordPress.

Les plugins fournissent des fonctionnalités avec les hooks, ainsi il est crucial de comprendre leur fonctionnement.

Des crochets ( hooks ) sont fournis par WordPress pour permettre à votre plug-in de "s'acquérir" du reste de WordPress; c'est-à-dire, appeler des fonctions dans votre plug-in à des moments précis, et ainsi mettre votre plug-in en mouvement. Il y a deux sortes de crochets ( hooks) :

  1. Actions (Codex Action Reference)
  2. Filters (Codex Filter Reference)

Vous pouvez parfois atteindre le même objectif avec une action ou un filtre. Par exemple, si vous souhaitez que votre plug-in modifie le texte d'un article, vous pouvez ajouter une fonction d'action à publish_post (pour que le message soit modifié lors de son enregistrement dans la base de données) ou une fonction de filtre sur the_content. modifié tel qu’il est affiché dans l’écran du navigateur).

Pour une liste complète de tous les crochets d'action et de filtrage dans WP, consultez la base de données de crochets WordPress d'Adam Brown.

2 – Ajouter une action et un filtre à votre plugin WordPress

Reprenons l'esxemple de plugin créer dans la leçon précédente :
Ajoutons les lignes suivantes sous l’en-tête d’information et enregistrons à nouveau notre fichier test.php.

add_action('wp_footer', 'my_function');
function my_function() {
echo'Hello World !'; 
}

La première ligne utilise le hook add_action de WordPress et l’action utilisée est wp_footer, qui est déclenchée juste avant la section /body du modèle. Il appelle la fonction « my_function », que vous avez créée juste en dessous de l’action.

Maintenant pour pouvoir exécuter l’effet du plugin, activez le depuis votre zone d’administration de WordPress.
Une fois que vous enregistrez le fichier, accédez à l’URL de votre site et vous devriez voir quelque chose tout en bas de votre page:

 

ativation-plugin-Wordpress-hello-world-hooks-add_action-add_filter

 

3 - Ajoutez un filtre à votre plugin WordPress

Dans WordPress, un filtre est une fonction associée à une action existante en spécifiant un crochet existant.

Les développeurs peuvent créer des filtres personnalisés à l'aide de l'API de filtre pour remplacer le code d'une action existante. Ce processus s'appelle "accrochage".

Les filtres personnalisés diffèrent des actions personnalisées car les actions personnalisées vous permettent d'ajouter ou de supprimer du code à des actions existantes. Alors que les filtres personnalisés vous permettent de remplacer des données spécifiques (telles qu'une variable) trouvées dans une action existante.

Syntaxe d'ajout d'un filtre :

add_filter( 'nom_du_filtre' , 'fonction_a_appliquer');
fonction_a_appliquer( ){
instructions ! 
}

Exemple

function my_filter_content($content) {
	$new_content = '<font color=red><b>Crée par TresFacile.Net ! </b></font>';
	$content = $content . $new_content;
	return $content;
}
add_filter('the_content', 'my_filter_content');

Cet exemple permet d'ajouter  en rouge en bas de chaque article, l'expression "Crée par TresFacile.Net !", comme le montre la figure suivante :

 

 

Younes Derfoufi
CRMEF OUJDA

Leave a Reply