Twig
Twig je flexibilný, rýchly a bezpečný šablónovací nástroj pre PHP. Vývojárom umožňuje písať stručný a čitateľný kód v šablónach, čím zvyšuje produktivitu a uľahčuje údržbu. Twig podporuje množstvo funkcií, vďaka ktorým je tvorba šablón výkonná a zároveň jednoduchá, takže je ideálny pre projekty vyžadujúce robustné a opakovane použiteľné šablóny.
Nastavenie
Ak chcete používať šablóny Twig s Blockstudio, nainštalujte pomocou Composer balík timber/timber, ktorý obsahuje Twig. Blockstudio automaticky zistí, či je nainštalovaný Timber, a povolí šablónovanie Twig pre vaše bloky.
composer require timber/timber
Po nainštalovaní Timber sa Blockstudio automaticky postará o vykresľovanie súborov index.twig, ktoré sa nachádzajú v priečinkoch vašich blokov.
Premenné šablóny
Všetky súbory Twig budú mať prístup ku kontextu Timber, ktorý zahŕňa bežné údaje a funkcie WordPress, ako aj premenné špecifické pre Blockstudio:
| Premenná | Opis |
|---|---|
a |
Alias pre attributes |
attributes |
Atribúty bloku |
b |
Alias pre block |
block |
Údaje súvisiace so samotným blokom (zahŕňajú postId, postType, context atď.) |
c |
Alias pre context |
context |
Kontext bloku (e.g, postId, postType v cykle) |
isEditor |
Logická hodnota: true, ak sa blok vykresľuje v editore |
isPreview |
Logická hodnota: true, ak sa blok vykresľuje v náhľade vkladania |
Použitie
Ak chcete použiť Twig pre šablónu bloku, jednoducho vytvorte súbor index.twig v adresári bloku. Blockstudio potom tento súbor automaticky použije na vykreslenie bloku.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>