Une extension figée, sans aucun réglage modifiable, convient à des besoins très simples ; dès qu’un choix doit être laissé à l’utilisateur (une clé d’API, une couleur, un nombre d’éléments à afficher), il lui faut un écran dédié dans l’administration.
Créer l’écran
La famille de fonctions add_menu_page() et add_submenu_page(), appelée sur le hook admin_menu, ajoute une entrée dans le menu et associe une fonction de rendu :
add_action( 'admin_menu', function () {
add_options_page(
'Réglages de Mon Extension',
'Mon Extension',
'manage_options',
'mon-extension',
'afficher_page_reglages'
);
} );
function afficher_page_reglages() {
echo '<div class="wrap"><h1>Mon Extension</h1></div>';
}La capacité manage_options passée en troisième argument restreint l’accès aux comptes administrateurs ; c’est le premier rempart de sécurité de cet écran.
À ne pas confondre
- Créer le menu ne construit pas le formulaire lui-même : c’est le rôle complémentaire de l’API des réglages, qui gère les champs, leur validation et leur enregistrement.
- Un identifiant de page (« slug ») dupliqué avec une autre extension provoque un conflit silencieux : la seconde page enregistrée écrase généralement l’accès à la première.
- La fonction
add_menu_page()crée une entrée de premier niveau dans le menu latéral, tandis queadd_submenu_page()l’ajoute sous un menu existant, comme « Réglages » ou « Outils ». - Le fond blanc encadré généralement affiché autour du contenu de la page s’obtient en enveloppant le rendu dans une balise portant la classe
wrap, une convention visuelle héritée des écrans natifs de WordPress.