remove_action( string $tag, callable $function_to_remove, int $priority = 10 )

Supprime une fonction attachée au hook d'une action.

Paramètres

$tag(string)requis

Nom du hook de l'action.

$function_to_remove(callable)requis

Le nom de la fonction que l'on veut supprimer.

$priority(int)optionnel

Priorité de la fonction à supprimer.

Valeur par défaut : 10

Description / Informations supplémentaires

Cette fonction peut être utilisée pour supprimer des fonctions attachées par défaut à certains hooks et éventuellement les remplacer par des fonctions personnalisées.

Cette fonction est un alias de remove_filter().

$function_to_remove et $priority doivent correspondre au hook ajouté. Aucune alerte ne sera donnée si la suppression ne fonctionne pas.

Retourne

(bool) True si la fonction a été supprimé.

Déclaration et structure de la fonction remove_action()

function remove_action( $hook_name, $callback, $priority = 10 ) {
    return remove_filter( $hook_name, $callback, $priority );
}
remove_filter()

Supprime une fonction attachée au hook d'un filtre.

Où est utilisée la fonction remove_action() dans le CMS WordPress

Exemples

remove_action() doit être appelé à l'intérieur d'une fonction :
add_action( 'wp_head', 'remove_my_action' );
function remove_my_action() {
    remove_action( 'wp_footer', 'function_being_removed' );
}
Pour supprimer une action ajoutée au sein d'une classe :
add_action( 'wp_head', 'remove_my_class_action' );
function remove_my_class_action() {
    global $my_class;
    remove_action( 'wp_footer', array( $my_class, 'class_function_being_removed' ) );
}
Pour supprimer une action ajoutée au sein d'une classe statique :
add_action( 'wp_head', 'remove_my_class_action' );
function remove_my_class_action() {
    remove_action( 'wp_footer', array( 'My_Class', 'class_function_being_removed' ) );
}

Sources

Codex WordPress : remove_action()

Autres fonctions dans le même fichier : wp-includes/plugin.php

Retour