admin_menu

Définition : admin_menu est une action WordPress utilisée pour enregistrer des pages et sous-menus dans l’administration. Elle permet aux extensions de présenter leurs écrans au bon endroit dans la navigation native de WordPress.

Terminologie

Terme : admin_menu

Autres appellations : Menu d’administration, Admin Menu Hook

À quoi cela sert

Le hook intervient lors de la construction du menu d’administration. Les fonctions add_menu_page(), add_submenu_page() et add_options_page() servent à déclarer des écrans, leur titre, leur capacité d’accès et leur fonction de rendu.

Dans quel contexte l’utiliser

L’utiliser pour ajouter une page de réglages, une interface d’audit ou un panneau de suivi. Prévoir une capacité appropriée, un slug stable et un rendu séparé du traitement des formulaires.

Exemple concret

Une extension d’analyse affiche un écran de démonstration sous le menu Outils, réservé aux administrateurs disposant de manage_options.

Exemple de code commenté

<?php
add_action( 'admin_menu', function () {
    add_management_page(
        'Diagnostic ATOOLPHA', 'Diagnostic ATOOLPHA',
        'manage_options', 'atoolpha-diagnostic',
        function () {
            if ( ! current_user_can( 'manage_options' ) ) {
                return;
            }
            echo '<div class="wrap"><h1>Diagnostic</h1></div>';
        }
    );
} );

Explication de l’exemple

Le menu est inscrit avec add_management_page(). WordPress vérifie la capacité de navigation ; le callback la revérifie avant d’afficher du contenu, selon une approche défensive.