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>