Ga naar de inhoud

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.

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

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

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