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

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

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

Форма сторінки в «Управление структурой» (Structure management) має два списки: «Содержимое страницы» (Page content) і «Макет страницы» (Page layout). Вони відображають усі шаблони вмісту та макетів, підключені до web/templates/. Назва шаблону в списку — це переклад рядка інтерфейсу CONTENT_<FILE NAME> або LAYOUT_<FILE NAME>.

Сторінка з власним XML відображає його у формі як поле з кодом із кнопкою «Вернуть к начальному виду» (Reset to original); вибір іншого шаблону вмісту скидає власний XML сторінки при збереженні.

Шаблони для відвідувачів

Шаблон Файл Що є на сторінці
«Лендинг» (Landing) main/landing.content.xml перший екран, послуги, відгуки, заклик до дії, контакти
«Услуга» (Service) main/service.content.xml перший екран, власний текст сторінки, ціни, питання і відповіді, заклик до дії
«Контакты» (Contacts) main/contacts.content.xml заголовок і текст сторінки, контакти
«Текстовая страница» (Text page) textblock.content.xml заголовок і текст сторінки
«Главная страница» (Home page) main.content.xml текст і бічна колонка зі спільним для всіх сторінок текстом; встановлена головна сторінка використовує його
«Список подразделов» (Subsection list) childs.content.xml текст і список підсторінок поточної сторінки
«Карта сайта» (Site map) map.content.xml дерево сторінок сайту

Сторінки входу, реєстрації, відновлення пароля, профілю та адміністрування мають власні шаблони; інсталятор призначає їх потрібним сторінкам. Шаблони сайту зберігаються в site/modules/main/templates/content/ і перелічуються як main/<name>.content.xml; шаблони ядра — в core/modules/*/templates/.

Макети: «Базовый» (Basic) — головне меню, посилання для входу, перемикач мови, текст підвалу і, для адміністраторів, панель адміністратора; «Пустой» (Empty) — без рамки.

Секції

Секція — це частина сторінки з власним текстом і власним виглядом; власник редагує її текст безпосередньо на сторінці. У шаблоні секція — це контейнер з атрибутом 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"/> видаляє стан.