Twig
Twig — це гнучкий, швидкий і безпечний рушій шаблонів для PHP. Він дає змогу розробникам писати в шаблонах лаконічний і зрозумілий код, підвищуючи продуктивність і зручність супроводу. Twig підтримує низку функцій, що роблять роботу із шаблонами потужною та простою, ідеальною для проєктів, яким потрібні надійні шаблони для повторного використання.
Налаштування
Щоб використовувати шаблони Twig з Blockstudio, потрібно встановити пакет timber/timber (до якого входить Twig) за допомогою Composer. Blockstudio автоматично виявить, чи встановлено Timber, і ввімкне шаблони Twig для ваших блоків.
composer require timber/timber
Після встановлення Timber Blockstudio автоматично оброблятиме файли index.twig, знайдені в каталогах ваших блоків.
Змінні шаблонів
Усі файли Twig матимуть доступ до контексту Timber, який містить загальні дані й функції WordPress, а також змінні, специфічні для Blockstudio:
| Змінна | Опис |
|---|---|
a |
Псевдонім для attributes |
attributes |
Атрибути блоку |
b |
Псевдонім для block |
block |
Дані, пов’язані із самим блоком (містить postId, postType, context тощо) |
c |
Псевдонім для context |
context |
Контекст блоку (e.g, postId, postType під час циклу) |
isEditor |
Логічне значення: істина, якщо блок рендериться в редакторі |
isPreview |
Логічне значення: істина, якщо блок рендериться в попередньому перегляді вставника |
Використання
Щоб використовувати Twig для шаблону блоку, просто створіть файл index.twig у каталозі блоку. Після цього Blockstudio автоматично використовуватиме цей файл для рендерингу блоку.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>