Hoppa till innehåll

Twig

Twig är en flexibel, snabb och säker mallmotor för PHP. Den låter utvecklare skriva koncis och lättläst kod i mallar, vilket ökar produktiviteten och underhållbarheten. Twig stöder en mängd funktioner som gör mallhantering både kraftfull och enkel, vilket gör den idealisk för projekt som kräver robusta, återanvändbara mallar.

Konfiguration

Om du vill använda Twig-mallar med Blockstudio installerar du paketet timber/timber (som innehåller Twig) med Composer. Blockstudio upptäcker automatiskt om Timber är installerat och aktiverar Twig-mallar för dina block.

Shell
composer require timber/timber

När Timber har installerats hanterar Blockstudio automatiskt renderingen av index.twig-filer i blockmapparna.

Mallvariabler

Alla Twig-filer har tillgång till kontexten Timber, som innehåller vanliga WordPress-data och funktioner samt variabler som är specifika för Blockstudio:

Variabel Beskrivning
a Ett alias för attributes
attributes Blockets attribut
b Ett alias för block
block Data som rör själva blocket (inkluderar postId, postType, context osv.)
c Ett alias för context
context Blockets kontext (e.g, postId, postType i en loop)
isEditor Boolesk, true om blocket renderas i redigeraren
isPreview Boolesk, true om blocket renderas i insättarens förhandsvisning

Användning

Om du vill använda Twig för blockmallen skapar du bara en index.twig-fil i blockets katalog. Blockstudio använder sedan automatiskt den här filen för att rendera blocket.

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

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