Ajout de crochets personnalisés dans WordPress: Filtres personnalisés

Dans cette série en deux parties, nous jetons un coup d'œil au système Hook WordPress. Plus précisément, nous examinons de près les actions et les filtres et le rôle qu'ils jouent dans le développement WordPress.

Bien qu'ils soient tous deux définis comme des crochets, chacun joue un rôle spécifique dans le développement WordPress. Et si vous cherchez à devenir un développeur WordPress plus accompli, il est important de comprendre non seulement la différence entre eux, mais aussi comment vous pouvez implémenter des crochets personnalisés.

Dans le premier post de la série, nous avons défini quels étaient les crochets, avons vu comment ils ont été utilisés ailleurs, et également examiné des actions, y compris comment définir le nôtre. Si vous avez attrapé le premier article, je vous recommande fortement de le lire avant de procéder à ce tutoriel.

Avant de commencer avec les crochets, je vais vous rafraîchir rapidement ce qui a été discuté dans l'article précédent, puis nous allons avancer de là. modèle de conception axé sur les événements. En particulier, nous l'avons défini comme le suivant:

Le logiciel a certains points dans lesquels il diffuse un message que quelque chose s'est produit.

Nous, en tant que développeurs, sommes en mesure d'écrire du code qui écoute ce message, puis nous y répondons exactement sur la façon dont ce modèle est implémenté dans WordPress. Nous avons parlé de la façon dont nous pouvons en profiter, puis nous avons expliqué comment nous pouvons implémenter notre propre action.

Nous avons également reconnu une distinction subtile:

• Les actions sont censées travailler avec les fonctionnalités, et les filtres sont censés travailler avec les données. ou affiché à l'écran. Dans ce tutoriel, nous allons voir comment travailler avec des filtres avant d'écrire des données à l'écran, telles que comment en minuscules. Démarré
• Rappelez-vous de l'article précédent que notre environnement de développement local devrait être composé des éléments suivants:

WordPress 6.0.1

votre copie préférée

un serveur Web

Une copie de Php

A Database

Et si vous n'avez aucune configuration, alors pas de soucis: nous vous sommes couverts. Le didacticiel lié vous fournira tout ce dont vous avez besoin pour commencer à travailler avec WordPress sur votre machine locale.

Une fois que vous êtes configuré, nous serons prêts à continuer.

Comprendre les filtres WordPress

La référence de code WordPress fournit un ensemble complet de ressources pour ceux qui cherchent à apprendre tout sur les filtres. Comme nous l'avons dit, il définit les filtres comme les suivants:

Les filtres personnalisés diffèrent des actions personnalisées car les actions personnalisées vous permettent d'ajouter ou de supprimer le code des actions existantes. Alors que les filtres personnalisés vous permettent de remplacer des données spécifiques (comme une variable) trouvées dans une action existante.

Mais si vous recherchez une liste entière des filtres disponibles dans WordPress, assurez-vous de référencer (et de mettre en signet) cette page dans le codex. Il a environ 20 secondes de filtres, dont beaucoup sont liés à leur propre page de documentation.

Cela signifie que si vous êtes curieux de savoir si un filtre spécifique existe, vous pouvez alors référencer cette page. De même, vous pouvez visiter la page de ce filtre particulier afin de visualiser les paramètres de l'argument, un exemple de définition de la fonction, et comment travailler avec.

un mot sur la priorité et les paramètres

Avant d'aller plus loin, je veux m'assurer que nous en parlons tous sur la même page de la priorité et le nombre d'arguments référencés lorsque nous en parlions tous dans le contexte de WordPress WordPress Hooks.

Prendre, par exemple, la ligne de code suivante:

<?php<br>add_filter( 'author_edit_pre', 'filter_function_name', 10, 2 );<br>

Cela nous dit quatre choses:

1. Le nom du filtre que nous connectons
2. Le nom de la fonction qui doit être appelée
3. La priorité de la fonction doit être appelée
Acceptez

de manière générale, les deux premiers points sont rapidement compris; Cependant, les deux autres peuvent souvent trébucher de nouveaux développeurs, mais ce n'est pas un concept difficile à comprendre.

Tout d'abord, pensez à la priorité comme

