Шаблоны страниц и секции

У страницы есть два шаблона: макет — каркас вокруг содержимого: шапка, меню, подвал — и шаблон содержимого — то, что находится на странице. Оба являются 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"/> удаляет состояние.