- Скачиваем готовые файлы Creative
- Загружаем файлы оформления в каталог сайта
- Переносим HTML в начальный шаблон MODX
- Назначаем шаблон главной странице
- Подключаем первый экран
- Сначала проверяем вывод заголовка
- Заполняем описание и создаем поле кнопки
- Выносим первый экран в чанк
- Подключаем вторую секцию About
- Создаем поля и заполняем содержание
- Выносим About в чанк
- Заменяем исходную секцию вызовом чанка
- Удаляем демонстрационный блок загрузки
- Оставляем карточки, портфолио и форму следующим урокам
- Проверяем результат
- Что делать, если результат отличается
- Не загрузились стили или изображения
- Дополнительное поле не появилось или выводится пустым
- Секция появилась дважды
- Страница не меняется после сохранения
- Следующий шаг
Подключим готовый одностраничник к MODX Revolution: разместим файлы оформления, перенесем HTML в шаблон и проверим страницу в браузере. Затем сделаем содержание первых двух секций редактируемым через админку.
Для учебной практики используем бесплатный шаблон Creative от Start Bootstrap. В этом уроке подключим первый экран и секцию About. Карточки At Your Service, портфолио и контактную форму оставим следующим упражнениям.
Работаем через админку MODX. Ресурсы, шаблоны, чанки и стандартные теги мы уже разобрали — теперь применяем их к готовому оформлению. Ace установлен и настроен в предыдущем уроке. pdoTools и Fenom для этой работы не требуются.
Скачиваем готовые файлы Creative
Откройте страницу Creative и скачайте бесплатный комплект шаблона.

Распакуйте архив на компьютере. Найдите каталог, в котором рядом находятся index.html и папки assets, css, js. Это готовая версия оформления, с которой будем работать.

Если скачали весь репозиторий с GitHub, готовая версия находится в dist. Каталоги src, scripts и файлы сборки для этого урока не нужны. Устанавливать Node.js и запускать сборку не требуется.
index.html
assets/
favicon.ico
img/
css/
styles.css
js/
scripts.js
В показанном комплекте стили подключаются из css/styles.css, основной скрипт оформления — из js/scripts.js, изображения — из assets/img. Часть библиотек и шрифтов подключается по внешним адресам.
Используйте HTML, CSS, JavaScript и изображения из одного архива. Не смешивайте код разных выпусков Creative: классы, зависимости и пути могут отличаться.
Перед переносом откройте исходный index.html в браузере. Проверьте внешний вид, переходы по меню и открытие изображений портфолио. Если оформление уже здесь работает неправильно, сначала выясните причину.
Загружаем файлы оформления в каталог сайта
Откройте корневой каталог учебного сайта — тот, где находится index.php MODX. При локальной разработке используйте файловый менеджер компьютера, при работе с хостингом — файловый менеджер панели или программу передачи файлов.
Скопируйте из готового комплекта Creative три папки:
assets— изображения и значок сайта.css— готовые стили.js— JavaScript оформления.
Копируем сами папки, а не весь внешний каталог архива и не папку dist целиком. После загрузки структура должна выглядеть примерно так:
корень сайта/
assets/
img/
favicon.ico
...
core/
css/
styles.css
js/
scripts.js
manager/
index.php
...
В обычной установке MODX каталог assets уже существует. Объедините содержимое, не удаляя его целиком: внутри могут находиться файлы установленных дополнений.

Если в существующих папках css или js есть одноименные файлы, перед заменой сохраните их отдельно. На работающем сайте сначала выполняйте перенос на копии.
Проверьте вложенность: файл стилей должен находиться по пути css/styles.css, а не dist/css/styles.css или css/css/styles.css.
В этом уроке сохраняем структуру готового комплекта Creative, чтобы не переписывать пути. Оформление можно разместить и в отдельном каталоге, но тогда потребуется проверить адреса в HTML, CSS и JavaScript.
Сам index.html в корень установки MODX не загружаем. Иначе сервер может открыть его вместо index.php, и вы увидите статичную страницу в обход CMS. HTML пока остается на компьютере как источник кода.
Переносим HTML в начальный шаблон MODX
Откройте index.html из готового комплекта Creative в текстовом редакторе или редакторе кода.
Скопируйте весь исходный код страницы: от <!DOCTYPE html> до закрывающего </html>. Не копируйте текст выделением на странице браузера — нам нужна HTML-разметка.
В админке MODX перейдите на вкладку «Элементы», откройте «Шаблоны» и выберите начальный шаблон учебного сайта.

