apply_filters( 'option_{$option}', mixed $value, string $option )

Filtre la valeur d'une option existante.

Paramètres

$value(mixed)

Valeur de l'option. Si sérializée, elle sera désérializée avant d'être retournée.

$option(string)

Nom de l'option.

Description / Informations supplémentaires

La portion dynamique du nom du hook $option fait référence au nom de l'option.

Application du hook option_{$option}

Le hook option_{$option} est appliqué dans le fichier wp-includes/option.php à la ligne 247 :

return apply_filters( "option_{$option}", maybe_unserialize( $value ), $option );
get_option()

Retourne une valeur d'option en fonction de son nom.

Où est utilisé le hook option_{$option} dans le CMS WordPress

Exemples

Désactiver un plugin :
var_dump( get_option( 'active_plugins' ) );
// Retourne un tableau de tous les plugins.

add_filter( 'option_active_plugins', function( $plugins ){
    if ( $ma_condition ) {
        unset( $plugins['mon-plugin-slug'] );
    }
    return $plugins;
});

var_dump( get_option( 'active_plugins' ) );
// Retourne un tableau vide.
Filtrer la description du blog :
add_filter( 'option_blogdescription', 'my_theme_filter_blogdescription' );
 
function my_theme_filter_blogdescription( $description ) {
 
    if ( ! is_archive() ) {
        return $description;
    }
 
    global $page, $paged;
 
    if ( ( $paged >= 2 || $page >= 2 ) && ! is_404() ) {
        $description .= $description . sprintf( __( ' Page %d' ), max( $paged, $page ) );
    }
 
    return $description;
}

Sources

Codex WordPress : option_{$option}

Autres hooks dans le même fichier : wp-includes/option.php

Retour