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

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

Description

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.

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

Paramètres

$tag

(string) (Requis) Nom du hook du filtre.

$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

Retourne

(bool) True si la fonction qui existait avant a bien été supprimé.

Structure de la fonction remove_filter()

Définie dans le fichier wp-includes/plugin.php à la ligne 276 :

function remove_filter( $tag, $function_to_remove, $priority = 10 ) {
    global $wp_filter;

    $r = false;
    if ( isset( $wp_filter[ $tag ] ) ) {
        $r = $wp_filter[ $tag ]->remove_filter( $tag, $function_to_remove, $priority );
        if ( ! $wp_filter[ $tag ]->callbacks ) {
            unset( $wp_filter[ $tag ] );
        }
    }

    return $r;
}

Où trouver la fonction remove_filter() dans le CMS Wordpress

Exemples

remove_filter( 'the_content', 'wpautop' );
Si un filtre a été ajouté au sein d'une classe, il faut accéder à celle-ci pour supprimer ce filtre :
global $my_class;
remove_filter( 'the_content', array($my_class, 'class_filter_function') );

Sources

Codex Wordpress : remove_filter()

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

Retour