# Page de réglages d’extension

> Écran d'administration créé par une extension pour permettre à l'utilisateur de configurer son comportement, généralement accessible depuis le menu latéral de WordPress.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/page-reglages-extension/

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 que `add_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.