has_action()

Définition : has_action() vérifie si des callbacks sont inscrits sur une action WordPress. Avec un callback précis, elle peut retourner sa priorité ou false ; un test strict est nécessaire pour distinguer la priorité zéro d’une absence.

Terminologie

Terme : has_action()

Autres appellations : Vérifier une action

À quoi cela sert

Sans callback, la fonction répond si une action possède au moins un écouteur enregistré. Avec un callback, elle peut retourner un entier représentant la priorité du traitement. Elle examine l’enregistrement courant, pas le nombre de fois où l’action a été déclenchée.

Dans quel contexte l’utiliser

L’utiliser dans le diagnostic de conflits entre extensions, avant de retirer une action connue ou pour afficher un état technique. Vérifier le résultat avec === false lorsqu’on cherche une priorité.

Exemple concret

Un développeur veut confirmer qu’une routine de suivi est bien attachée au hook init avant d’en modifier le comportement.

Exemple de code commenté

<?php
function atoolpha_demo_initialiser() {
    // Traitement métier documenté ailleurs.
}
add_action( 'init', 'atoolpha_demo_initialiser', 0 );
$priorite = has_action( 'init', 'atoolpha_demo_initialiser' );
if ( false !== $priorite ) {
    // Ici, $priorite vaut 0 : le callback est enregistré.
}

Explication de l’exemple

La variable contient un entier ou false. La comparaison stricte détecte correctement une fonction enregistrée avec priorité zéro, qui serait interprétée à tort comme absente par une condition simple.