Action

Définition : Une action WordPress est un point d’exécution où des fonctions enregistrées peuvent réagir à un événement ou à une étape du chargement. Elle déclenche des opérations sans transmettre une valeur modifiée au code appelant.

Terminologie

Terme : Action

Autres appellations : Action hook, Crochet d’action

À quoi cela sert

Une action sert à exécuter un traitement au bon moment sans modifier les fichiers du Core. On peut, par exemple, enregistrer un type de contenu après initialisation, déclarer un menu d’administration ou réagir à la sauvegarde d’un article.

Comment cela fonctionne

Le moteur appelle les fonctions enregistrées sur le même nom de hook. Leur ordre dépend de la priorité, puis de l’ordre d’enregistrement à priorité égale. Leurs valeurs de retour ne constituent pas le résultat de l’action : une action n’est pas un filtre.

Dans quel contexte l’utiliser

Choisir une action lorsque le besoin est « effectuer quelque chose quand tel événement survient ». Pour transformer une valeur utilisée par WordPress, préférer un filtre. Vérifier le moment précis du déclenchement et les données fournies par le hook.

Exemple concret

Une extension enregistre un callback sur init pour déclarer ses éléments seulement quand WordPress a chargé les API nécessaires.

Exemple de code commenté

<?php
// Dans un plugin chargé avant le hook init.
add_action( 'init', function () {
    register_post_type( 'atoolpha_fiche', array(
        'label'  => 'Fiches de démonstration',
        'public' => false,
    ) );
} );

Explication de l’exemple

La fonction anonyme est enregistrée sur init à la priorité normale 10. Lorsque cet événement survient, WordPress l’appelle ; le code effectue ici un enregistrement de type de publication privé destiné à une démonstration.

Précautions et limites

Le code est un exemple de plugin : l’enregistrement du type doit rester stable et cohérent avec les besoins du site. Ne pas confondre l’enregistrement d’une action avec le déclenchement de do_action().