PageBuilder

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

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

Возможности

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

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

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

Autosave пишет только черновик. Сохранить ресурса MODX: validate → черновик → публикация в published_json. Снять с публикации очищает опубликованную версию, черновик остаётся. При сохранении сервер сверяет номер ревизии, чтобы не затереть чужие правки.

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

12 встроенных типов: hero, richtext, gallery, faq, cta, cards, contact, stats, testimonials, image, spacer, video. Новую gallery создаёт Pro, рендер остаётся в Free. В панели управления (Blocks) фильтруете типы чипами Все / Из пакета / Мои, массово скрываете предустановленные и задаёте своё превью в каталоге вместо схематичной картинки. 35 типов полей в Free и 27 в Pro (62 всего): text, richtext, repeater, migx, file, select и др. При pagebuilder_responsive_editor_enabled в инспекторе появляются вкладки значений по устройствам.

PageBuilder Pro

Глобальная библиотека (Общие блоки): pull с другой страницы (Связать | Копировать), write-through linked-секций, шаблоны страниц, журнал событий секции (View/Restore). Вкладка Примеры в каталоге (тумблер Examples / pagebuilder_catalog_examples_enabled). Agent API для скриптов и агентов. Корзина в панели управления восстанавливает удалённые секции и строки таблиц между ресурсами. Каталог Pro: features, team, tabs, карты, формы, квиз, commerce-блоки miniShop3. Секция video создаётся в Free. Ещё 27 типов полей: gallery, map, relation, table, embeddedTable, editorjs и др.

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

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

UTM и контексты

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

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

Нужны PageBuilder Pro и capability collections. При collections_enabled вкладки ресурса (секции, таблицы, iframe и др.) настраиваются в панели управления. Без capability вкладки нет. Раздел Компоненты → 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.14-beta	Free: core, секции, панель управления, сниппеты, MIGX, responsive, Save = публикация, фильтр типов и свои превью
pagebuilderpro	1.0.14-beta	Pro: зависит от pagebuilder ≥ 1.0.14, quiz, library pull, шаблоны страниц, журнал секций

Namespace в MODX: pagebuilder.

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

Нужно	Документ
Обзор возможностей	Ключевые возможности
Установить и собрать первую страницу	Быстрый старт
Все ключи pagebuilder_*	Системные настройки
Черновик, публикация, корзина	Рабочий процесс
Blocks, UTM, Collections, корзина Pro	Панель управления
Права, события pbOn*, модель данных	Менеджер и события
Шаблон, превью, кеш сниппета	Вывод на сайте
CSS-токены и BEM секций	Дизайн-система
JSON для headless	Public API
Сниппеты и параметры	Сниппеты
Pro, корзина, примеры	PageBuilder Pro
Скрипты и агенты	Agent API
Свои секции и расширения	Разработчик
Лендинг, списки, формы, UTM, REST	Рецепты
62 типа полей инспектора	Справочник типов полей
50 встроенных блоков	Каталог секций
Типовые ошибки	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).