Към съдържанието

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>