Twig
Twig je flexibilní, rychlý a bezpečný šablonovací engine pro PHP. Vývojářům umožňuje psát stručný a přehledný kód v šablonách, což zvyšuje produktivitu a usnadňuje údržbu. Twig podporuje řadu funkcí, díky nimž je šablonování výkonné a zároveň přímočaré. Je proto ideální pro projekty vyžadující robustní a opakovaně použitelné šablony.
Nastavení
Chcete-li používat šablony Twig s Blockstudio, nainstalujte pomocí Composer balíček timber/timber (který obsahuje Twig). Blockstudio automaticky zjistí, zda je nainstalován Timber, a povolí pro vaše bloky šablonování Twig.
composer require timber/timber
Po instalaci Timber se Blockstudio automaticky postará o vykreslování souborů index.twig nalezených ve složkách vašich bloků.
Proměnné šablony
Všechny soubory Twig budou mít přístup ke kontextu Timber, který zahrnuje běžná data a funkce WordPress i proměnné specifické pro Blockstudio:
| Proměnná | Popis |
|---|---|
a |
Alias pro attributes |
attributes |
Atributy bloku |
b |
Alias pro block |
block |
Data související se samotným blokem (zahrnují postId, postType, context atd.) |
c |
Alias pro context |
context |
Kontext bloku (např. e.g, postId, postType při použití ve smyčce) |
isEditor |
Logická hodnota: true, pokud se blok vykresluje v editoru |
isPreview |
Logická hodnota: true, pokud se blok vykresluje v náhledu vkládání |
Použití
Chcete-li pro šablonu bloku použít Twig, stačí vytvořit soubor index.twig v adresáři bloku. Blockstudio pak tento soubor automaticky použije k vykreslení bloku.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>