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.