Gå til indhold

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.

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

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

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