Lorsque la fonction est appelée. N'oubliez pas que comme un crochet donné peut avoir plusieurs fonctions qui lui sont associées, la priorité vous permet de définir le temps ou la retard de votre fonction. Plus le nombre est bas, plus il tire plus tôt; Plus le nombre est élevé, plus il tire plus tard.

Deuxièmement, le nombre indique le nombre de paramètres d'un argument. Si vous ne spécifiez pas de nombre, il n'acceptera aucun ou quel que soit l'argument par défaut. Si vous souhaitez passer un montant différent de ce qui est attendu, vous spécifieriez le nombre de paramètres que l'argument doit accepter. Nous verrons cela plus en détail plus tard dans le tutoriel.

Travailler avec les filtres

Pour commencer à travailler avec des filtres, allons-y et créons notre propre fichier à la racine du répertoire TwentyTwentyTwo. Nous appellerons le fichier the_content Filter Hook. Ensuite, nous utiliserons les fonctionnalités applicables_filters

C'est là que nous commençons à s'intéresser à la fonction str_replace () . Cependant, nous devons modifier la façon dont le filtre est enregistré auprès de WordPress, puis nous devons nous assurer que la fonction enregistrée avec WordPress appelle correctement appliquer_filters <code>apply_filters.

Étant donné que nous avons vu comment ajouter notre propre filtre, spécifier une priorité, définir le nombre d'arguments qu'il devrait accepter, et implémenter une fonction, je ne pers pas de temps avec des détails inférieurs. et il est appelé tout seul:

La sortie avec le filtre ci-dessus ressemblera à l'image ci-dessous:

<?php<br>add_filter( 'author_edit_pre', 'filter_function_name', 10, 2 );<br>

Et alors c'est ainsi que vous pouvez l'appeler à partir du crochet initial.

Les appeler tous ensemble

Enfin, il est possible d'appeler appliquer_filters

Times multiples: Le résultat final de l'application des deux filtres ensemble:

apply_filters

Remarquez que cela obtient le résultat combiné des cas précédents, mais il le fait en les condensant en une seule ligne de code. Il existe d'autres façons qui pourraient également être écrites, mais le but de ce tutoriel est de vous informer de la façon d'écrire vos propres filtres et de profiter de appliquer_filters <div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">&lt;?php&lt;br&gt;&lt;br&gt;add_filter( 'tutsplus_replace_country', 'tutsplus_replace_country_callback', 10, 1 );&lt;br&gt;function tutsplus_replace_country_callback( $content ) {&lt;br&gt; return str_replace( 'Canada', 'U.S.', $content );&lt;br&gt;}&lt;br&gt;&lt;br&gt;add_filter( 'the_content', 'tutsplus_the_content' );&lt;br&gt;function tutsplus_the_content( $content ) {&lt;br&gt;&lt;br&gt; // Proceed with this function only if we are viewing a particular post.&lt;br&gt; if ( is_single() &amp;&amp; get_the_ID() == 66) {&lt;br&gt; return apply_filters( 'tutsplus_replace_country', $content );&lt;br&gt; } else {&lt;br&gt; return $content;&lt;br&gt; }&lt;br&gt;}&lt;br&gt;</pre><div class="contentsignin">Copier après la connexion</div></div> dans votre travail. <p> </p> Conclusion <img src="/static/imghw/default1.png" data-src="https://img.php.cn/upload/article/000/000/000/174079321711288.png" class="lazy" alt="Ajout de crochets personnalisés dans WordPress: Filtres personnalisés" > <p> Ce tutoriel conclut notre introduction aux crochets WordPress. Tout au long de la série, nous avons examiné comment profiter des actions et des filtres existants, ainsi que comment créer et mettre en œuvre le nôtre. <code>apply_filters

Le système de crochet est l'un des aspects les plus puissants de WordPress pour les développeurs, il est donc important de se familiariser avec cela. Ce faisant, vous êtes non seulement en mesure de manipuler le comportement et les données fournis par WordPress, mais vous êtes également en mesure de définir des crochets que d'autres développeurs peuvent utiliser tout au long de leur code.

Ce message a été mis à jour avec les contributions de Nitish Kumar. Nitish est un développeur Web ayant une expérience dans la création de sites Web de commerce électronique sur diverses plateformes. Il passe son temps libre à travailler sur des projets personnels qui facilitent sa vie quotidienne ou à faire de longues promenades en soirée avec des amis.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!