- Главная
- Документация
- Шаблоны страниц и секции
Шаблоны страниц и секции
У страницы есть два шаблона: макет — каркас вокруг содержимого: шапка, меню, подвал — и шаблон содержимого — то, что находится на странице. Оба являются XML-файлами. Страница также может хранить собственный XML, который переопределяет файл.
Выбор шаблонов страницы
В форме страницы в разделе «Управление структурой» есть два списка: «Содержимое страницы» и «Макет страницы». В них отображаются все шаблоны содержимого и макеты, слинкованные в web/templates/. Название шаблона в списке — это перевод строки интерфейса CONTENT_<FILE NAME> или LAYOUT_<FILE NAME>.
У страницы с собственным XML он отображается в форме как поле с кодом и кнопкой «Вернуть к начальному виду»; выбор другого шаблона содержимого сбрасывает собственный XML страницы при сохранении.
Шаблоны для посетителей
| Шаблон | Файл | Что находится на странице |
|---|---|---|
| «Лендинг» | main/landing.content.xml |
первый экран, услуги, отзывы, призыв к действию, контакты |
| «Услуга» | main/service.content.xml |
первый экран, собственный текст страницы, цены, вопросы и ответы, призыв к действию |
| «Контакты» | main/contacts.content.xml |
заголовок и текст страницы, контакты |
| «Текстовая страница» | textblock.content.xml |
заголовок и текст страницы |
| «Главная страница» | main.content.xml |
текст и боковая колонка с текстом, общим для всех страниц; используется на предустановленной главной странице |
| «Список подразделов» | childs.content.xml |
текст и список подстраниц текущей страницы |
| «Карта сайта» | map.content.xml |
дерево страниц сайта |
Для входа, регистрации, восстановления пароля, профиля и страниц панели управления предусмотрены собственные шаблоны; инсталлятор назначает их нужным страницам. Шаблоны сайта находятся в site/modules/main/templates/content/ и указываются как main/<name>.content.xml; шаблоны ядра — в core/modules/*/templates/.
Макеты: «Базовый» — главное меню, ссылка входа, переключатель языка, текст подвала и, для администраторов, панель управления; «Пустой» — без каркаса.
Секции
Секция — это часть страницы с собственным текстом и внешним видом; владелец редактирует её текст прямо на странице. В шаблоне секция представляет собой контейнер с атрибутом section и текстовым блоком внутри:
<container name="cta" section="cta">
<component name="section_cta" class="TextBlock">
<params><param name="section">cta</param></params>
</component>
</container>
class — короткое имя компонента: поиск выполняется сначала в модулях сайта, затем в модулях ядра; полное имя класса также поддерживается. section задаёт номер текстового блока и текст-рыбу секции. Номера зафиксированы в коде, и тексты хранятся в базе данных под этими номерами:
| Секция | Номер | Текст владельца | Внешний вид |
|---|---|---|---|
hero |
11 | h1, абзац, ссылка, изображение (необязательно) |
изображение становится затемнённым фоном, ссылка — кнопкой |
services |
12 | h2, список: strong и описание в каждом элементе |
элементы превращаются в карточки в сетке |
prices |
13 | h2, список тарифов: h3, цена отдельным абзацем, вложенный список, ссылка |
тарифы в виде колонок, ссылка — кнопкой |
reviews |
14 | h2, цитаты blockquote с p и cite |
цитаты в виде карточек |
gallery |
15 | h2, изображения |
сетка изображений 4:3 |
faq |
16 | h2, пары из h3 и абзаца либо details |
вопросы с разделителями |
contacts |
17 | h2, абзацы с адресом, ссылками tel:, mailto: и ссылками на карту |
колонки на широких экранах |
cta |
18 | h2, ссылка |
полоса акцентного цвета, ссылка — кнопкой |
На сайте секция выводится как полноширинный <section>, чей id равен имени секции, поэтому ссылка #contacts ведёт прямо к ней. Пустая секция не отображается на сайте — как посетителям, так и администраторам; в режиме редактирования в ней показывается текст-рыба из строки интерфейса TXT_SECTION_SAMPLE_<NAME>, готовый к замене.
Здесь нет форм обратной связи и прикреплённых к странице файлов: контакты оформляются ссылками, а галерея — изображениями в тексте.
Собственный шаблон
php index.php setup page --name=about --title="О компании" --sections=hero,services,reviews,cta
--name— строчные латинские буквы, цифры и_, начиная с буквы; становится именем файлаabout.content.xml.--title— название шаблона в списке на русском языке;--title-ua— на украинском языке (если опущено, используется русское).--sections— список через запятую из восьми имён секций, приведённых выше.
Команда создаёт site/modules/main/templates/content/<name>.content.xml с контейнером для каждой секции, добавляет CONTENT_<NAME> в site/modules/main/translations.php, загружает перевод в базу данных и запускает setup linker. Она откажется перезаписывать уже существующий файл или строку.
Вручную: поместите XML в site/modules/main/templates/content/, добавьте CONTENT_<NAME> в site/modules/main/translations.php, затем выполните php index.php setup translations и php index.php setup linker.
Компоненты и их конфигурация
Собственные компоненты сайта размещаются в site/modules/main/components/ (пространство имён EnergineSite\main\components), их конфигурационные файлы — в site/modules/main/config/. Конфиг может хранить только отличия от другого: <configuration extends="DivisionEditor.component.xml"> перенимает состояния базового конфига, состояние с тем же именем заменяет базовое на месте, новое добавляется в конец, а <state name="…" remove="1"/> удаляет состояние.