# Écran de réglages

> Page d'administration permettant de configurer les options d'un site ou d'une extension, généralement construite avec l'API des réglages 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/ecran-de-reglages/

Plutôt que de coder à la main un formulaire, sa validation, sa sécurisation par nonce et sa sauvegarde en base, WordPress fournit un jeu de fonctions standard qui, assemblées correctement, produisent un écran cohérent avec le reste de l'administration : mêmes styles, mêmes messages de confirmation, même comportement clavier.

## Les briques de l'API des réglages

Tout commence par `register_setting( $groupe, $nom_option )`, qui déclare l'option et, si besoin, une fonction de nettoyage via l'argument `sanitize_callback`. Vient ensuite `add_settings_section()` pour regrouper des champs sous un même titre, puis `add_settings_field()` pour chaque champ individuel. Le formulaire lui-même est rendu par les fonctions `settings_fields( $groupe )` et `do_settings_sections( $page )`, encadrées d'un simple `<form method="post" action="options.php">`.

## Exemple minimal

```
<?php
add_action( 'admin_init', function () {
    register_setting( 'mon_groupe', 'ma_cle_api' );
    add_settings_field(
        'ma_cle_api', 'Clé API',
        function () {
            echo '<input type="text" name="ma_cle_api" value="' .
                esc_attr( get_option( 'ma_cle_api' ) ) . '">';
        },
        'ma-page', 'section_generale'
    );
} );
```

## Pièges fréquents

- Oublier `settings_fields()` supprime le nonce et la vérification de sécurité : la sauvegarde échoue silencieusement.
- Un écran de réglages doit être rattaché à un menu via `add_options_page()` ou équivalent, sinon il reste accessible uniquement par URL directe.
- Ne réinventez pas ce mécanisme avec un formulaire artisanal enregistrant directement `$_POST` dans `update_option()` : vous perdez la validation, l'échappement et la compatibilité avec les futurs outils d'export de réglages.