Bienvenue dans le "Guide des crochets, actions et filtres de WordPress". Dans le vaste domaine du développement WordPress, il est essentiel de comprendre les crochets, les actions et les filtres pour libérer tout le potentiel de cette puissante plateforme.
Les crochets constituent l'épine dorsale de la personnalisation de WordPress, car ils vous permettent de modifier et d'étendre ses fonctionnalités de manière transparente. Les actions vous permettent d'effectuer des tâches spécifiques à des moments clés de l'exécution, tandis que les filtres vous permettent de manipuler des données et de renvoyer des résultats modifiés. Que vous soyez un débutant ou un développeur expérimenté, ce guide complet vous fournira des informations précieuses et des exemples pratiques pour exploiter la véritable flexibilité et les capacités de personnalisation offertes par les crochets, les actions et les filtres de WordPress. Plongeons dans ce guide et découvrons les possibilités illimitées du développement WordPress.
Crochets
Les hooks sont la base du développement des plugins et des thèmes WordPress. Ce sont des endroits où les développeurs peuvent "accrocher" leur code personnalisé dans WordPress à des endroits spécifiques et modifier la façon dont WordPress fonctionne sans modifier les fichiers principaux.
Les crochets WordPress se composent de deux types fondamentaux connus sous le nom d'Actions et de Filtres. Les actions vous permettent d'exécuter des tâches spécifiques à des moments prédéfinis de l'exécution de WordPress, tandis que les filtres vous permettent de modifier et de renvoyer toutes les données traitées par WordPress.
Actions :
En employant une action, vous pouvez personnaliser le comportement par défaut d'une fonction particulière en extrayant des informations de WordPress et en effectuant des opérations dessus. Une fois qu'une action est exécutée, il n'est pas nécessaire de renvoyer des données à WordPress.
Pour ajouter des actions, la fonction add_action() est utilisée. WordPress propose plusieurs fonctions qui facilitent l'utilisation des actions, les plus couramment utilisées étant les suivantes :
Les actions sont définies dans le code WordPress comme suit
do_action( 'action_name', [optional_arguments] );
En vous connectant à l'action do_action('wp_head'), vous pouvez exécuter un code personnalisé lorsque WordPress traite l'en-tête du site. Cette action ne nécessite aucun argument supplémentaire.
Exemple complet :
add_action( string $hook_name, callable $callback, int $priority = 10, int $accepted_args = 1 ) : true
Références de toutes les actions :
https://codex.wordpress.org/Plugin_API/Action_Reference
https://developer.wordpress.org/reference/functions/add_action/
Un filtre modifie le comportement par défaut d'une fonction spécifique. Il manipule les données qu'il reçoit et les renvoie à WordPress avant de les afficher dans le navigateur.
Exemples :
Les filtres sont définis dans le code de WordPress comme suit
apply_filters( 'filter_name', 'value_to_be_filtered', [optional_arguments] );
La chaîne filter_name est le nom du filtre, la variable value_to_be_filtered est la valeur qui doit être filtrée et renvoyée, et la variable [optional_arguments] peut passer des arguments supplémentaires, comme pour les actions.
Exemple : Le filtre apply_filters( 'admin_footer_text' , string $text ) peut être utilisé pour modifier le texte affiché dans le pied de page de l'administrateur. A partir de WordPress 5.4, sa valeur par défaut affichera la phrase. Merci d'avoir créé avec WordPress. dans le pied de page de la zone d'administration.
|
Crochets WordPress |
|
| Actions | Filtres |
| Les actions sont utilisées pour exécuter des fonctions personnalisées à un moment précis de l'exécution de WordPress Core. | Les filtres sont utilisés pour modifier ou personnaliser les données utilisées par d'autres fonctions. |
| Les actions sont définies/créées par la fonction do_action( 'action_name' ) dans le code WordPress. | Les filtres sont définis/créés par la fonction apply_filters('filter_name', 'value_to_be_filtered' ) dans le code WordPress. |
| Les actions sont également appelées crochets d'action. | Les filtres sont également appelés crochets de filtre. |
| Les actions ne peuvent être connectées qu'à des fonctions d'action. Par exemple, add_action(), remove_action(). | Les filtres ne peuvent être utilisés qu'avec des fonctions de filtre. Par exemple, add_filter(), remove_filter(). |
| Les fonctions d'action ne doivent pas transmettre d'arguments à leurs fonctions de rappel. | Les fonctions de filtrage doivent transmettre au moins un argument à leurs fonctions de rappel. |
| Les fonctions d'action peuvent effectuer n'importe quel type de tâche, y compris modifier le comportement de WordPress. | Les fonctions de filtrage n'existent que pour modifier les données qui leur sont transmises par les filtres. Les fonctions d'action ne doivent rien renvoyer. Toutefois, elles peuvent renvoyer un écho ou interagir avec la base de données. |
| Les fonctions d'action ne doivent rien renvoyer. Cependant, elles peuvent renvoyer un écho ou interagir avec la base de données. | Les fonctions de filtrage doivent renvoyer leurs modifications en sortie. Même si une fonction de filtrage ne modifie rien, elle doit renvoyer l'entrée non modifiée. |
| Les actions peuvent exécuter presque n'importe quoi tant que le code est valide. | Les filtres doivent fonctionner de manière isolée afin d'éviter tout effet secondaire involontaire. |
En conclusion, la maîtrise de l'art des crochets, des actions et des filtres de WordPress ouvre un monde de possibilités infinies pour la personnalisation et l'amélioration de votre site Web WordPress. En comprenant le fonctionnement des hooks, en tirant parti de la puissance des actions et en exploitant la flexibilité des filtres, vous pouvez façonner les fonctionnalités et l'apparence de votre site web pour qu'il réponde à vos besoins spécifiques. Avec les connaissances acquises dans ce guide, vous êtes équipé pour prendre le contrôle de votre développement WordPress. Allez-y, expérimentez et créez des expériences remarquables pour vos utilisateurs. Profitez de la polyvalence des crochets, des actions et des filtres de WordPress et libérez le véritable potentiel de votre site web. Bon codage !
L'avenir de WordPress vous intéresse ? Consultez cet article!