Сохраните его прежний код отдельно, чтобы при необходимости можно было восстановить исходный вариант. Затем замените содержимое кодом из index.html и нажмите «Сохранить».

Для этой учебной установки используем существующий начальный шаблон. Создавать еще один только ради названия Creative не требуется.
Если подсветка кода не появилась, вернитесь к проверке и настройке Ace. Сам пакет повторно устанавливать не нужно.
На работающем сайте нельзя без проверки заменять код общего шаблона: изменения затронут все ресурсы, которым он назначен.
Назначаем шаблон главной странице
Перейдите на вкладку «Ресурсы» и откройте главную страницу учебного сайта.
- Найдите поле «Шаблон».
- Выберите начальный шаблон, в который вставили Creative.
- Сохраните ресурс.
- Откройте корневой адрес сайта в браузере.
Если неясно, какой ресурс является главной страницей, проверьте фактическое значение системной настройки site_start. Она содержит ID стартового ресурса.
В браузере должно появиться оформление Creative: первый экран с фоновым изображением, секции страницы, портфолио и контактный блок.

Сравните результат с исходным index.html из того же архива. Проверьте:
- Применились стили и загрузился фон первого экрана.
- Отображаются изображения портфолио.
- Ссылки меню переходят к секциям страницы.
- На узком экране открывается мобильное меню.
- Изображения портфолио открываются в увеличенном виде.
Пока оформление статичное. Меню уже может прокручивать страницу, а изображения — открываться в просмотрщике. Это работа исходных HTML и JavaScript. Теперь подключим содержание первых двух секций к MODX.
Подключаем первый экран
У первого экрана сделаем редактируемыми три значения: заголовок, описание и подпись кнопки. Фоновое изображение и оформление пока оставим в CSS.
| Содержание | Где храним |
|---|---|
| Заголовок | Стандартное поле pagetitle |
| Описание под заголовком | Стандартное поле introtext |
| Подпись кнопки | TV hero_button_text |
Сначала проверяем вывод заголовка
Вернитесь к коду начального шаблона. Найдите header с классом masthead. Внутри находится заголовок первого экрана:
<h1 class="text-white font-weight-bold">Your Favorite Place for Free Bootstrap Themes</h1>
Замените демонстрационный текст выводом поля ресурса, сохранив атрибуты:
<h1 class="text-white font-weight-bold">[[*pagetitle:htmlent]]</h1>
Сохраните шаблон. Затем откройте главную страницу в дереве ресурсов, измените основной заголовок, например на «Учебный сайт на MODX», сохраните ресурс и нажмите «Посмотреть».

Вместо английского заголовка должен появиться введенный текст. Описание и кнопка на этом промежуточном этапе еще остаются прежними.

Если заголовок меняется через ресурс, связь работает. Продолжаем подключение первого экрана.
Заполняем описание и создаем поле кнопки
У главной страницы найдите поле «Аннотация» и заполните его:
Подключаем готовую верстку и учимся управлять содержанием сайта через админку.
Сохраните ресурс. Это значение будем выводить через [[*introtext]].
Для подписи кнопки создайте TV:
- Перейдите на вкладку «Элементы» и откройте раздел дополнительных полей TV.
- Создайте новое поле с именем
hero_button_text. - В заголовке поля укажите «Первый экран: текст кнопки».
- Выберите тип ввода «Текст».
- На вкладке доступа для шаблонов отметьте начальный шаблон, который используется у главной страницы.
- Сохраните TV.
Заново откройте главную страницу. На вкладке дополнительных полей заполните hero_button_text значением «Подробнее» и сохраните ресурс.
Если поле не появилось, проверьте его привязку к шаблону. Создание и назначение TV подробно разобрано в уроке дополнительных полей.
Выносим первый экран в чанк
Чтобы не искать разметку первого экрана среди всего HTML, вынесем ее в отдельный чанк.
На вкладке «Элементы» создайте чанк с именем creative.hero. Вставьте в него:
<header class="masthead">
<div class="container px-4 px-lg-5 h-100">
<div class="row gx-4 gx-lg-5 h-100 align-items-center justify-content-center text-center">
<div class="col-lg-8 align-self-end">
<h1 class="text-white font-weight-bold">[[*pagetitle:htmlent]]</h1>
<hr class="divider" />
</div>
<div class="col-lg-8 align-self-baseline">
<p class="text-white-75 mb-5">[[*introtext:htmlent]]</p>
<a class="btn btn-primary btn-xl" href="#about">[[*hero_button_text:htmlent]]</a>
</div>
</div>
</div>
</header>
Сохраните чанк.

