add_options_page()

Définition : add_options_page() ajoute une page de réglages sous le menu Réglages de l’administration WordPress. Elle fournit un emplacement cohérent pour configurer une extension sans créer systématiquement un menu principal supplémentaire.

Terminologie

Terme officiel : add_options_page()

Autres appellations : Page d’options

À quoi cela sert

Elle convient aux plugins dont l’administration consiste surtout en quelques paramètres. Son emplacement sous Réglages réduit l’encombrement du menu latéral et respecte les habitudes des administrateurs.

Comment cela fonctionne

La fonction est utilisée à admin_menu et reçoit titre, libellé, capacité nécessaire, slug et callback de rendu. La capacité filtre la visibilité du menu ; le callback doit lui aussi contrôler les droits avant d’afficher le contenu.

Dans quel contexte l’utiliser

À privilégier pour une petite ou moyenne page de configuration de plugin qui ne nécessite pas un véritable espace de travail indépendant.

Exemple concret

Une extension de mise en forme possède seulement un réglage de titre et souhaite une entrée discrète dans Réglages.

Exemple de code commenté

<?php
add_action( 'admin_menu', function () {
    add_options_page(
        'ATOOLPHA Démonstration', 'ATOOLPHA Démo',
        'manage_options', 'atoolpha-demo',
        function () {
            if ( ! current_user_can( 'manage_options' ) ) {
                wp_die( 'Accès refusé.' );
            }
            echo '<div class="wrap"><h1>ATOOLPHA Démo</h1></div>';
        }
    );
} );

Explication pas à pas de l’exemple

Au chargement du menu d’administration, WordPress ajoute une sous-page de Réglages. L’utilisateur sans manage_options n’a pas accès au contenu via le callback. L’exemple affiche uniquement un titre, pas un formulaire.

Résultat attendu

Le menu Réglages contient une entrée ATOOLPHA Démo pour les profils autorisés.

Précautions et limites

Il faut vérifier les autorisations dans le callback même si le menu utilise une capacité. Le slug doit être unique et l’écran final doit gérer correctement les traductions et l’accessibilité.