Twig
Twig je prilagodljiv, hiter in varen mehanizem za predloge za PHP. Razvijalcem omogoča pisanje jedrnate in berljive kode v predlogah, kar poveča produktivnost in olajša vzdrževanje. Twig podpira številne funkcije, zaradi katerih so predloge zmogljive in preproste za uporabo, zato je idealen za projekte, ki potrebujejo zanesljive predloge za ponovno uporabo.
Nastavitev
Če želite uporabljati predloge Twig z Blockstudio, morate z Composer namestiti paket timber/timber (ki vključuje Twig). Blockstudio bo samodejno zaznal, ali je Timber nameščen, in za vaše bloke omogočil predloge Twig.
composer require timber/timber
Ko je Timber nameščen, bo Blockstudio samodejno poskrbel za izris datotek index.twig, ki jih najde v mapah blokov.
Spremenljivke predlog
Vse datoteke Twig imajo dostop do konteksta Timber, ki vključuje pogoste podatke in funkcije WordPress ter spremenljivke, značilne za Blockstudio:
| Spremenljivka | Opis |
|---|---|
a |
Vzdevek za attributes |
attributes |
Atributi bloka |
b |
Vzdevek za block |
block |
Podatki, povezani s samim blokom (vključujejo postId, postType, context itd.) |
c |
Vzdevek za context |
context |
Kontekst bloka (e.g, postId, postType znotraj zanke) |
isEditor |
Logična vrednost, true, če se blok izrisuje v urejevalniku |
isPreview |
Logična vrednost, true, če se blok izrisuje v predogledu vstavljalnika |
Uporaba
Če želite za predlogo bloka uporabiti Twig, preprosto ustvarite datoteko index.twig v imeniku bloka. Blockstudio bo to datoteko nato samodejno uporabil za izris bloka.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>