Lewati ke konten

Twig

Twig adalah mesin templat yang fleksibel, cepat, dan aman untuk PHP. Mesin ini memungkinkan pengembang menulis kode yang ringkas dan mudah dibaca dalam templat, sehingga meningkatkan produktivitas dan kemudahan pemeliharaan. Twig mendukung berbagai fitur yang membuat templating andal sekaligus mudah digunakan, sehingga ideal untuk proyek yang membutuhkan templat tangguh dan dapat digunakan kembali.

Penyiapan

Untuk menggunakan templat Twig dengan Blockstudio, instal paket timber/timber (yang menyertakan Twig) menggunakan Composer. Blockstudio akan otomatis mendeteksi apakah Timber terinstal dan mengaktifkan templating Twig untuk blok Anda.

Shell
composer require timber/timber

Setelah Timber terinstal, Blockstudio akan otomatis menangani perenderan file index.twig yang ditemukan di folder blok Anda.

Variabel Templat

Semua file Twig dapat mengakses konteks Timber, yang mencakup data dan fungsi WordPress umum, serta variabel khusus Blockstudio:

Variabel Deskripsi
a Alias untuk attributes
attributes Atribut blok
b Alias untuk block
block Data yang berkaitan dengan blok itu sendiri (termasuk postId, postType, context, dll.)
c Alias untuk context
context Konteks blok (e.g., postId, postType saat berada dalam loop)
isEditor Boolean, bernilai true jika blok dirender di editor
isPreview Boolean, bernilai true jika blok dirender dalam pratinjau inserter

Penggunaan

Untuk menggunakan Twig sebagai templat blok, cukup buat file index.twig di direktori blok Anda. Blockstudio kemudian akan otomatis menggunakan file ini untuk merender blok.

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

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