# Barre d’administration

> Bandeau fixe affiché en haut des écrans, aussi bien dans l'administration que sur le site public, offrant des raccourcis contextuels à l'utilisateur connecté.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/barre-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.