Que sont les crochets WordPress ?

Les hooks WordPress sont une partie essentielle du cadre de développement WordPress, permettant aux développeurs d’interagir avec les fonctionnalités de base de WordPress sans modifier les fichiers de base. En utilisant les hooks, vous pouvez ajouter ou modifier des fonctionnalités dans les thèmes et les plugins. Il existe deux types principaux de crochets : Les crochets d’action et les crochets de filtrage. Voici un aperçu de ce qu’ils sont et comment les utiliser

Que sont les crochets WordPress ?

Les hooks sont des points prédéfinis dans WordPress qui vous permettent d’accéder aux fonctions de WordPress et d’exécuter un code personnalisé. Cela vous permet de modifier ou d’étendre les fonctionnalités du noyau, des thèmes et des plugins de WordPress sans avoir à éditer directement les fichiers originaux. Il existe deux types principaux de hooks

Les crochets d’action : Ils vous permettent d’ajouter ou d’exécuter du code personnalisé à des moments précis de l’exécution de WordPress (par exemple, lorsqu’un article est publié ou lorsqu’une page est chargée).
Crochets de filtrage : Ils permettent de modifier ou de manipuler des données avant qu’elles ne soient envoyées au navigateur ou enregistrées dans la base de données (par exemple, en modifiant le contenu ou la sortie).

1. Crochets d’action

Les crochets d’action sont déclenchés à différents moments du fonctionnement de WordPress. Ils vous permettent d’ajouter des fonctionnalités à des étapes spécifiques du processus de chargement de WordPress ou lorsque certains événements se produisent (comme la publication d’un article ou l’affichage du pied de page)

Comment utiliser les crochets d’action :

Pour utiliser un crochet d’action, vous utilisez la fonction add_action() dans le fichier functions.php de votre thème ou dans un plugin personnalisé. Cette fonction lie votre fonction personnalisée à un crochet spécifique

Syntaxe :

add_action(‘hook_name’, ‘your_custom_function’ ) ; function your_custom_function() { // Votre code personnalisé ici. }

Exemple :

Supposons que vous souhaitiez ajouter un contenu personnalisé à la fin de chaque article

add_action( ‘the_content’, ‘add_custom_content’ ) ; function add_custom_content( $content ) { if ( is_single() ) { $content .= ‘<p>Merci d’avoir lu!</p>’ ; } return $content ; }

Dans cet exemple, the_content est le crochet qui déclenche la fonction permettant d’ajouter un contenu personnalisé à la fin de chaque article

2. Crochets de filtrage

Les crochets de filtre vous permettent de modifier la sortie des données avant qu’elles ne soient affichées à l’écran ou enregistrées dans la base de données. Les filtres reçoivent des données, les modifient et les renvoient

Comment utiliser les filtres crochets :

Pour utiliser un filtre crochet, vous utilisez la fonction add_filter(), qui applique une fonction personnalisée pour modifier un contenu spécifique

La syntaxe de cette fonction est la suivante

add_filter(‘hook_name’, ‘your_custom_filter_function’ ) ; function your_custom_filter_function( $content ) { // Modifie le contenu. return $modified_content ; }

Exemple :

Supposons que vous souhaitiez modifier le titre de chaque article pour qu’il soit en majuscules

add_filter( ‘the_title’, ‘uppercase_post_title’ ) ; function uppercase_post_title( $title ) { return strtoupper( $title ) ; }

Dans cet exemple, the_title est le hook qui filtre les titres des articles, et la fonction uppercase_post_title() convertit tous les titres en majuscules

Crochets WordPress populaires

Voici quelques crochets couramment utilisés dans WordPress

Action Hooks (crochets d’action) :

wp_enqueue_scripts : Utilisez ceci pour ajouter ou supprimer des scripts et des styles.
init : S’exécute après que WordPress ait fini de se charger mais avant que les en-têtes ne soient envoyés.
wp_footer : Exécute le code juste avant la balise de fermeture </body> de votre thème.
publish_post : Déclenché lorsqu’un article est publié.

Filter Hooks (crochets de filtrage) :

the_content : Permet de filtrer le contenu de l’article avant qu’il ne soit affiché.
the_title : Permet de modifier les titres des articles.
excerpt_length : Permet de modifier la longueur des extraits d’articles.
wp_nav_menu_items : Permet de filtrer la sortie des éléments du menu de navigation.

Bonnes pratiques pour l’utilisation des crochets

Évitez de modifier les fichiers principaux : Utilisez toujours les crochets dans les thèmes ou les plugins personnalisés afin de maintenir la compatibilité avec les futures mises à jour.
Noms de fonctions uniques : Utilisez toujours des noms uniques pour vos fonctions personnalisées afin d’éviter les conflits avec d’autres plugins ou thèmes.
Utilisez la logique conditionnelle : Lorsque vous utilisez des crochets, utilisez des vérifications conditionnelles comme is_single() ou is_admin() pour vous assurer que votre code ne s’exécute que lorsque c’est nécessaire.

Conclusion

les hooks d’ordPress sont un moyen d’ajouter ou de modifier des fonctionnalités sans changer les fichiers principaux. Il en existe deux types principaux :

Lescrochets d’action – vous permettent d’exécuter un code personnalisé à des points spécifiques de WordPress.
Lescrochets de filtrage – vous permettent de modifier les données avant qu’elles ne soient affichées ou sauvegardées.

Exemple – Crochet d’action: Ajout d’un message au pied de page :

Ce code ajoute le message au bas de chaque page sans toucher aux fichiers principaux de WordPress.