Que sont les filtres dans WordPress ? Comment utiliser le filtre WordPress add_filter ?

Que sont les filtres WordPress ?

Un filtre WordPress est un crochet qui modifie les données avant qu'elles ne soient renvoyées à la base de données et affichées à l'utilisateur. Ainsi, vous pouvez personnaliser les fonctionnalités d'un plugin, d'un thème ou d'un site web sans avoir à modifier les fichiers principaux de WordPress. Par exemple, ajouter des notes de bas de page à tous les articles du site ou modifier la longueur de leur extrait. Il existe quatre fonctions de crochet de filtre communes : add_filter, remove_filter, has_filter et doing_filter.

Comment fonctionnent les filtres WordPress

Les filtres interceptent les données transmises par WordPress. Ils les modifient en fonction de la fonctionnalité donnée et les affichent dans le navigateur web de l'utilisateur. Pour vous aider à comprendre, regardez l'extrait de code suivant :

// Spécifiez le filtre et la fonction de rappel
   add_filter('exemple_filtre', 'exemple_callback' ) ; // Définir la fonction de rappel.
   // Définir la fonction de rappel
   function example_callback( $example ) {
      // modifie $example en le concaténant
      $exemple . ' ajouter un texte à la fin ' ; return $example ; $example .
      return $example ; }
   }

Voici une explication de l'exemple :

1. utiliserajouter_filtredéfinit un filtre qui modifiera les données. Dans notre exemple, le nom du filtre estexemple_filtre.
2. Définissez la fonction de rappel que WordPress exécutera lorsqu'il trouvera un filtre, c'est-à-direexemple_callback.
3. Spécifie comment la fonction de rappel modifiera le fichier$exempleLes données indiquées par le paramètre. Dans l'extrait, nous utiliserons un point pour le relier à la phrase à la fin.
4. utiliserretouraffiche les données modifiées dans le navigateur Web de l'utilisateur.

Pour appliquer le crochet de filtrage à votre site WordPress, écrivez le code dans la sectionfunctions.phpDocumentation.

Il est recommandé d'ajouter le code à la rubriquesous-thème(utilisé comme expression nominale)papiersdans le dossier racine du thème pour éviter que le code ne soit perdu après une mise à jour du thème. Vous pouvez également créer un fichier distinct dans le dossier racine du thème pour contenir les crochets de filtre et l'appeler dans le fichier functions.php. Cela permettra de mieux organiser votre code et de s'assurer qu'il ne sera pas perdu lors d'une mise à jour du thème.