Теперь откройте начальный шаблон. Найдите первый экран от <header class="masthead"> до соответствующего </header> и замените весь блок одним вызовом:
[[$creative.hero]]
Не добавляйте вызов рядом со старой разметкой, иначе первый экран появится дважды. Навигацию перед ним и секцию About после него оставьте на месте.
Сохраните шаблон и обновите сайт. На первом экране должны отображаться заголовок и аннотация ресурса, а на кнопке — текст «Подробнее».

Все три значения выводим как текст, поэтому используем модификатор htmlent. Ссылка кнопки остается #about: она ведет к следующей секции этого же одностраничника.
Подключаем вторую секцию About
Следом за первым экраном находится цветная секция с id="about". Подключим ее заголовок, основной текст и подпись кнопки.
| Содержание | Где храним |
|---|---|
| Заголовок секции | TV about_title |
| Основной текст | Стандартное поле content |
| Подпись кнопки | TV about_button_text |
Создаем поля и заполняем содержание
По тому же порядку создайте еще два TV с текстовым типом ввода:
about_title— заголовок поля «О проекте: заголовок».about_button_text— заголовок поля «О проекте: текст кнопки».
Оба поля привяжите к начальному шаблону. Значения по умолчанию пока не задавайте — содержание заполним непосредственно у главной страницы.
Заново откройте главную страницу и заполните дополнительные поля:
about_title:От готовой верстки к управляемому сайту.about_button_text:Наши услуги.
Теперь у ресурса должны быть заполнены все три созданных TV: подпись кнопки первого экрана, заголовок About и подпись его кнопки.

В стандартное поле содержания главной страницы вставьте:
<p>Этот одностраничник собран на MODX Revolution и готовой верстке Creative.</p>
<p>Тексты первых секций уже можно менять через админку. Дальше подключим карточки услуг, портфолио и контактную форму.</p>
В нашей учебной установке эти два абзаца вводим как HTML в обычное поле содержания. Если у вас уже подключен визуальный редактор, для вставки примера переключитесь в режим исходного кода.
Сохраните ресурс. Отдельный TV для основного текста About не нужен: для него используем стандартное поле content.
Выносим About в чанк
Создайте чанк с именем creative.about и вставьте:
<section class="page-section bg-primary" id="about">
<div class="container px-4 px-lg-5">
<div class="row gx-4 gx-lg-5 justify-content-center">
<div class="col-lg-8 text-center">
<h2 class="text-white mt-0">[[*about_title:htmlent]]</h2>
<hr class="divider divider-light" />
<div class="text-white-75 mb-4">
[[*content]]
</div>
<a class="btn btn-light btn-xl" href="#services">[[*about_button_text:htmlent]]</a>
</div>
</div>
</div>
</section>
Сохраните чанк.
Поле content содержит подготовленный HTML, поэтому выводим его без htmlent. Вместо исходного внешнего абзаца используем div: внутри содержания уже находятся собственные теги p.
Заголовок и подпись кнопки по-прежнему выводим как текст с экранированием. Ссылка #services ведет к секции At Your Service, которую подключим через MIGX в следующем уроке.
Заменяем исходную секцию вызовом чанка
В начальном шаблоне найдите секцию с id="about". Замените ее целиком, от открывающего <section> до соответствующего </section>, вызовом:
[[$creative.about]]
В результате после навигации и перед секцией услуг должны находиться два вызова:
[[$creative.hero]]
[[$creative.about]]
Сохраните шаблон и обновите сайт. Секция About должна показывать введенный заголовок, два абзаца содержания и кнопку «Наши услуги».

