Notification d’administration

« Réglages enregistrés », « Une mise à jour est disponible », « La licence de cette extension a expiré » : ces bandeaux verts, orange ou rouges qui apparaissent juste sous le titre de la page sont un langage visuel que tout utilisateur de WordPress reconnaît instantanément.

Un hook, quatre classes CSS

Ces messages sont produits en s’accrochant au hook d’action admin_notices (ou all_admin_notices pour un affichage y compris sur les écrans réseau d’un multisite), en générant une balise <div> portant la classe notice combinée à un modificateur : notice-success, notice-warning, notice-error ou notice-info. Ajouter la classe is-dismissible fait apparaître une croix de fermeture gérée en JavaScript par le cœur de WordPress, sans code supplémentaire à écrire.

Exemple

<?php
add_action( 'admin_notices', function () {
    echo '<div class="notice notice-warning is-dismissible">';
    echo '<p>Pensez à configurer votre clé API.</p>';
    echo '</div>';
} );

Bon à savoir

• Pour les messages liés à un formulaire de réglages construit avec l’API des réglages, préférez add_settings_error() puis settings_errors(), qui gèrent automatiquement le style et évitent les doublons après un rechargement de page.
• Un clic sur la croix de fermeture d’une notice « dismissible » ne la supprime que visuellement côté navigateur : si elle doit rester masquée durablement, il faut enregistrer ce choix soi-même, par exemple via une requête AJAX vers update_user_meta().
• Abuser de ces bandeaux, notamment à but promotionnel dans les extensions, est une pratique explicitement déconseillée par les recommandations du répertoire officiel d’extensions.