# Tableau de bord

> Page d'accueil de l'administration WordPress, composée de widgets modulaires résumant l'activité récente du site et de son écosystème.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/tableau-de-bord/

C'est le premier écran vu après connexion : un condensé de la vie du site, entre commentaires récents à modérer, brouillons en cours et actualités officielles du projet WordPress, le tout organisé en blocs déplaçables par glisser-déposer.

## Une mosaïque de widgets enregistrables

Chaque bloc de cet écran est un widget de tableau de bord, enregistré via `wp_add_dashboard_widget()`, appelée sur le hook `wp_dashboard_setup`. Cette fonction prend un identifiant, un titre, une fonction de rendu et, en argument optionnel, une fonction de configuration pour les widgets paramétrables.

L'utilisateur peut réorganiser ces blocs, en replier certains, ou en masquer d'autres depuis l'écran d'options : ces préférences sont propres à chaque compte et stockées comme métadonnées utilisateur.

## Exemple : ajouter un widget personnalisé

```
<?php
add_action( 'wp_dashboard_setup', function () {
    wp_add_dashboard_widget(
        'stats_maison',
        'Statistiques internes',
        function () {
            echo '<p>' . wp_count_posts()->publish . ' articles publiés.</p>';
        }
    );
} );
```

## Pièges fréquents

- Le widget « Actualités WordPress » interroge un flux RSS distant à chaque affichage ou presque : sur un serveur sans accès sortant, il peut ralentir légèrement le chargement de la page si le cache HTTP n'a pas encore fait son travail.
- Retirer un widget par défaut se fait avec `remove_meta_box()`, pas avec un simple `unset` côté PHP, puisque ces blocs sont enregistrés comme des boîtes meta génériques.
- Un rôle « Abonné » n'a en général accès à aucun widget d'activité éditoriale, ses capacités limitant fortement ce qu'il peut voir sur cet écran.