Aller au contenu principal
Version: 26.0.10.0

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