do_filter WordPress : comprendre et utiliser les filtres WordPress

Introduction

Contrairement à ce que laisserait penser l’expression do filter WordPress, il n’existe pas de fonction native nommée do_filter dans le cœur de WordPress. En réalité, le système de filtres repose principalement sur deux fonctions clés : apply_filters et add_filter. Ces fonctions permettent de modifier des données à la volée, d’adapter le comportement de WordPress, de vos thèmes et de vos extensions sans toucher directement au code source.

Dans cet article complet, nous allons :

• expliquer ce qu’est un filtre WordPress et en quoi il diffère d’une action,
• clarifier la confusion courante autour du terme « do filter wordpress »,
• montrer comment utiliser concrètement apply_filters et add_filter dans vos projets,
• présenter des exemples pratiques orientés SEO et performance,
• et donner les bonnes pratiques pour un usage propre, maintenable et sécurisé des filtres.

L’objectif est de vous offrir une compréhension claire et opérationnelle du système de filtres WordPress, afin de pouvoir améliorer le comportement de votre site, votre référencement naturel et l’intégration de vos plugins, sans casser le cœur de WordPress.

Concepts clés sur les filtres WordPress

Qu’est-ce qu’un filtre dans WordPress ?

Dans WordPress, un filtre est un point d’accroche (hook) qui permet à un développeur de modifier une donnée à un moment précis de l’exécution du code. Cette donnée peutêtre un titre, un contenu d’article, une URL, un nombre de posts, une requête SQL, un champ d’un formulaire, etc.

Le fonctionnement repose sur deuxéléments :

• une fonction qui déclenche le filtre et passe la donnée à modifier : apply_filters,
• une ou plusieurs fonctions qui s’accrochent à ce filtre pour modifier la donnée : via add_filter.

Schématiquement :

• apply_filters( 'nom_du_filtre', $valeur ) déclare « Je rends $valeur modifiable via le filtre nom_du_filtre ».
• add_filter( 'nom_du_filtre', 'ma_fonction_de_filtre' ) dit « Quand le filtre nom_du_filtre est appelé, exécute ma_fonction_de_filtre et renvoie la valeuréventuellement modifiée ».

« do filter WordPress » vs fonctions réelles : apply_filters et do_action

Le terme « do filter WordPress » est souvent une confusion entre plusieurs fonctions du système de hooks :

• apply_filters est la fonction qui exécute un filtre et retourne une valeur (potentiellement modifiée).
• add_filter permet d’enregistrer une fonction de rappel (callback) à un filtre existant.
• do_action est l’équivalent côté actions (hooks qui ne retournent pas de données, mais déclenchent du code).

Il n’existe donc pas de fonction do_filter dans le cœur de WordPress : lorsque vous lisez ou entendez « do filter wordpress », il s’agit en général de l’idée d’appliquer un filtre via apply_filters ou de définir un filtre personnalisé dans votre code.

Différence entre actions et filtres

WordPress utilise un système d’événements fondé sur deux types de hooks :

• Actions (via do_action / add_action) : permettent d’exécuter du code à un moment donné, sans obligation de retourner une valeur. Exemple : envoyer un e‑mail après la publication d’un article.
• Filtres (via apply_filters / add_filter) : permettent de modifier une donnée et de retourner une nouvelle valeur. Exemple : modifier le titre d’un article avant son affichage.

En résumé :

• Une action « fait quelque chose ».
• Un filtre « modifie quelque chose ».

Comment WordPress gère-t-il les filtres ?

La fonction apply_filters

La fonction apply_filters est utilisée pour rendre une valeur « filtrable ». Elle suit généralement cette forme :

apply_filters( 'nom_du_filtre', $valeur_a_filtrer, $argument_optionnel_1, $argument_optionnel_2, ... );

Leséléments importants :

• 'nom_du_filtre' : identifiant unique du filtre, sous forme de chaîne de caractères.
• $valeur_a_filtrer : variable qui vaêtre transmise aux fonctions de filtre et potentiellement modifiée.
• Les arguments optionnels peuvent fournir un contexte supplémentaire (ID de post, type de contenu, objet de requête, etc.).

