Twig
Twig este un motor de șabloane flexibil, rapid și sigur pentru PHP. Le permite dezvoltatorilor să scrie cod concis și ușor de citit în șabloane, sporind productivitatea și ușurința de întreținere. Twig oferă o varietate de funcționalități concepute pentru a face șabloanele atât puternice, cât și ușor de folosit, fiind ideal pentru proiectele care necesită șabloane robuste și reutilizabile.
Configurare
Pentru a folosi șabloane Twig cu Blockstudio, trebuie să instalați pachetul timber/timber (care include Twig) folosind Composer. Blockstudio va detecta automat dacă Timber este instalat și va activa șabloanele Twig pentru blocurile dumneavoastră.
composer require timber/timber
După instalarea Timber, Blockstudio va gestiona automat randarea fișierelor index.twig găsite în directoarele blocurilor.
Variabilele șablonului
Toate fișierele Twig vor avea acces la contextul Timber, care include date și funcții WordPress comune, precum și variabile specifice Blockstudio:
| Variabilă | Descriere |
|---|---|
a |
Alias pentru attributes |
attributes |
Atributele blocului |
b |
Alias pentru block |
block |
Date despre blocul propriu-zis (include postId, postType, context etc.) |
c |
Alias pentru context |
context |
Contextul blocului (e.g, postId, postType când se află într-o buclă) |
isEditor |
Boolean, true dacă blocul este randat în editor |
isPreview |
Boolean, true dacă blocul este randat în previzualizarea din inserter |
Utilizare
Pentru a folosi Twig în șablonul blocului, creați pur și simplu un fișier index.twig în directorul blocului. Blockstudio va folosi apoi automat acest fișier pentru a randa blocul.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>