PageBuilder

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

С чего начать: Быстрый старт.

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

Вкладка Секции содержит редактор:

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

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

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

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

11 встроенных типов: hero, richtext, faq, cta, cards, contact, stats, testimonials, image, spacer, video.

Секцию gallery создаёт Pro (authoring: pro). Отрисовка уже созданной gallery на сайте работает и в Free.

В панели управления (Blocks) типы фильтруете чипами Все / Из пакета / Мои, массово скрываете предустановленные и задаёте своё превью в каталоге вместо схематичной картинки.

35 типов полей в Free и 27 в Pro (62 всего): text, richtext, repeater, migx, file, select и др. При pagebuilder_responsive_editor_enabled в инспекторе появляются вкладки значений по устройствам.

PageBuilder Pro

Глобальная библиотека (Общие блоки): подтянуть с другой страницы (Связать | Копировать), сквозная запись связанных секций, шаблоны страниц, журнал событий секции (View/Restore).

Вкладка Примеры в каталоге (тумблер Examples / pagebuilder_catalog_examples_enabled). Agent API для скриптов и агентов. Корзина в панели управления восстанавливает удалённые секции и строки таблиц между ресурсами.

Каталог Pro: gallery, features, team, tabs, карты, формы, квиз, блоки miniShop3. Кадрирование полей image/gallery задаёт capability image-crop (Pro). Секция 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 и регистрацию типов

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

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

Пакеты

Дополнение	Версия	Содержимое
pagebuilder	1.0.15-beta	Free: core, секции, панель управления, сниппеты, MIGX, responsive, Save = публикация, фильтр типов и свои превью
pagebuilderpro	1.0.15-beta	Pro: зависит от pagebuilder ≥ 1.0.15, 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)
assets/components/pagebuilder/api/v1.php	REST API v1 (Pro): Bearer-токены, scopes pages.read / catalog.read
Сниппет [[!PageBuilder]]	HTML опубликованных секций на сайте

Права

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

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