- Головна
- Документація
- Шаблони сторінок
Шаблони сторінок
Кожна сторінка має два шаблони: макет — те, що оточує вміст, — і шаблон вмісту — те, що розміщено на цій сторінці. Обидва є 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 |
«Форма обратной связи» (Форма зворотного зв'язку) | форма зворотного зв'язку |
Сторінки модулів — магазину, блогів, форм, розсилок — постачаються з власними шаблонами; вони описані на сторінках документації відповідних модулів.