Méta langage : les variables personnalisées

19/10/2015 10:41

Il est possible de définir des variables dans le thème, qui seront saisies dans les options du thème.

Création d'une variable personnalisée

Les variables doivent être créés dans la partie "head" du thème. Il faut pour chaque option ajouter une balise meta avec les bons attributs, pour définir son nom, son type (text / liste déroulante / image..), sa valeur par défaut...

La syntaxe est :

Le groupe permet de regrouper les options dans différentes parties, afin de faciliter la lecture des options par les blogueurs.

Quelques exemples :

<!-- Saisie d'un texte -->
<meta name="string:google_analytics:Enter your Google Analytics ID" group="Settings" />

<!-- Une option pour avoir une image -->
<meta name="image:custom_background:Define your background image" group="design" />

<!-- Une option liste (pour une police) -->
<meta name="list:font_title:Choose your title font." items="Averia Sans Libre,Piedra" default="Piedra" group="design" />

<!-- Un booléan (oui/non) -->
<meta name="boolean:display_widget_profile:Hide Widget 'About me'" group="Widgets" />

<!-- Sélection d'un tag du blog -->
<meta name="tag:pinned_tag:Which tag use for pinned posts" group="Widgets" />

<!-- Sélection d'une couleur -->
<meta name="color:background_color:Background color" default="#333" group="Colors" />

Utilisation d'une variable personnalisée

La syntaxe est la suivante : {{ Custom('nomDeLaVariable') }}

Quelques exemples issus des variables définies dans l'exemple précédent :

<style>
    body {
        {% if Custom('custom_background') is not empty %}
        background-image: url({{ Custom('custom_background') }});
        {% endif %}
        background-color: {{ Custom('background_color'}};
    }
    h1 {
        font-family: {{ Custom('font_title') }}, cusrive;
    }
</style>

<p>Mon code pour Google analytics est {{ Custom('google_analytics') }}</p>

Un exemple d'option texte : "J'ai une option"

Note : il est important de vérifier l'existence d'une variable avant de l'utiliser.

Si cette variable personnalisée a une valeur par défaut, cela n'est pas obligatoire.