Twig
Twig yra lankstus, greitas ir saugus šablonų variklis, skirtas PHP. Jis leidžia kūrėjams rašyti glaustą ir lengvai skaitomą šablonų kodą, didinant produktyvumą ir palengvinant priežiūrą. Twig palaiko įvairias funkcijas, kurios šablonų kūrimą daro galingą ir paprastą, todėl puikiai tinka projektams, kuriems reikia patikimų, pakartotinai naudojamų šablonų.
Nustatymas
Norėdami naudoti Twig šablonus su Blockstudio, įdiekite paketą timber/timber (į kurį įeina Twig) naudodami Composer. Blockstudio automatiškai aptiks, ar įdiegtas Timber, ir įjungs jūsų blokų Twig šablonus.
composer require timber/timber
Įdiegus Timber, Blockstudio automatiškai atvaizduos index.twig failus, rastus jūsų blokų aplankuose.
Šablonų kintamieji
Visi Twig failai galės pasiekti Timber kontekstą, kuriame yra bendri WordPress duomenys ir funkcijos, taip pat tik Blockstudio būdingi kintamieji:
| Kintamasis | Aprašymas |
|---|---|
a |
attributes pseudonimas |
attributes |
Bloko atributai |
b |
block pseudonimas |
block |
Su pačiu bloku susiję duomenys (įskaitant postId, postType, context ir kt.) |
c |
context pseudonimas |
context |
Bloko kontekstas (e.g., postId, postType ciklo metu) |
isEditor |
Loginė reikšmė: true, jei blokas atvaizduojamas redaktoriuje |
isPreview |
Loginė reikšmė: true, jei blokas atvaizduojamas įterpimo peržiūroje |
Naudojimas
Norėdami naudoti Twig bloko šablonui, tiesiog sukurkite index.twig failą bloko kataloge. Tada Blockstudio automatiškai naudos šį failą blokui atvaizduoti.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>