PageBuilder

Страницу вы собираете из секций во вкладке Секции в MODX. Пока правите, изменения остаются черновиком. После Опубликовать на сайт уходит та же раскладка. Обычное поле Содержимое ресурса для секций не используется. На витрине блоки выводит сниппет PageBuilder.

В боковом меню: установка, редактор, вывод на сайте, Pro, раздел разработчика, отдельные списки типов полей и секций. С чего начать: Быстрый старт.

Возможности

Редактор на ресурсе

Во вкладке Секции: таблица или компактный редакционный список, добавление из каталога, перетаскивание и Alt+↑/↓, дублирование, копирование секций с другой страницы. Удалённые секции попадают в корзину страницы. Контент правите в модальном инспекторе Свойства. Пока инспектор открыт для только что добавленной секции, автосохранение стоит на паузе: Отмена откатывает черновик к состоянию до добавления. Правила видимости (контекст, UTM) открывает кнопка Видимость, если включена системная настройка. Превью черновика в drawer по подписанной ссылке, без публикации. Undo/redo в текущей сессии. Перед публикацией редактор проверяет обязательные поля.

Черновик и публикация

Правки сохраняются в черновик. После Опубликовать та же раскладка уходит на сайт. Снять с публикации очищает опубликованную версию, черновик остаётся. При сохранении сервер сверяет номер ревизии, чтобы не затереть чужие правки.

Free: секции и поля

11 встроенных типов: hero, richtext, gallery, faq, cta, cards, contact, stats, testimonials, image, spacer. В панели управления (Blocks) фильтруете типы чипами Все / Из пакета / Мои, массово скрываете предустановленные и задаёте своё превью в каталоге вместо схематичной картинки. 31 тип полей в Free и 20 в Pro (51 всего): text, richtext, repeater, migx, file, select и др. Часть полей поддерживает разные значения по breakpoint (responsive).

PageBuilder Pro

Глобальная библиотека (Общие блоки), снимки версий и журнал событий, вкладка Примеры в каталоге добавления, Agent API для скриптов и агентов. Корзина в панели управления восстанавливает удалённые секции и строки таблиц между ресурсами. Каталог Pro: features, video, team, tabs, карты, формы, commerce-блоки miniShop3 (сетки товаров, бренды, pricing и др.). Ещё 20 типов полей: gallery, map, relation, table, embeddedTable и др.

Таблицы на ресурсе

Вкладка Таблицы хранит большие наборы строк в БД: фильтры, импорт CSV/JSON, массовое удаление. На витрине строки выводит PageBuilderTableRows. Секция data_table (Pro) встраивает небольшую таблицу в JSON секции.

UTM и контексты

В панели управления задаёте реестр UTM-меток. Правила видимости (контекст, UTM, Pro conditions) открываются кнопкой Видимость в инспекторе, если включена pagebuilder_inspector_visibility_enabled. Сниппеты PageBuilderUtmSession и PageBuilderUtmUrl помогают на лендингах. В полях доступен плейсхолдер {{utm:key}}.

Collections и панель управления

При collections_enabled вкладки ресурса (секции, таблицы, iframe и др.) настраиваются в панели управления. Раздел Компоненты → PageBuilder ведёт каталог ресурсов с секциями и типами секций.

Сниппеты, Public API и события

PageBuilder выводит HTML секций, PageBuilderResource отдаёт секции другого ресурса, PageBuilderSitemap строит XML sitemap. Public API отдаёт опубликованные секции JSON для headless-фронта (api.php). События pbOn* подключают плагины к save, publish, render и регистрации типов секций. Подробнее: workflow, cmp, pro.

Системные требования

Требование	Значение
MODX Revolution	3.0.3+
PHP	8.2+
VueTools	1.1.2+ (редактор в менеджере)
pdoTools	3.0+ (Fenom в chunks секций)
miniShop3	опционально, для Pro-секций каталога

Пакеты

Дополнение	Версия	Содержимое
pagebuilder	1.0.5-beta	Free: core, секции, панель управления, сниппеты, поле migx, responsive breakpoints, фильтр типов и свои превью в каталоге
pagebuilderpro	1.0.4-beta	Pro: зависит от pagebuilder ≥ 1.0.5, расширенный каталог и функции

Namespace в MODX: pagebuilder.

Быстрые ссылки

Нужно	Документ
Обзор возможностей	Ключевые возможности
Установить и собрать первую страницу	Быстрый старт
Все ключи pagebuilder_*	Системные настройки
Черновик, публикация, корзина	Рабочий процесс
Blocks, UTM, Collections, корзина Pro	Панель управления
Права, события pbOn*, модель данных	Менеджер и события
Шаблон, превью, кеш сниппета	Вывод на сайте
CSS-токены и BEM секций	Дизайн-система
JSON для headless	Public API
Сниппеты и параметры	Сниппеты
Pro, корзина, примеры	PageBuilder Pro
Скрипты и агенты	Agent API
Свои секции и расширения	Разработчик
51 типов полей инспектора	Справочник типов полей
34 встроенных блока	Каталог секций
Типовые ошибки	FAQ

Точки входа

URL / путь	Назначение
Компонент pagebuilder → index	Каталог ресурсов с секциями, типы секций (Pro)
assets/components/pagebuilder/connector.php	MGR API (VueTools)
assets/components/pagebuilder/preview.php	Превью черновика в iframe
assets/components/pagebuilder/api.php	Public API: опубликованные секции JSON (headless)
Сниппет [[!PageBuilder]]	HTML опубликованных секций на сайте

Права

Permission	Назначение
pagebuilder_view	Вкладка «Секции», каталог, токен превью
pagebuilder_save	Сохранение черновика и публикация (fallback: save_document)
pagebuilder_manage_types	панель управления «Типы секций» (без fallback на view)

Доступ к конкретному ресурсу дополнительно проверяет политика MODX (view, save).