Přejít k obsahu

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.

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

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

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