Перейти к содержимому

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 будет автоматически использовать этот файл для отображения блока.

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

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