Основний шаблон блока повинен бути знайдений для ключа owner
. Крім нього, масив повинен містити шаблони для кожної групи полів, і може містити шаблони для полів, які мають властивість elements
(це поля типу dropdown
, checkbox
, radio
). У таких шаблонах доступні вибрані значення властивості elements
.
Наприклад, якщо у масиві полів використовується група images
, то в шаблонах має бути визначений елемент із ключем images
, який буде містити або рядок шаблону:
'images' => '<img src="" alt="" class="slide">'
або асоціативний масив шаблонів:
'images' => [
'item' => '<img src="" alt="" class="slide">',
'thumb' => '<div class="thumb" style="background-image: url()"></div>',
],
У другому випадку виведення цих елементів у батьківському шаблоні можна використовувати як і
.
Як плейсхолдери можуть використовуватися імена полів (наприклад ), імена групових полів (наприклад
,
).
У шаблонах для полів вибору dropdown
, checkbox
, radio
доступні плейсхолдери і
.
Також у шаблоні 'owner' доступні плейсхолдери і
, а в групових полях та полях вибору -
і
.
Розмітку можна вказати у самому значенні масиву, як показано у прикладах вище.
Можлива вказівка імені чанка, у якому знаходиться потрібний шаблон. Для цього потрібно використати прив'язку @CHUNK
, наприклад:
'checkbox' => '@CHUNK all_fields_checkboxes',
Також можливе підвантаження шаблону з файлу, наприклад:
'owner' => '@FILE pagebuilder/all_fields.tpl',
У цьому прикладі файл шаблону буде завантажено з MODX_BASE_PATH . "assets/templates/pagebuilder/all_fields.tpl"
. Взагалі файл шукається в наступних каталогах:
assets/tvs/
assets/chunks/
assets/templates/
Або можна вказати повний шлях від кореня сайту. Перший слеш не вказується.
Шаблони можна групувати, щоб під час виводу використовувати різні групи шаблонів з параметром &templates
. Наприклад, якщо вказати наступну конфігурацію блоку:
'templates' => [
'owner' => '@CHUNK full_owner',
'images' => '@CHUNK full_images'
'anchors' => [
'owner' => '@CHUNK link_owner',
],
],
то виклик сніпета з параметром &templates
, рівним anchors
, буде використовувати для виведення шаблони, які визначені в групі anchors
: