Barre d’administration

Que vous soyez sur le tableau de bord ou en train de consulter le site comme n’importe quel visiteur, une bande grise reste collée en haut de l’écran dès que vous êtes connecté. C’est cette barre qui donne accès en un clic à l’édition de la page en cours, au nombre de commentaires en attente ou au profil de l’utilisateur.

Fonctionnement et personnalisation

Elle est instanciée par la classe WP_Admin_Bar et peuplée via le hook d’action admin_bar_menu. Chaque entrée est un « nœud » ajouté avec la méthode add_node(), qui accepte un identifiant, un libellé, une URL et un parent optionnel pour créer des sous-menus.

Son affichage se contrôle avec la fonction show_admin_bar( false ), généralement appelée sur le hook init, ou en testant sa visibilité côté template avec is_admin_bar_showing(). Chaque utilisateur peut aussi la désactiver depuis l’onglet « Options » de son profil.

Exemple : ajouter un lien personnalisé

<?php
add_action( 'admin_bar_menu', function ( $wp_admin_bar ) {
    $wp_admin_bar->add_node( array(
        'id'    => 'support-site',
        'title' => 'Support',
        'href'  => 'https://exemple.fr/support',
    ) );
}, 100 );

Bon à savoir

• La barre ajoute une hauteur fixe (32 px sur ordinateur, 46 px sur mobile) qu’un thème mal conçu peut faire chevaucher avec son en-tête sticky : pensez à un margin-top conditionné par body.admin-bar.
• Elle ne s’affiche jamais pour un visiteur non connecté, quelle que soit la configuration.
• Les styles associés sont chargés séparément du reste de l’administration, via wp_enqueue_style( 'admin-bar' ), ce qui permet de la surcharger proprement depuis un thème enfant.