Créer une section

Une section est un conteneur qui regroupe des champs de configuration liés. Elle permet d'organiser logiquement les options de personnalisation dans l'interface d'administration.

Structure d'une section

Voici comment structurer une section dans votre fichier YAML :

# ID de la section (en snake_case)
typographie:
    # Titre affiché dans l'interface
    title: "Typographie"

    # Description optionnelle qui apparaît sous le titre
    description: "Personnalisez l'apparence typographique de votre site"

    # Priorité d'affichage (plus le nombre est bas, plus la section apparaît haut)
    priority: 10

    # (Optionnel) Désactiver la section
    active: true

    # (Optionnel) Permission WordPress requise
    capability: "edit_theme_options"

    # Champs de configuration
    fields:
        # ID du champ (en snake_case)
        police_principale:
            # Libellé affiché dans l'interface
            label: "Police principale"

            # Type de champ (sélecteur de police)
            type: "text"

            # Valeur par défaut
            default: "Arial, sans-serif"

Exemples concrets

Section de typographie

typography:
    title: "Typographie"
    description: "Personnalisez les polices de votre site"
    priority: 10
    fields:
        font_primary:
            label: "Police des titres"
            type: "text"
            default: "'Roboto', sans-serif"

        font_secondary:
            label: "Police du texte"
            type: "text"
            default: "'Open Sans', sans-serif"

        font_size_base:
            label: "Taille de base"
            type: "number"
            default: "16"
            suffix: "px"

Section d'en-tête

header:
    title: "En-tête"
    description: "Configuration de l'en-tête du site"
    priority: 5
    fields:
        header_background:
            label: "Couleur de fond"
            type: "color_contrast"
            default: "#ffffff"

        header_sticky:
            label: "En-tête fixe"
            type: "checkbox"
            default: true

        header_height:
            label: "Hauteur de l'en-tête"
            type: "range"
            min: 50
            max: 200
            step: 5
            default: 80
            suffix: "px"

Bonnes pratiques

• Utilisez des identifiants en snake_case (ex: header_settings, footer_layout)
• Organisez logiquement les champs par catégorie
• Utilisez des priorités avec des intervalles de 5 ou 10 pour faciliter l'insertion future
• Ajoutez des descriptions pour guider l'utilisateur
• Utilisez des valeurs par défaut pertinentes
• Utilisez active: false pour masquer une section sans la retirer de vos fichiers YAML
• Utilisez capability pour contrôler quels rôles peuvent voir la section