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 |
Логическое значение: true, если блок отображается в редакторе |
isPreview |
Логическое значение: true, если блок отображается в предварительном просмотре во вставщике |
Использование
Чтобы использовать 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>