Aller au contenu principal
Version: 0.6.0

Créer une option

Chaque option ont besoins de plusieurs clés pour être configuré.
On retrouve notamment les clés suivantes :

  • label : Titre de l'option.
  • type : Type de l'option.
  • default : Valeur par défaut de l'option (optionnel).
  • selector : Sélecteur CSS de l'option pour afficher la position dans le thème (optionnel).
  • registration_type : Enregistrement en tant qu'option général ou option du thème (optionnel).

Certaines options peuvent avoir des options spécifiques, comme legacy ou exclude pour les options de type post.

attention

Les options sont obligatoirement à définir dans une section dans la clé fields.

Exemple

fields: # Liste des champs de la section
    url: # ID de l'option
        label: "Logo"
        type: "image"
        default: "https://via.placeholder.com/150"
        selector: ".logo"
        registration_type: "option"

    post: # ID de l'option
        label: "Article/Bien immobillier"
        type: "post"
        args:
            exclude:
                - attachment
                - page
remarque

registration_type permet de choisir entre option et theme_mod. A savoir que option permet d'enregistrer la valeur dans la table wp_options directement avec sa propre clé. L'objectif est de persister la donnée entre les thèmes. Alors que theme_mod permet de lié la valeur au thème actif car elle se stock dans theme_mods_{slug du thème}.