has_filter( string $tag, callable|bool $function_to_check = false )

Vérifie si un filtre a été enregistré pour un hook.

Paramètres

$tag(string)requis

Nom du hook.

$function_to_check(callable|bool)optionnel

Fonction d'appel du hook.

Valeur par défaut : false

Retourne

(bool|int) Si $function_to_check est omis, retourne true si le hook a été enregistré, false sinon.

Quand une fonction est spécifiée, la priorité du hook est retournée ou false si elle n'est pas attachée au hook. La priorité peut valoir 0 donc la valeur de retour doit être testée avec l'opérateur ===.

Déclaration et structure de la fonction has_filter()

function has_filter( $hook_name, $callback = false ) {
    global $wp_filter;

    if ( ! isset( $wp_filter[ $hook_name ] ) ) {
        return false;
    }

    return $wp_filter[ $hook_name ]->has_filter( $hook_name, $callback );
}

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

Exemple

if ( ! has_filter( 'the_content', 'example_alter_the_content' ) ){
    add_filter( 'the_content', 'prefix_alter_the_content' );
}

Sources

Codex WordPress : has_filter()

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

Retour