Twig
Twig is een flexibele, snelle en veilige template-engine voor PHP. Ontwikkelaars kunnen er beknopte, leesbare code in templates mee schrijven, wat de productiviteit en onderhoudbaarheid ten goede komt. Twig biedt allerlei functies die templates zowel krachtig als eenvoudig maken. Daardoor is het ideaal voor projecten die robuuste, herbruikbare templates nodig hebben.
Instellen
Om Twig-templates te gebruiken met Blockstudio, installeert u met Composer het pakket timber/timber (waar Twig bij inbegrepen is). Blockstudio detecteert automatisch of Timber is geïnstalleerd en schakelt Twig-templating in voor uw blokken.
composer require timber/timber
Zodra Timber is geïnstalleerd, zorgt Blockstudio automatisch voor het renderen van index.twig-bestanden in uw blokmappen.
Templatevariabelen
Alle bestanden Twig hebben toegang tot de context Timber, met algemene gegevens en functies voor WordPress, evenals variabelen die specifiek zijn voor Blockstudio:
| Variabele | Beschrijving |
|---|---|
a |
Een alias voor attributes |
attributes |
De attributen van het blok |
b |
Een alias voor block |
block |
Gegevens over het blok zelf (bevat postId, postType, context, enz.) |
c |
Een alias voor context |
context |
De context van het blok (e.g, postId, postType binnen een lus) |
isEditor |
Boolean, true als het blok in de editor wordt gerenderd |
isPreview |
Boolean, true als het blok in het voorbeeld van de invoeger wordt gerenderd |
Gebruik
Als u Twig wilt gebruiken voor de template van uw blok, maakt u eenvoudigweg een bestand index.twig aan in de map van uw blok. Blockstudio gebruikt dit bestand vervolgens automatisch om het blok te renderen.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>