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

什么是 WordPress 过滤器？

WordPress 过滤器是一个钩子，可以在数据返回到数据库并显示给用户之前修改数据。因此，你可以自定义插件、主题或网站的功能，而无需更改 WordPress 核心文件。 例如，向所有网站帖子添加脚注或更改其摘录长度。有四种常见的过滤器钩子函数——add_filter、 remove_filter、has_filter和doing_filter。

WordPress 过滤器的工作原理

过滤器拦截 WordPress 传递的数据。它们根据给定的功能对其进行修改并将其显示到用户的网络浏览器上。为了帮助您理解，请查看以下代码片段：

// Specify the filter and the callback function
   add_filter( 'example_filter', 'example_callback' );
   // Define the callback function
   function example_callback( $example ) {
      // alter $example by concatenating on it
      $example . ‘ add a text at the end ’;
      return $example;
   }

以下是该示例的解释：

1. utiliseradd_filter函数设置一个将修改数据的过滤器。在我们的例子中，过滤器名称是example_filter.
2. 定义WordPress找到过滤器时将运行的回调函数，即example_callback.
3. 指定回调函数将如何修改$example参数表示的数据。在片段中，我们将使用句号将其与末尾的句子连接起来。
4. utiliserretour方法将修改后的数据显示到用户的 Web 浏览器。

要将过滤器挂钩应用到您的 WordPress 网站，请将代码写入当前活动主题的functions.phpDocumentation.

建议将代码添加到sous-thème(utilisé comme expression nominale)papiers中，以防止在主题更新后代码丢失。或者在主题根文件夹中创建一个单独的文件来存放过滤器挂钩，并在functions.php文件中调用它。这样可以更好地组织你的代码并确保其在主题更新时不会丢失。

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

如果你无法访问主题根文件夹，请安装插件以直接从 WordPress 管理仪表板添加自定义代码。用于此任务的插件可选择Extraits de code.

Attention :modificationsfunctions.php文件可能会导致错误或网站无法访问。为了避免这种情况，请在继续之前Création d'une sauvegarde.

WordPress add_filter 参数

WordPress add_filter函数有四个参数。以下是它们中的每一个：

• 钩名。你想要将回调函数挂钩到的 过滤器名称。
• 回调函数。应用过滤器时要运行的回调函数。
• Priorités。一个可选参数，指定与过滤器关联的函数的执行顺序。默认值为10(math.) genre 数字越小，执行越早。
• 接受的论点。传递给挂钩函数的参数数量。此参数是可选的，默认值为1.

函数和参数语法如下：

add_filter( hook_name, callback_function, priority=1, 
   accepted_arguments=1);

WordPress 中 add_filter 更改WordPress帖子摘录的长度的示例：

function custom_excerpt_length( $length ) {
    return 20; // 更改此处的数字以调整摘录的长度
}
add_filter( 'excerpt_length', 'custom_excerpt_length', 999 );

在这个例子中，我们创建了一个名为custom_excerpt_length的自定义函数，该函数接受一个参数$length，表示摘录的长度。然后，我们将这个函数作为参数传递给add_filter函数，指定了过滤器的名称（excerpt_length）和我们自定义的函数名。最后的999参数表示优先级，这里我们将其设置为较高的值，以确保我们的过滤器最后被应用。

显示特定帖子类别的图像

WordPress 过滤器挂钩可让您自定义具有特定 ID 或类别的帖子。在下面的代码片段中，我们为属于高级类别的每个帖子添加了一个图标：

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".
   }

在示例中，我们创建了the_content过滤器并将其与wpb_content_filter回调函数挂钩。该函数指定过滤器应用的条件。

在这种情况下，如果 帖子属于niveau élevé类别，过滤器功能将通过向其中添加图像来更改内容。

更改显示的产品数量

过滤器还允许你修改电子商务插件以自定义你的在线商店。例如，以下自定义代码可更改 WooCommerce 插件上显示的产品数量：

add_filter('storefront_products_per_page','alter_sf_products_per_page' );
   function alter_sf_products_per_page() 
   {
      // change the default value
      return 3 ;
   }

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 desadd_filterEn outre, ses autres fonctions sont les suivantesremove_filteretfaire_filtrerépondre en chantanta_filtre.