Créer un panel

Un panel de personnalisation est un conteneur qui regroupe plusieurs sections d'options configurables. Chaque section peut contenir un ou plusieurs champs de configuration.

Structure d'un panel

Pour créer un panel, vous devez créer un fichier YAML dans le dossier customize/ de votre thème. Voici la structure de base :

# ID unique du panel (en snake_case)
mon_panel:
    # Titre affiché dans l'interface d'administration
    title: "Titre du panel"

    # Description optionnelle qui apparaît sous le titre
    description: "Description détaillée des options de ce panel"

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

    # (Optionnel) Désactiver complètement le panel
    active: true

    # (Optionnel) Permission WordPress requise pour afficher ce panel
    capability: "edit_theme_options"

    # Sections du panel
    sections:
        # ID de la section (en snake_case)
        typographie:
            title: "Typographie"

            # Champs de configuration de la section
            fields:
                # ID de l'option (en snake_case)
                police_par_defaut:
                    # Libellé affiché dans l'interface
                    label: "Police par défaut"

                    # Type de champ (ici, un sélecteur de police)
                    type: "font"

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

Exemple complet

Voici un exemple concret de panel de personnalisation des couleurs :

couleurs_du_theme:
    title: "Couleurs du thème"
    description: "Personnalisez les couleurs principales de votre site"
    priority: 5
    sections:
        couleurs_base:
            title: "Couleurs de base"
            fields:
                couleur_primaire:
                    label: "Couleur principale"
                    type: "color_contrast"
                    default: "#007bff"

                couleur_secondaire:
                    label: "Couleur secondaire"
                    type: "color_contrast"
                    default: "#6c757d"

        typographie:
            title: "Typographie"
            fields:
                police_titres:
                    label: "Police des titres"
                    type: "font"
                    default: "'Roboto', sans-serif"

                police_texte:
                    label: "Police du texte"
                    type: "font"
                    default: "'Open Sans', sans-serif"

Bonnes pratiques

• Utilisez des identifiants en snake_case (ex: main_colors, header_settings)
• Utilisez des priorités avec des intervalles de 5 ou 10 pour faciliter l'insertion future de nouveaux panels
• Organisez logiquement les sections et les champs par catégorie
• Utilisez active: false pour masquer temporairement un panel sans supprimer sa configuration
• Utilisez capability pour restreindre l'accès à certains profils (ex: admin uniquement)