Удаляем демонстрационный блок загрузки
Между портфолио и контактной секцией в исходном Creative находится блок «Free Download at Start Bootstrap!». Для нашего учебного сайта он не нужен.
В начальном шаблоне найдите этот заголовок и удалите всю содержащую его секцию:
<section class="page-section bg-dark text-white">
<div class="container px-4 px-lg-5 text-center">
<h2 class="mb-4">Free Download at Start Bootstrap!</h2>
<a class="btn btn-light btn-xl" href="https://startbootstrap.com/theme/creative/">Download Now!</a>
</div>
</section>
Удаляем только этот блок. Разметку портфолио перед ним и контактную секцию после него сохраняем.
Оставляем карточки, портфолио и форму следующим урокам
Карточки At Your Service и изображения портфолио пока остаются в исходном HTML. Не нужно сейчас создавать TV для каждой карточки или вручную подключать изображения к Gallery.
Контактная форма также еще не связана с MODX. Ее исходный вариант подготовлен для SB Forms, а установка FormIt и AjaxForm не переключает обработку автоматически.
До урока форм оставим ее внешний вид, но отключим демонстрационную отправку.
Как временно отключить отправку формы
В конце кода шаблона удалите подключение SB Forms:
<script src="https://cdn.startbootstrap.com/sb-forms-latest.js"></script>
Остальные скрипты оформления оставьте: Bootstrap, SimpleLightbox и js/scripts.js используются другими функциями страницы.
Открывающий тег контактной формы замените:
<form id="contactForm" onsubmit="return false;">
Кнопку с id="submitButton" временно замените на:
<button class="btn btn-primary btn-xl" id="submitButton" type="button" disabled>Отправка пока не настроена</button>
Сохраните шаблон. Это временная заглушка, а не обработчик формы и не средство защиты. При подключении FormIt и AjaxForm изменим служебную разметку и уберем блокировку.
Проверяем результат
Откройте главную страницу и последовательно проверьте:
- Первый экран отображается один раз, без дублирования.
- Заголовок и описание совпадают с полями главной страницы.
- Кнопка «Подробнее» ведет к About.
- В About отображаются заголовок, два абзаца текста и кнопка «Наши услуги».
- Кнопка «Наши услуги» ведет к At Your Service.
- Блок «Free Download at Start Bootstrap!» больше не отображается.
- Карточки услуг, портфолио и контактная секция остались на месте.
Теперь измените аннотацию ресурса, заголовок About и подпись одной кнопки. Сохраните ресурс и обновите страницу сайта.
Если изменения появились без редактирования шаблона и чанков, содержание первых двух секций подключено правильно.
Что делать, если результат отличается
Не загрузились стили или изображения
Проверьте, что скопировали все три папки: assets, css и js. Одной папки assets для этого комплекта Creative недостаточно.
В инструментах разработчика браузера откройте Network, обновите страницу и посмотрите, какие запросы завершаются ошибкой.
Частые причины: лишняя вложенность каталогов, пропущенные файлы, несовпадение регистра имени или смешение разных выпусков шаблона.
Если локальные файлы загружаются, но отсутствуют иконки, шрифты или просмотрщик изображений, проверьте также внешние запросы. Фоновое изображение может подключаться из CSS — его адрес тоже нужно проверить.
Дополнительное поле не появилось или выводится пустым
Проверьте имя TV, его привязку к начальному шаблону и назначение этого шаблона главной странице. После создания поля заново откройте ресурс.
Значение должно быть заполнено именно у главной страницы. Создание TV само по себе не добавляет текст в ресурс.
Секция появилась дважды
В шаблоне одновременно остались исходная разметка и вызов чанка. Удалите старый блок целиком, оставив на его месте только соответствующий вызов.
Для первого экрана это [[$creative.hero]], для второй секции — [[$creative.about]].
Страница не меняется после сохранения
Убедитесь, что редактировали нужный ресурс, сохранили изменения и открыли именно его. Проверьте шаблон главной страницы и фактическое значение site_start.
Посмотрите, нет ли отдельного index.html в корне сайта. Если сервер открывает его вместо index.php, вы видите статичную копию, а не страницу MODX.
После этих проверок при необходимости очистите кеш MODX и обновите страницу браузера.
Если вместо значения выводится сам тег, проверьте его запись. В шаблоны и чанки вставляем обычные вызовы с квадратными скобками, а не HTML-сущности для показа кода.
Относительные пути на вложенных страницах
В этом уроке проверяем одностраничник по корневому адресу учебного сайта. После назначения того же шаблона вложенной странице относительные пути могут разрешаться иначе.
Один из способов задать базовый адрес — добавить в head перед относительными ссылками:
<base href="[[!++site_url]]">
Проверьте, что site_url соответствует протоколу, домену и подкаталогу установки. Не добавляйте base, если в текущем примере пути уже работают правильно.
После изменения проверьте якорные ссылки меню. base влияет не только на файлы оформления и не исправляет отсутствующие изображения или скрипты.
Следующий шаг
Первый экран и About подключены: их тексты и подписи кнопок меняются через ресурс, а разметка находится в двух чанках. Дальше сделаем редактируемой секцию At Your Service через MIGX.
После карточек перейдем к портфолио на Gallery и контактной форме. Фоновое изображение, навигация и остальные демонстрационные данные пока остаются частью исходного оформления.
Общая последовательность находится в карте обучения MODX.











