Шаблони сторінок

Кожна сторінка має два шаблони: макет — те, що оточує вміст, — і шаблон вмісту — те, що розміщено на цій сторінці. Обидва є XML-файлами, які розміщують компоненти у контейнерах. Сторінка також може зберігати власний XML замість файлу.

Де вони зберігаються

  • Модулі постачають шаблони у core/modules/<module>/templates/layout/*.layout.xml і …/templates/content/*.content.xml; власні шаблони сайту розміщуються у site/modules/main/templates/layout/ і …/content/.
  • Setup зв'язує їх з htdocs/templates/layout/ і htdocs/templates/content/: шаблони ядра — безпосередньо, шаблони сайту — у підпапку main/. Після додавання шаблону виконайте php index.php setup linker з каталогу htdocs/.
  • Сторінка зберігає шлях до файлу відносно цих папок: textblock.content.xml для шаблону ядра, main/users.content.xml — для шаблону сайту.

Макет і вміст разом

Кореневий елемент макету — <page>, шаблону вмісту — <content>. Якщо у макеті є порожній елемент <content/>, шаблон вмісту підставляється на його місце; інакше вміст іде слідом за макетом. Макет сторінок помилок містить такий заповнювач:

<page>
    <component name="langSwitcher" class="Energine\share\components\LangSwitcher"/>
    <content/>
    <component name="footerTextBlock" class="Energine\share\components\TextBlock">
        <params>
            <param name="num">footerTextBlock</param>
        </params>
    </component>
</page>

Всередині кореневого елемента:

  • <component name class> з <params> — див. Компоненти.
  • <container name …> групує блоки; усі його атрибути копіюються до XML сторінки. Таблиці стилів сайту зчитують html_class (CSS-класи), block="alfa" або block="beta" (рамка блоку; alfa — основний блок, показує заголовок сторінки, крім головної), column і widget (стовпці та блоки редактора блоків) і contains (відображає тут інший контейнер або компонент).
  • <translations><translation const="…"/></translations> — перелік рядків інтерфейсу, потрібних представленню; <javascript><behavior name="…"/></javascript> — скрипти.

Кореневий елемент шаблону вмісту може також мати атрибути: segment (фіксує сегмент адреси сторінки), layout (обирає макет), unique (одна така сторінка на весь сайт) і disabled (не пропонується у списку). robots.txt — саме така сторінка: robots_txt.content.xml модуля seo:

<content segment="robots.txt" layout="empty.layout.xml" unique="">
    <component name="robots" class="Energine\seo\components\Robots"/>
</content>

Вибір шаблонів сторінки

Форма сторінки у «Управление структурой» (Управління структурою, /admin/structure/) містить два списки: «Макет страницы» (Макет сторінки) і «Содержимое страницы» (Вміст сторінки). Вони відображають усі файли *.layout.xml або *.content.xml з htdocs/templates/…/ і підпапки main/ — або, якщо сайт має site/modules/main/templates/content.include (чи layout.include), лише файли, що відповідають рядкам цього файлу. Назва шаблону у списку — це переклад константи LAYOUT_<NAME> або CONTENT_<NAME>, наприклад CONTENT_TEXTBLOCK; шаблон без перекладу відображається за самою константою. Файл сайту з іменем файлу ядра замінює його у списку.

Власний XML сторінки

«Управление блоками» (Управління блоками) на панелі інструментів сторінки дозволяє переміщувати блоки сторінки та зберігати результат:

  • «Сохранить только для этой страницы» (Зберегти лише для цієї сторінки) — зберігає XML у самій сторінці;
  • «Сохранить в текущем шаблоне» (Зберегти у поточний шаблон) — копіює шаблон ядра до site/modules/main/templates/content/ і переключає кожну сторінку, що використовувала його, на копію;
  • «Вернуться к шаблону ядра» (Повернутися до шаблону ядра) і «Вернуть к начальному виду» (Повернути до початкового вигляду) скасовують ці дії.

Вибір іншого шаблону у формі сторінки скидає її власний XML.

Шаблони, що постачаються

Файл У списку На сторінці
default.layout.xml «Базовый» (Базовий) перемикач мови, банери, брендинг, текст підвалу та панель адміністратора
empty.layout.xml «Пустой» (Порожній) нічого навколо вмісту
main.content.xml «Главная страница» (Головна сторінка) три стовпці: головне меню, бічний текст, форма входу, текст і останні новини
textblock.content.xml «Текстовая страница» (Текстова сторінка) текст
media_textblock.content.xml «Текстовая страница с медиа-файлами» (Текстова сторінка з медіафайлами) тексти та медіафайли сторінки
childs.content.xml «Список подразделов» (Список підрозділів) підсторінки поточної сторінки
map.content.xml «Карта сайта» (Карта сайту) дерево сторінок
login, register, restore_password, user_profile «Авторизация» (Вхід), «Регистрация» (Реєстрація), «Восстановление пароля» (Відновлення пароля), «Профиль пользователя» (Профіль користувача) сторінки користувача
news.content.xml «Список новостей» (Список новин) новини
feedback_form.content.xml «Форма обратной связи» (Форма зворотного зв'язку) форма зворотного зв'язку

Сторінки модулів — магазину, блогів, форм, розсилок — постачаються з власними шаблонами; вони описані на сторінках документації відповідних модулів.