Preskočiť na obsah

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.

Shell
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.

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

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