Treci la conținut

Twig

Twig este un motor de șabloane flexibil, rapid și sigur pentru PHP. Le permite dezvoltatorilor să scrie cod concis și ușor de citit în șabloane, sporind productivitatea și ușurința de întreținere. Twig oferă o varietate de funcționalități concepute pentru a face șabloanele atât puternice, cât și ușor de folosit, fiind ideal pentru proiectele care necesită șabloane robuste și reutilizabile.

Configurare

Pentru a folosi șabloane Twig cu Blockstudio, trebuie să instalați pachetul timber/timber (care include Twig) folosind Composer. Blockstudio va detecta automat dacă Timber este instalat și va activa șabloanele Twig pentru blocurile dumneavoastră.

Shell
composer require timber/timber

După instalarea Timber, Blockstudio va gestiona automat randarea fișierelor index.twig găsite în directoarele blocurilor.

Variabilele șablonului

Toate fișierele Twig vor avea acces la contextul Timber, care include date și funcții WordPress comune, precum și variabile specifice Blockstudio:

Variabilă Descriere
a Alias pentru attributes
attributes Atributele blocului
b Alias pentru block
block Date despre blocul propriu-zis (include postId, postType, context etc.)
c Alias pentru context
context Contextul blocului (e.g, postId, postType când se află într-o buclă)
isEditor Boolean, true dacă blocul este randat în editor
isPreview Boolean, true dacă blocul este randat în previzualizarea din inserter

Utilizare

Pentru a folosi Twig în șablonul blocului, creați pur și simplu un fișier index.twig în directorul blocului. Blockstudio va folosi apoi automat acest fișier pentru a randa blocul.

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

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