include _once( get_template_directory(), '/votrefilename.php':'

Si vous n'avez pas accès au dossier racine du thème, installez le plugin pour ajouter du code personnalisé directement à partir du tableau de bord d'administration de WordPress. Des plugins pour cette tâche sont disponiblesExtraits de code.

Attention :modificationsfunctions.phppeut entraîner une erreur ou rendre le site inaccessible. Pour éviter cela, avant de continuerCréation d'une sauvegarde.

Paramètres de WordPress add_filter

WordPress ajouter_filtreLa fonction a quatre arguments. Chacun d'entre eux est présenté ci-dessous :

• nom du crochet. La fonction de rappel que vous voulez accrocher à la fonction Nom du filtre.
• fonction de rappel. La fonction de rappel à exécuter lorsque le filtre est appliqué.
• Priorités. Paramètre facultatif spécifiant l'ordre d'exécution des fonctions associées au filtre. La valeur par défaut est10(math.) genre Plus le nombre est petit, plus la mise en œuvre est précoce.
• Arguments acceptés. Le nombre d'arguments à passer à la fonction de crochet. Ce paramètre est facultatif et la valeur par défaut est1.

La syntaxe de la fonction et des arguments est la suivante :

add_filter( hook_name, callback_function, priority=1,
   arguments_acceptés=1) ;

Exemple de add_filter dans WordPress qui modifie la longueur de l'extrait d'un article WordPress :

function custom_excerpt_length( $length ) {
    return 20 ; // modifiez le nombre ici pour ajuster la longueur de l'extrait
}
add_filter('excerpt_length', 'custom_excerpt_length', 999 ) ;

Dans cet exemple, nous créons une fonction personnalisée appelée custom_excerpt_length qui accepte un seul paramètre, $length, indiquant la longueur de l'extrait. Nous transmettons ensuite cette fonction comme argument à la fonction add_filter, en spécifiant le nom du filtre (excerpt_length) et le nom de notre fonction personnalisée. Le dernier paramètre 999 indique la priorité, et nous lui donnons ici une valeur plus élevée pour nous assurer que notre filtre est appliqué en dernier.

Afficher les images pour des catégories d'articles spécifiques

Les crochets de filtre de WordPress vous permettent de personnaliser les articles avec des ID ou des catégories spécifiques. Dans l'extrait de code ci-dessous, nous avons ajouté une icône pour chaque article appartenant à une catégorie premium :

add_filter( 'the_content', 'add_disclaimer' ) ;
   function add_disclaimer( $content )
   {
      // concaténer le contenu pour le modifier
      return $content .
      "<br><center><strong>Tous les écrits et opinions sont les miens".
   }

Dans l'exemple, nous avons créé le fichierle_contenuet le raccorder auwpb_content_filterCrochet de la fonction de rappel. Cette fonction spécifie les conditions dans lesquelles le filtre est appliqué.

Dans ce cas, si le Le poste appartient àniveau élevéla fonction de filtrage modifiera le contenu en y ajoutant des images.

Modifier le nombre de produits affichés

Les filtres vous permettent également de modifier le plugin eCommerce pour personnaliser votre boutique en ligne. Par exemple, le code de personnalisation suivant modifie le nombre de produits affichés sur le plugin WooCommerce :

add_filter('storefront_products_per_page','alter_sf_products_per_page' ) ;
   function alter_sf_produits_par_page()
   fonction alter_sf_produits_par_page()
      // modifie la valeur par défaut
      function alter_sf_produits_par_page() { // modifier la valeur par défaut.
   }

Dans l'extrait de code, nous créons l'élémentstorefront_products_per_pageFiltres personnalisés avecalter_sf_produits_par_page. Lorsque les données le traversent, le filtre appelle cette fonction pour supprimer la valeur par défaut de l'élément12changer pour3et l'afficher dans le navigateur de l'utilisateur.

Autres filtres WordPress populaires

En plus de add_filterEn outre, il existe plusieurs autres fonctions que les développeurs peuvent utiliser avec les crochets de filtrage.

Supprimer le filtre ()

Cette fonction supprime les fonctions qui sont liées à un filtre spécifique. Les développeurs web l'utilisent souvent pour supprimer les fonctions par défaut de WordPress sans avoir à supprimer entièrement le code. La syntaxe est la suivante :

remove_filter( hook_name, callback_function, priority = 10 ) ;

Exécuter Filter()

Cette fonction vérifie si une autre fonction est en cours d'exécution. Elle prend le nom du crochet comme argument et produitvraipeut-êtrefauxValeur de retour. Le code est le suivant :

if doing_filter( 'hook_name' )
{
// exécute un script si le filtre est en cours d'exécution
}

Oui_Filtre()

La fonction has_filter vérifie que le filtre a bien été appliqué au crochet. Elle prend le nom du filtre comme premier argument et la fonction de rappel comme second argument facultatif.

Pour vérifier la présence d'une fonction spécifique, le deuxième paramètre doit être inclus. Sinon, il renverravraipour indiquer qu'une fonction est connectée au filtre. Le code de cette fonction est le suivant :

has_filter( 'hook_name', 'callback_function' ) ;

Résumé :

Un filtre est un crochet WordPress utilisé pour modifier des données avant qu'elles ne soient affichées sur un site web. Les développeurs web l'utilisent pour personnaliser les plugins ou les thèmes afin d'ajouter des fonctionnalités supplémentaires à leurs sites web.

Les crochets de filtre interceptent les données transmises par WordPress, les modifient en fonction de vos besoins et les affichent dans le navigateur du visiteur. Pour mettre en place un filtre, ajoutez le crochet de filtre à la sectionÉcrivez add_filter dans le fichier functions.php.avec comme arguments le nom du crochet et la fonction de rappel.

Parmi les exemples d'utilisation des crochets de filtrage, citons la modification de la longueur des extraits d'articles et l'ajout de clauses de non-responsabilité aux articles publiés sur le site web. En plus desajouter_filtreEn outre, ses autres fonctions sont les suivantesremove_filteretfaire_filtrerépondre en chantanta_filtre.

Contactez nous
Vous n'arrivez pas à lire le tutoriel ? Contactez-nous pour une réponse gratuite ! Aide gratuite pour les sites personnels et les sites de petites entreprises !	Service clientèle WeChat
① Tel : 020-2206-9892
② QQ咨询：1025174874
(iii) Courriel : info@361sale.com
④ Horaires de travail : du lundi au vendredi, de 9h30 à 18h30, jours fériés.