add_settings_section()

Définition : add_settings_section() ajoute une section nommée à une page de réglages WordPress. Elle regroupe des champs liés à un même sujet et peut afficher une description introductive avant les paramètres.

Terminologie

Terme officiel : add_settings_section()

Autres appellations : Section de réglages

À quoi cela sert

La section améliore la lisibilité de l’administration en séparant des réglages par thème : affichage, notification ou sécurité. Elle constitue un conteneur de présentation, non une valeur enregistrée.

Comment cela fonctionne

WordPress mémorise l’identifiant, le titre, le callback de description et le nom de page. Les champs ajoutés avec add_settings_field() peuvent ensuite être rattachés à cet identifiant de section.

Dans quel contexte l’utiliser

À utiliser lorsqu’une page Settings API contient plusieurs paramètres que l’administrateur doit reconnaître immédiatement.

Exemple concret

Une extension regroupe ses préférences d’affichage sous une section « Présentation ».

Exemple de code commenté

<?php
add_action( 'admin_init', function () {
    add_settings_section(
        'atoolpha_presentation',
        'Présentation',
        function () {
            echo '<p>Paramètres d’affichage du module.</p>';
        },
        'atoolpha-demo-page'
    );
} );
// La page appelle do_settings_sections('atoolpha-demo-page').

Explication pas à pas de l’exemple

La section existe sous l’identifiant atoolpha_presentation. Le quatrième paramètre fixe la page dont le rendu doit afficher cette section. Le callback produit une courte description fixe ; les champs seront enregistrés séparément.

Résultat attendu

La section Présentation et son introduction sont visibles dans la page de réglages correspondante lorsque celle-ci affiche ses sections.

Précautions et limites

Le slug de page doit correspondre exactement à l’appel de rendu. Le titre et l’introduction ne remplacent ni l’enregistrement des options ni la protection du formulaire.