is_admin_bar_showing() | Fonctions Wordpress

Description

Pour plus d'informations sur cette fonction ou d'autres similaires, voir l'article Conditional Tags sur le Manuel du développeur de thème.

Retourne

(bool) True si la barre d'administration doit être montrée.

Structure de la fonction `is_admin_bar_showing()`

Définie dans le fichier wp-includes/admin-bar.php à la ligne 1197 :

function is_admin_bar_showing() {
    global $show_admin_bar, $pagenow;

    // For all these types of requests, we never want an admin bar.
    if ( defined( 'XMLRPC_REQUEST' ) || defined( 'DOING_AJAX' ) || defined( 'IFRAME_REQUEST' ) || wp_is_json_request() ) {
        return false;
    }

    if ( is_embed() ) {
        return false;
    }

    // Integrated into the admin.
    if ( is_admin() ) {
        return true;
    }

    if ( ! isset( $show_admin_bar ) ) {
        if ( ! is_user_logged_in() || 'wp-login.php' === $pagenow ) {
            $show_admin_bar = false;
        } else {
            $show_admin_bar = _get_admin_bar_pref();
        }
    }

    /**
     * Filters whether to show the admin bar.
     *
     * Returning false to this hook is the recommended way to hide the admin bar.
     * The user's display preference is used for logged in users.
     *
     * @since 3.1.0
     *
     * @param bool $show_admin_bar Whether the admin bar should be shown. Default false.
     */
    $show_admin_bar = apply_filters( 'show_admin_bar', $show_admin_bar );

    return $show_admin_bar;
}

Fonctions et Hook utilisés par `is_admin_bar_showing()`

wp_is_json_request(): Vérifie si la requête actuelle est une requête JSON ou s'il est attendu une réponse JSON.
is_embed(): Détermine si la requête est pour un poste incrusté.
is_user_logged_in(): Détermine si le visiteur actuel est connecté.
is_admin(): Détermine si la requête actuelle est pour une page de l'administration WordPress.
_get_admin_bar_pref(): Retourne les préférences de l'utilisateur pour l'affichage de la barre d'administration.
show_admin_bar: Filtre si l'on doit montrer la barre d'administration ou non.
apply_filters(): Appel les fonctions qui ont été attaché à un filtre (hook).

Où trouver la fonction `is_admin_bar_showing()` dans le CMS Wordpress

Exemple

if ( is_admin_bar_showing() ) {
    // code ici ...
}

Sources

Codex Wordpress : is_admin_bar_showing()

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

Retour