add_action()

Définition : add_action() est la fonction WordPress qui associe un callback à une action nommée. Elle permet à une extension ou à un thème d’exécuter du code lorsque le hook concerné est déclenché pendant une requête.

Terminologie

Terme : add_action()

Autres appellations : Enregistrement d’action

À quoi cela sert

Cette fonction enregistre une fonction, une méthode ou une fermeture dans le gestionnaire des hooks. Elle ne lance pas immédiatement le traitement. Ses paramètres sont le nom du hook, le callback, la priorité optionnelle et le nombre d’arguments acceptés.

Comment cela fonctionne

L’enregistrement doit intervenir avant que l’action ne soit déclenchée. Pour recevoir plusieurs arguments d’un hook, le quatrième paramètre doit refléter la signature du callback. La valeur de retour true ne valide pas l’existence du callback.

Dans quel contexte l’utiliser

Se servir de add_action() dans un plugin pour initialiser une fonctionnalité, ajouter un menu, enregistrer des scripts ou répondre à un événement de sauvegarde.

Exemple concret

Une extension doit ajouter une page de réglages au menu « Réglages » au chargement de l’administration.

Exemple de code commenté

<?php
// À placer dans un plugin chargé normalement.
add_action( 'admin_menu', function () {
    add_options_page(
        'Démonstration ATOOLPHA', 'Démonstration',
        'manage_options', 'atoolpha-demo',
        function () {
            if ( ! current_user_can( 'manage_options' ) ) {
                return;
            }
            echo '<div class="wrap"><h1>Démonstration</h1></div>';
        }
    );
} );

Explication de l’exemple

Le callback est appelé lors de admin_menu et déclare une page. La capacité manage_options limite son accès. Ce code présente la liaison à un événement sans accéder directement aux fichiers du Core.