Перейти до вмісту

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

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

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