Aller au contenu

Twig

Twig est un moteur de modèles flexible, rapide et sécurisé pour PHP. Il permet aux développeurs d’écrire du code concis et lisible dans les modèles, améliorant ainsi la productivité et la maintenabilité. Twig propose diverses fonctionnalités conçues pour rendre la création de modèles à la fois puissante et simple, ce qui en fait un choix idéal pour les projets nécessitant des modèles robustes et réutilisables.

Configuration

Pour utiliser les modèles Twig avec Blockstudio, installez le package timber/timber (qui inclut Twig) avec Composer. Blockstudio détectera automatiquement si Timber est installé et activera la prise en charge des modèles Twig pour vos blocs.

Shell
composer require timber/timber

Une fois Timber installé, Blockstudio se chargera automatiquement du rendu des fichiers index.twig présents dans les dossiers de vos blocs.

Variables de modèle

Tous les fichiers Twig auront accès au contexte Timber, qui comprend les données et fonctions courantes de WordPress, ainsi que les variables propres à Blockstudio :

Variable Description
a Alias de attributes
attributes Attributs du bloc
b Alias de block
block Données liées au bloc lui-même (y compris postId, postType, context, etc.)
c Alias de context
context Contexte du bloc (e.g., postId, postType dans une boucle)
isEditor Booléen, vrai si le bloc est rendu dans l’éditeur
isPreview Booléen, vrai si le bloc est rendu dans l’aperçu de l’outil d’insertion

Utilisation

Pour utiliser Twig comme modèle de votre bloc, créez simplement un fichier index.twig dans le répertoire du bloc. Blockstudio utilisera alors automatiquement ce fichier pour générer le bloc.

Twig
<div class="my-block">
  {% if a.title %}
    <h2>{{ a.title }}</h2>
  {% endif %}

  {% if a.content %}
    <p>{{ a.content }}</p>
  {% endif %}
</div>