- Головна
- Документація
- Шаблони сторінок і секції
Шаблони сторінок і секції
Сторінка має два шаблони: макет — рамка навколо вмісту: шапка, меню, підвал — і шаблон вмісту — те, що відображається на сторінці. Обидва є 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"/> видаляє стан.