Шаблони та мітки

Мінімальний HTML-шаблон

Звичайний файл усередині вибраної папки design може містити doctype, html, head і body. У title вставте [#title#], у meta description — [#description#], а в основній частині — [#H1#], [#breadcrumbs#] та [#content#]. Для ресурсів використовуйте шлях від кореня сайту, наприклад /design/my-site/css/style.css, щоб CSS працював і на вкладених сторінках. PHP усередині HTML-файлу не виконується.

Сканер знаходить звичайні мітки формату [#name#] автоматично. Назва має починатися з латинської літери й може містити літери, цифри, підкреслення, дефіс та крапку; максимум — 100 символів. Після редагування файла знову відкрийте сторінку в адмінпанелі: вона перечитає список міток. Системні title, description, keywords, H1, home_link, lang_menu, page_header_media і breadcrumbs заповнюються ядром.

Вибір джерела мітки

Для звичайної мітки доступні успадкування від батьківської сторінки, вимкнення, візуальний редактор, HTML-код або активний екземпляр модуля. Після вибору текстового режиму праворуч з'являється кнопка відповідного редактора. Для модуля вона відкриває саме вибраний екземпляр. У режимах успадкування та вимкнення кнопки немає.

Візуальний редактор використовуйте для звичайного контенту. HTML-код — для блоку, зовнішній вигляд якого залежить від точної вкладеності та CSS-класів. HTML-режим не перетворює розмітку під час відкриття, перемикання мови чи збереження, але серверний фільтр залишає лише безпечні семантичні елементи й прибирає виконуваний код.

Змінні та іменовані секції

Усередині шаблону модуля змінні мають вигляд %name%; їхній набір залежить від модуля й показується під редактором його файла. Поточний шар сумісності підставляє значення як HTML: не використовуйте неперевірені дані без урахування контексту всередині JavaScript, CSS чи HTML-атрибутів.

Секції починаються коментарем ,  тощо. Повторювані блоки й соціальні кнопки використовують wrapper та item; галерея — content або wrapper і rows або item; слайдер — content і rows або item; меню — item. У пункті меню доступні %id%, %url% або %link%, %title% або %text%, а %children% вставляє готове підменю.

Навігаційний ланцюжок і мови

Для крихт передбачені секції begin, link/item, activelink/current, delimiter та end. Доступні %id%, %position%, %link%, %url%, %text% і %title%. У розмітці Schema.org BreadcrumbList кожен пункт — окремий контейнер ListItem з itemprop=itemListElement, усередині якого посилання має itemprop=item. Лише в останньому пункті посилання item може бути відсутнім. Не переносіть itemListElement на саме посилання.

Мовні значення заповнюються в адмінпанелі; дизайн зазвичай має один спільний HTML-файл. Завантажувач шаблонів ядра підтримує мовні суфікси для окремих статичних варіантів, але публічний сайт у поточній реалізації вибирає HTML-файл зі структури сторінок і підставляє мовні значення. Рендеринг міток відбувається у два проходи, тому системна мітка всередині результату модуля також замінюється. Не створюйте циклічних посилань між мітками.

Шаблони сайту

HTML-файли вибраного дизайну визначають розмітку сторінок. PHP-код у цих файлах не виконується. Замість статичних значень використовуйте системні мітки, наприклад [#title#], [#description#], [#H1#], [#breadcrumbs#] та [#content#]. Шаблон призначається сторінці в її редакторі.

Прив'язка міток

В адмінпанелі для мітки сторінки можна вибрати успадковане значення, вимкнути виведення, ввести текст у візуальному редакторі чи HTML або підключити активний екземпляр модуля. Зміна файлового шаблону не видаляє збережені значення міток.

Мітка сторінки [#name#] і змінна модульного шаблону %name% — різні механізми. Перша вставляє результат у сторінку, друга заповнюється під час рендерингу конкретного модуля. Вміст змінних потрібно використовувати у відповідному HTML-контексті; не вставляйте неперевірені значення прямо у JavaScript чи CSS.

Секції модульного шаблону

Секції позначаються HTML-коментарями:  задає загальну обгортку,  — один повторюваний елемент. У меню можуть використовуватися %id%, %url%, %title% та %children%. Для навігаційного ланцюжка є окремі секції початку, посилання, активного пункту, роздільника й завершення.

Значення мультимовних полів заповнюються в мовних вкладках адмінпанелі, тоді як файловий шаблон може бути спільним. Перевіряйте результат для кожної активної мови та для сторінок із різною глибиною URL.