Twig
Twig er en fleksibel, hurtig og sikker skabelonmotor til PHP. Den lader udviklere skrive kortfattet og læsbar kode i skabeloner, hvilket øger produktiviteten og gør koden lettere at vedligeholde. Twig understøtter en række funktioner, der gør skabeloner både effektive og enkle at bruge, og er ideel til projekter, der kræver robuste skabeloner, som kan genbruges.
Opsætning
Hvis du vil bruge Twig-skabeloner med Blockstudio, skal du installere pakken timber/timber (som indeholder Twig) med Composer. Blockstudio registrerer automatisk, om Timber er installeret, og aktiverer Twig-skabeloner til dine blokke.
composer require timber/timber
Når Timber er installeret, håndterer Blockstudio automatisk gengivelsen af index.twig-filer i dine blokmapper.
Skabelonvariabler
Alle Twig-filer har adgang til konteksten Timber, som omfatter almindelige WordPress-data og -funktioner samt Blockstudio-specifikke variabler:
| Variabel | Beskrivelse |
|---|---|
a |
Et alias for attributes |
attributes |
Blokkens attributter |
b |
Et alias for block |
block |
Data relateret til selve blokken (omfatter postId, postType, context osv.) |
c |
Et alias for context |
context |
Blokkens kontekst (e.g, postId, postType i en løkke) |
isEditor |
Boolesk værdi, true hvis blokken gengives i editoren |
isPreview |
Boolesk værdi, true hvis blokken gengives i indsætterens forhåndsvisning |
Brug
Hvis du vil bruge Twig til din blokskabelon, skal du blot oprette en index.twig-fil i blokkens mappe. Blockstudio bruger derefter automatisk denne fil til at gengive blokken.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>