PageBuilder
Визуальный конструктор секций для MODX 3: черновик и публикация без перезаписи content ресурса
Ключевые возможности
PageBuilder собирает страницу из блоков-секций, а не из поля Содержимое ресурса. Редакторы работают во вкладке Секции: черновик, превью, публикация. Разработчики добавляют свои типы секций, поля и шаблоны вывода, подключаются через события pbOn*.
Для кого
| Роль | Что получает |
|---|---|
| Редактор | Drag-and-drop секций, инспектор полей, черновик, превью, публикация без правки шаблона |
| Начинающий разработчик | 34 готовых секции, 50 типов полей, JSON-схема и Fenom в chunks без своего Vue |
| Опытный разработчик | События, свои типы секций, табличные данные ресурса, UTM, интеграция с miniShop3 и Collections |
Конструктор страницы
1. Редактор секций на ресурсе
Вкладка Секции на форме ресурса и в панели управления PageBuilder использует один Vue-бандл через VueTools. Вы добавляете секции из каталога, меняете порядок перетаскиванием или Alt+↑/↓, дублируете и копируете блоки между ресурсами.
Подробнее: Быстрый старт, Менеджер и события.
2. Черновик и публикация
Правки сначала попадают в черновик. Превью показывает черновик без публикации. После Опубликовать на сайт уходит та же раскладка. Сниппет [[!PageBuilder]] выводит только опубликованную версию.
Подробнее о хранении: Рабочий процесс, Разработчик → Модель данных.
3. Каталог секций Free и Pro
| Слой | Секций | Примеры |
|---|---|---|
| Free | 11 | hero, richtext, gallery, faq, cta |
| Pro | 23 | products_grid, contact_form, pricing_table, tabs |
У каждой секции своя страница в каталоге: зачем блок, где применять, что заполнить в инспекторе, похожие секции.
4. Инспектор и 50 типов полей
Схема полей задаётся в JSON секции: 30 типов Free (text, repeater, editorjs, image, multiselect, video…) и 20 Pro (relation, gallery, combo, embeddedTable…). У каждого типа есть справочная страница с блоками «Зачем», «Когда использовать», «Советы».
См. Обзор полей и справочник типов.
PageBuilder Pro
Дополнение pagebuilderpro добавляет флаги Pro и расширяет редактор:
- Библиотека секций: сохранить блок, вставить на другой ресурс, править связанную копию
- Версии: снимки документа, сравнение версий, откат
- Пресеты: готовые наборы секций для типовых лендингов
- Поля по breakpoints: разные значения для desktop, tablet и mobile
- Расширенные поля: 20 типов в панели управления (relation, map, table, dependent и др., флаг
advanced-fields) - Глобальная корзина в панели управления: восстановление и окончательное удаление секций и строк таблиц (флаг
basket)
Commerce-секции (products_grid, curated_products…) требуют miniShop3.
Подробнее: PageBuilder Pro, Agent API для скриптов и агентов.
Данные и интеграции
5. Табличные данные ресурса
Вкладка Таблицы на ресурсе хранит строки в pb_*: фильтры, пагинация, импорт CSV/JSON, корзина строк. Секция data_table и сниппет PageBuilderTableRows выводят данные на сайте. Поле embeddedTable подключает таблицу по table_key без встроенных строк в JSON документа.
6. UTM и контексты
UTM registry в панели управления, правила видимости секций по меткам и контексту MODX. Плейсхолдер {{utm:key}} в полях. Сниппеты PageBuilderUtmSession и PageBuilderUtmUrl для сессии и ссылок.
7. Collections
При включённых настройках pagebuilder_collections_* на ресурсе появляются вкладки Collections с iframe. Редактор секций и коллекции оказываются на одной форме.
8. Корзина и undo
Корзина на странице есть в Free. Глобальная корзина в панели управления доступна в PageBuilder Pro (флаг basket). В редакторе работают отмена и повтор действий. Секции копируют между ресурсами без ручной правки JSON.
Вывод на сайте
9. Fenom и chunks секций
Каждая секция рендерится через chunk с Fenom (pdoTools). Данные полей лежат в section.data. Примеры MODX и Fenom смотрите на страницах полей и в разделе Вывод на сайте.
10. Сниппеты
| Сниппет | Назначение |
|---|---|
PageBuilder | HTML опубликованных секций |
PageBuilderResource | Секции другого ресурса |
PageBuilderSitemap | XML sitemap по страницам с секциями |
PageBuilderTableRows | Строки табличных данных ресурса |
PageBuilderUtmSession / PageBuilderUtmUrl | UTM на фронте |
| Public API | JSON опубликованных секций для headless (api.php) |
Полный список: Сниппеты.
11. События pbOn*
Plugin подписывается на save, publish, render, регистрацию типов секций и провайдеров Pro. Точка расширения без правок ядра компонента.
Список событий: События.
Системные требования
| MODX Revolution | 3.0.3+ |
| PHP | 8.2+ |
| VueTools | 1.1.2+ |
| pdoTools | 3.0+ |
| miniShop3 | опционально, для Pro commerce-секций |
Namespace в MODX: pagebuilder. Pro ставится дополнением pagebuilderpro (ядро Free подтягивается как зависимость).