Définition simple
Un filtre WordPress est un hook permettant de modifier une valeur transmise par WordPress ou une extension avant son utilisation.
Objectif et usage
Un filtre WordPress permet de transformer une valeur avant qu’elle soit utilisée ou affichée par le composant qui déclenche le hook.
Comment ça fonctionne ?
Chaque fonction reçoit la valeur courante et doit retourner la valeur à transmettre aux fonctions suivantes ou à l’appelant.
Exemple et vérification
Pour un résultat manquant après ajout d’un filtre, vérifier la valeur retournée et les autres fonctions exécutées sur le même hook.
Points d’attention
Afficher directement du texte dans un filtre peut perturber un rendu ou une réponse. La transformation doit aussi respecter le type de données attendu.
En résumé
Le filtre modifie une donnée dans un contexte précis ; il ne doit pas être confondu avec une action destinée à déclencher un traitement.