Lorsqu’un filtre est appliqué :

• WordPress recherche toutes les fonctions enregistrées sur ce hook via add_filter.
• Les callbacks sont exécutés dans l’ordre de priorité défini.
• Chaque callback reçoit la valeur courante, la modifieéventuellement, puis la retourne.
• La valeur finale retournée par apply_filters est utilisée par le reste du code.

La fonction add_filter

add_filter permet d’enregistrer une fonction qui s’exécutera lorsqu’un filtre donné sera appliqué. Sa signature la plus courante est :

add_filter( 'nom_du_filtre', 'nom_de_la_fonction', $priorite, $nb_arguments_acceptes );

Les paramètres principaux :

• 'nom_du_filtre' : doit correspondre exactement au nom utilisé dans apply_filters.
• 'nom_de_la_fonction' : nom de la fonction PHP de rappel (callback).
• $priorite : entier indiquant l’ordre d’exécution (10 par défaut, les plus petits nombres sont exécutés en premier).
• $nb_arguments_acceptes : nombre d’arguments que votre callback attend (1 par défaut, souvent plus pour les filtres complexes).

WordPress et les backlinks : clarification

Dans le texte initial, le terme « do filter WordPress » était confondu avec le filtrage de backlinks. Il est important de préciser les points suivants :

• WordPress ne propose pas nativement de système interne de filtrage ou d’analyse des backlinks entrants (liens provenant d’autres sites vers le vôtre).
• La gestion des backlinks (identification, audit, désaveu) se fait principalement via des outils externes comme Google Search Console, des plateformes spécialisées ou des solutions SEO tierces.
• Cependant, WordPress permet d’utiliser des plugins SEO qui s’interfacent avec ces outils ou présentent des rapports basés sur leurs données (par exemple via des tableaux de bord, des alertes, des recommandations de contenus, etc.).

Les filtres WordPress, eux, servent à modifier des données internes (contenu, URLs, métadonnées, requêtes) mais ne réalisent pas, en tant que tels, un audit complet de backlinks.

Exemples pratiques de filtres WordPress

Exemple 1 : filtrer le titre d’un article pour le SEO

Supposons que vous souhaitiez ajouter automatiquement le nom de votre marque à la fin de tous les titres d’articles sur le front‑end. Vous pouvez pour cela utiliser le filtre the_title.

Exemple de logique :

• WordPress appelle apply_filters( 'the_title', $title, $post_id ) avant d’afficher un titre.
• Vous accrochez une fonction sur 'the_title' avec add_filter.
• Votre fonction ajoute « | Nom de la marque » au titre, sauf dans l’administration.

Exemple 2 : filtrer le contenu d’un article

Le filtre the_content est l’un des plus utilisés pour modifier le corps d’un article : insertion de bannières, de blocs d’appel à l’action, de tableaux de sommaire, etc. Les constructeurs de pages, les plugins d’affiliation ou de publicité s’appuient massivement sur ce filtre.

Typiquement :

• WordPress prépare le contenu brut dans une variable $content.
• Il appelle $content = apply_filters( 'the_content', $content );
• Tous les plugins et thèmes qui se sont accrochés via add_filter( 'the_content', 'ma_fonction' ) peuvent alors enrichir ou altérer ce contenu.

Exemple 3 : filtrer le nombre d’articles par page (requêtes)

Les filtres ne se limitent pas au contenu textuel. Par exemple, le filtre pre_get_posts permet de modifier la requête principale de WordPress avant son exécution : changer le nombre d’articles par page, exclure une catégorie, personnaliser l’archive de blog, etc.

Scénario courant :

• Sur la page d’accueil du blog, vous souhaitez afficher 5 articles au lieu de la valeur par défaut.
• Vous utilisez un callback accroché à pre_get_posts pour modifier la propriété posts_per_page de la requête principale.

Ce type de filtre est très utile pour le SEO, par exemple pour structurer correctement vos archives, éviter le contenu dupliqué ou contrôler la profondeur d’exploration des robots.

Exemple 4 : filtrer les métadonnées et les URLs

De nombreux plugins SEO s’appuient sur des filtres pour personnaliser :

• les balises