Шаблони

Основний шаблон блока повинен бути знайдений для ключа 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: