remove_action()

Définition : remove_action() retire un callback précédemment enregistré sur une action WordPress. Elle évite son exécution lors des déclenchements suivants, à condition de fournir le même callback et la même priorité que lors de l’inscription.

Terminologie

Terme : remove_action()

Autres appellations : Retirer une action

À quoi cela sert

La fonction agit sur la liste des écouteurs du hook. Elle n’efface ni l’action elle-même ni les autres callbacks enregistrés sous ce nom. Le retour booléen indique si le retrait a réussi ; une méthode d’objet doit être désignée avec la même instance.

Dans quel contexte l’utiliser

L’utiliser lors de la personnalisation d’un thème ou d’une intégration déjà connue : remplacer proprement un comportement existant sans modifier son fichier source. Exécuter le retrait après l’enregistrement initial et avant le déclenchement visé.

Exemple concret

Un thème retire, lors d’un événement de chargement, un message de pied de page préalablement enregistré par sa propre extension.

Exemple de code commenté

<?php
function atoolpha_demo_pied() {
    echo '<!-- Démonstration ATOOLPHA -->';
}
add_action( 'wp_footer', 'atoolpha_demo_pied', 10 );
add_action( 'init', function () {
    remove_action( 'wp_footer', 'atoolpha_demo_pied', 10 );
} );

Explication de l’exemple

La fonction nommée est d’abord inscrite sur wp_footer. Lors du hook init, elle est retirée avant le rendu ; aucune sortie ne sera produite par ce callback en pied de page.

Précautions et limites

Le retrait ne fonctionne pas si la priorité ou l’identité du callback ne correspond pas. Ne pas supprimer au hasard des traitements essentiels d’une extension tierce.