Toute personnalisation propre de WordPress passe par les hooks. Plutôt que de modifier les fichiers du cœur, d’un thème ou d’une extension, ce qui serait écrasé à la prochaine mise à jour, vous branchez votre propre fonction à un point précis de l’exécution. WordPress l’appellera au bon moment. C’est ainsi que fonctionnent toutes les extensions, WooCommerce compris.
Actions et filtres : la seule différence à retenir
Une action permet de faire quelque chose à un moment donné : envoyer un e-mail après une commande, ajouter un script dans l’en-tête, enregistrer un type de contenu. Elle ne renvoie rien. Un filtre permet de modifier une valeur avant qu’elle soit utilisée : un titre, un prix, le contenu d’un article. Il reçoit la valeur et doit toujours la renvoyer, modifiée ou non.
Utiliser une action
add_action prend le nom du hook et la fonction à exécuter. Ici, on ajoute une balise de vérification dans l’en-tête de toutes les pages :
add_action( 'wp_head', function () {
echo '<meta name="verification" content="abc123">';
} );
Utiliser un filtre
add_filter fonctionne de la même façon, mais la fonction reçoit une valeur et la renvoie. Ici, on raccourcit les extraits d’articles à 30 mots :
add_filter( 'excerpt_length', function ( $length ) {
return 30;
} );
L’erreur la plus courante avec un filtre est d’oublier le return. La valeur devient alors vide, et le titre, le prix ou le contenu disparaît du site.
Priorité et nombre d’arguments
Le troisième paramètre fixe la priorité : 10 par défaut, et plus le nombre est petit, plus la fonction s’exécute tôt. Le quatrième indique combien d’arguments votre fonction reçoit. Beaucoup de hooks en transmettent plusieurs, mais WordPress n’en passe qu’un si vous ne le précisez pas.
add_filter( 'the_title', function ( $title, $post_id ) {
if ( get_post_type( $post_id ) === 'product' ) {
$title = $title . ' (WooCommerce)';
}
return $title;
}, 20, 2 );
Créer vos propres hooks
Dans un thème ou une extension sur mesure, ajoutez vos propres points d’accroche avec do_action et apply_filters. Un autre développeur pourra modifier le comportement sans toucher à votre code, et vos mises à jour ne casseront pas ses ajouts.
do_action( 'monplugin_apres_envoi', $commande );
$total = apply_filters( 'monplugin_total', $total, $commande );
Retirer un hook ajouté par une extension
remove_action et remove_filter ne fonctionnent que si vous indiquez exactement la même fonction et la même priorité que l’ajout d’origine, et si vous les appelez après cet ajout. C’est pourquoi on les place souvent dans un hook plus tardif, comme init ou wp_loaded. Une fonction anonyme, elle, ne peut pas être retirée : c’est une bonne raison de nommer les fonctions dans vos propres extensions.
الأسئلة الشائعة
Où placer ce code ?
Dans le functions.php d’un thème enfant, ou mieux dans une petite extension dédiée ou un mu-plugin : votre code survit alors à un changement de thème.
Comment voir quels hooks s’exécutent sur une page ?
L’extension Query Monitor liste les hooks déclenchés sur la page et les fonctions branchées sur chacun, avec leur priorité. C’est l’outil le plus rapide pour comprendre pourquoi un comportement change.
المؤلف
وليد صدفيWalid Sadfi est le fondateur d'Evolurise, une équipe d'ingénieurs déployés chez ses clients : développement sur mesure (WordPress, Drupal, React, Laravel), agents IA, DevOps et formation des équipes. Fort de 8 ans d'expérience, il accompagne PME et grands comptes, de la compréhension du problème au déploiement de la solution. Il partage sur ce blog des retours de terrain concrets.