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.
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.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>