Un filtre fait passer une valeur par une fonction et récupère ce que cette fonction renvoie. Mesuré sur une installation WordPress 7.1 au 24 septembre 2026 : un filtre qui double la valeur à la priorité 10 et un autre qui ajoute 5 à la priorité 20, appliqués à 100, répondent 205. La priorité la plus basse s'exécute en premier, et la seconde fonction reçoit la sortie de la première.
Voici maintenant la faute qui produit la majorité des tickets de support WordPress. Une fonction accrochée à un filtre qui modifie la valeur et oublie de la renvoyer fait répondre NULL à apply_filters. Pas la valeur d'origine, pas une erreur visible : null, transmis tel quel à ce que le noyau comptait en faire. Chaque fonction accrochée à un filtre se termine par un return, sans exception.
Actions et filtres sont le même mécanisme, utilisé différemment
- Une action est un instant : quelque chose s'est produit, faites ce que vous voulez, rien n'est attendu en retour
- Un filtre est une valeur en transit : la modifier ou non, et la renvoyer dans les deux cas
- Les deux s'exécutent par ordre de priorité, du plus petit nombre au plus grand, et chacun exécute toutes les fonctions enregistrées
- Le quatrième argument de add_filter indique combien d'arguments votre fonction accepte, et le laisser à sa valeur par défaut de 1 tout en déclarant deux paramètres provoque une erreur fatale au moment où le crochet se déclenche
Ce dernier point mérite d'être nommé parce que l'erreur apparaît ailleurs qu'attendu : le crochet se déclenche au fond du noyau, donc le message cite un fichier jamais ouvert, alors que la cause est un seul nombre manquant dans votre propre extension.
Une extension appartient rarement à une seule personne
Un site français porte souvent plusieurs mains sur les mêmes crochets : l'agence qui l'a livré, un freelance venu pour une fonctionnalité, et une extension tierce achetée sur une place de marché. Aucune des trois ne voit la priorité choisie par les deux autres, et le blocage typique n'est pas une erreur de code mais un ordre d'exécution que personne n'a décidé volontairement. Un cas courant à surveiller : une extension qui insère un pixel de mesure ou un identifiant publicitaire dans the_content à une priorité basse, avant même qu'un bandeau de consentement n'ait eu la chance de bloquer quoi que ce soit, ce qui rend le pixel actif pour un visiteur qui vient de refuser.
À quel point un crochet est déjà occupé
Cette installation compte 711 crochets enregistrés au moment où une page se construit, et the_content à elle seule porte quatorze fonctions accrochées. Les lire dans l'ordre explique un comportement qui semble sinon relever de la magie : do_blocks à 9 rend le balisage des blocs, wptexturize et wpautop à 10 gèrent la typographie et les paragraphes, do_shortcode à 11, et wp_filter_content_tags à 12 ajoute les attributs d'image.
Ce qui fait de la priorité une vraie décision plutôt qu'un réglage par défaut. Une fonction à 9 voit du balisage de bloc brut ; la même fonction à 20 voit du HTML entièrement rendu, paragraphes et shortcodes déjà développés. Choisir le mauvais côté de wpautop explique pourquoi un élément inséré se retrouve entouré d'une balise de paragraphe parasite.
Les outils à faire tourner en 2026
Query Monitor est l'outil, libre et open source, et c'est la seule extension qui mérite d'être installée sur tout site de développement. Il liste les crochets déclenchés pour la requête en cours avec leurs fonctions, les requêtes SQL avec leur origine, et les avertissements PHP, ce qui transforme tout ceci en observation plutôt qu'en lecture. Il a remplacé l'ajout d'appels error_log directement dans les fichiers du noyau.
WP_DEBUG avec WP_DEBUG_LOG est le second, gratuit avec WordPress, et il est désactivé par défaut sur toute installation. Une fois activé, le return oublié ci-dessus apparaît comme un avertissement dans wp-content/debug.log plutôt que comme une zone vide sur la page. Il a remplacé le développement avec les erreurs masquées, ce qui est le réglage par défaut et la raison pour laquelle ces bogues survivent aussi longtemps.
Là où ça bloque
Le blocage est de modifier le noyau ou les fichiers du thème parent parce qu'un crochet reste introuvable. La modification fonctionne, survit jusqu'à la prochaine mise à jour de WordPress, puis disparaît sans laisser de trace du crochet jamais trouvé. Chaque modification de ce genre est un crochet que personne n'a cherché, et il y en a plus qu'on ne l'imagine : 711 sur cette installation, avant même la première extension personnelle.
La recherche qui en trouve un prend une minute : grep -rn "apply_filters\|do_action" wp-includes/ suivi d'un filtre sur le mot cherché. Les noms de crochets sont explicites, ils sont dans le code source, et cette commande est plus rapide que la documentation. L'endroit où vivent ces fonctions est celui des thèmes, et le langage dans lequel elles s'écrivent est celui des bases de PHP.