Aller au contenu principal
Version: 0.7.3

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)