is_admin_bar_showing()
Détermine si la barre d'administration doit être montrée.
Description / Informations supplémentaires
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.
Déclaration et structure de la fonction is_admin_bar_showing()
is_admin_bar_showing() est déclarée dans le fichier wp-includes/admin-bar.php à la ligne 1347 :
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 utilisées 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.
apply_filters()Appel les fonctions qui ont été attaché à un filtre (hook).
Hook utilisé par is_admin_bar_showing()
show_admin_barFiltre si l'on doit montrer la barre d'administration ou non.
Où est utilisée 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