Callback

Définition : Un callback WordPress est une fonction, une méthode ou une fermeture enregistrée pour être appelée lorsqu’une action ou un filtre se déclenche. Sa signature doit correspondre aux arguments fournis par le hook concerné.

Terminologie

Terme : Callback

Autres appellations : Fonction de rappel, Fonction callback

À quoi cela sert

Un callback représente le traitement associé au hook. Il peut être une fonction nommée, une méthode statique, une méthode d’instance ou une fonction anonyme. WordPress l’appelle avec les arguments prévus, dans l’ordre de priorité défini lors de son inscription.

Dans quel contexte l’utiliser

Choisir une fonction nommée ou une référence conservée lorsque le callback doit pouvoir être retiré ultérieurement. Pour un filtre, retourner systématiquement la valeur compatible ; pour une action, l’effet voulu se produit pendant l’appel.

Exemple concret

Un plugin ajoute une classe CSS à body_class grâce à une méthode statique réutilisable.

Exemple de code commenté

<?php
class Atoolpha_Exemple_Callback {
    public static function ajouter_classe( $classes ) {
        $classes[] = 'atoolpha-exemple';
        return $classes;
    }
}
add_filter( 'body_class', array( 'Atoolpha_Exemple_Callback', 'ajouter_classe' ) );

Explication de l’exemple

La méthode statique reçoit le tableau, vérifie que l’ajout n’est pas déjà présent et le retourne. Le tableau n’est modifié que si le callback s’exécute effectivement.

Précautions et limites

Une méthode d’instance doit être enregistrée avec la bonne instance ; créer un autre objet ne permettra généralement pas de retirer le callback existant.