Pāriet uz saturu

Twig

Twig ir elastīgs, ātrs un drošs veidņu dzinis PHP. Tas ļauj izstrādātājiem rakstīt īsu un viegli lasāmu kodu veidnēs, uzlabojot produktivitāti un uzturējamību. Twig atbalsta dažādas funkcijas, kas veidņu izveidi padara gan jaudīgu, gan vienkāršu, tāpēc tas ir ideāli piemērots projektiem, kam vajadzīgas uzticamas un atkārtoti lietojamas veidnes.

Iestatīšana

Lai izmantotu Twig veidnes ar Blockstudio, instalējiet pakotni timber/timber (kurā iekļauts Twig), izmantojot Composer. Blockstudio automātiski noteiks, vai Timber ir instalēts, un iespējos jūsu blokiem Twig veidņu atbalstu.

Apvalks
composer require timber/timber

Kad Timber ir instalēts, Blockstudio automātiski renderēs index.twig failus, kas atrodas jūsu bloku mapēs.

Veidņu mainīgie

Visiem Twig failiem būs pieejams konteksts Timber, kurā ietilpst bieži izmantoti WordPress dati un funkcijas, kā arī Blockstudio specifiski mainīgie:

Mainīgais Apraksts
a attributes aizstājvārds
attributes Bloka atribūti
b block aizstājvārds
block Ar pašu bloku saistītie dati (ietver postId, postType, context u. c.)
c context aizstājvārds
context Bloka konteksts (e.g, postId un postType, ja tas atrodas ciklā)
isEditor Loģiska vērtība: true, ja bloks tiek renderēts redaktorā
isPreview Loģiska vērtība: true, ja bloks tiek renderēts ievietotāja priekšskatījumā

Lietošana

Lai izmantotu Twig bloka veidnei, vienkārši izveidojiet failu index.twig bloka direktorijā. Pēc tam Blockstudio automātiski izmantos šo failu bloka renderēšanai.

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

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