PageBuilder Pro — расширение визуального конструктора секций для MODX 3
PageBuilder Pro расширяет PageBuilder Free дополнительными секциями, типами полей и инструментами для повторного использования контента, шаблонов, данных и интеграции с внешними приложениями.

При установке PageBuilder Pro автоматически устанавливает PageBuilder Free как зависимость.

Что добавляет Pro

• дополнительные секции для контента, конверсии, медиа и интернет-магазинов
• 27 дополнительных типов полей
• Общие блоки и Master-секции
• журнал событий секций и восстановление состояния
• шаблоны страниц
• адаптивные значения для Desktop / Tablet / Mobile
• условия отображения секций
• вкладка «Примеры» с готовыми пресетами
• копирование секций между контекстами
• глобальная корзина
• расширенные UTM-правила
• Dynamic List и Filterable Grid
• Forms и Form Builder
• Agent API
• REST API v1
• Constructor Bundle для экспорта и импорта UI-типов

Секции PageBuilder Pro
Pro добавляет секции для контента, конверсии, медиа, работы с данными и MiniShop3.

Контент и универсальные секции

• Преимущества
• Команда
• Вкладки
• Аккордеон
• Как это работает
• Структурированный контент
• Кейс
• Таблица данных
• Таблица характеристик
• Хронология
• Цитата
• Уведомление

Медиа и дополнительные блоки

• Видео
• Карта
• Контакты с картой
• Карусель галереи
• Медиа и текст
• До и после
• Портфолио
• Загрузки
• Адреса
• Логотипы партнёров
• Записи блога

Конверсия и формы

• Тарифы
• Форма обратной связи
• Конструктор формы
• Квиз
• Рассылка

Данные и динамический вывод

• Динамический список
• Сетка с фильтром

MiniShop3
Commerce-секции работают при установленном MiniShop3.

• Сетка товаров
• Карусель товаров
• Товар в фокусе
• Подборка товаров
• Похожие товары
• Промо-баннер
• Ряд категорий
• Ряд брендов
• Сравнение товаров

Commerce-секции используют требования pro и minishop3 и не появляются как доступные для использования без установленного MiniShop3.

Примеры и готовые структуры
В каталоге секций Pro доступна вкладка «Примеры». Она содержит готовые пресеты, которые можно использовать при создании страницы.

Дополнительно доступны шаблоны страниц. Шаблон содержит упорядоченный набор типов секций без контента. Его можно создать в CMP, сохранить из текущего ресурса и применить к черновику другого ресурса.

Шаблоны используют только тип секции и её версию — содержимое страницы в шаблон не попадает.

Общие блоки и Master-секции
Секцию можно сохранить как общий блок и использовать на других ресурсах.

Доступны режимы:

• связать секцию с Master
• вставить независимую копию
• подтянуть секцию с другой страницы
• изменить список локальных полей связанной секции

При выводе данные Master объединяются с локальными данными связанной секции. Для полей, указанных в libraryLocalFields, можно использовать локальные значения.

При сохранении или публикации страницы синхронизируемые поля могут записываться обратно в Master.

Журнал событий секций
Для секций Pro доступен журнал событий.

Фиксируются действия:

• создание
• изменение
• копирование
• удаление
• включение
• отключение

Из контекстного меню секции доступны View и Restore.

В текущей версии это именно журнал событий отдельных секций, а не система снимков всей страницы.

Адаптивные значения
Для поддерживаемых полей можно задавать разные значения для:

• Desktop
• Tablet
• Mobile

Responsive поддерживается для:

• text
• textarea
• url
• number
• currency
• richtext
• slug

Условия отображения
Для секций можно задать settings.conditions.

Evaluator поддерживает условия, связанные с:

• авторизованным пользователем
• гостем
• контекстом MODX
• GET-параметрами
• зарегистрированными условиями

27 дополнительных типов полей
PageBuilder Free предоставляет 35 типов полей. Pro добавляет ещё 27.

• address
• combo
• currency
• datasource
• daterange
• dependent
• documents
• editorjs
• embeddedTable
• fieldset
• form
• gallery
• icon
• imask
• jsongrid
• keyvalue
• link
• map
• multicombo
• multirelation
• product
• products
• relation
• schedule
• table
• tablecombo
• tablemulticombo

Таблицы
PageBuilder поддерживает два сценария работы с таблицами.

Отдельные таблицы ресурса доступны во вкладке «Таблицы». Они предназначены для больших наборов строк и поддерживают фильтрацию, импорт CSV/JSON и массовые операции.

Pro-секция data_table предназначена для небольшой таблицы, которая хранится непосредственно в JSON конкретной секции.

Поле table позволяет редактировать табличные данные непосредственно в Inspector. Поля колонок и их типы определяются схемой секции.

Dynamic List и Filterable Grid
Pro содержит секции для динамической работы с данными.

Dynamic List и Filterable Grid используют datasources.

Доступны провайдеры:

• modx-resources
• pagebuilder-tables
• minishop3
• пользовательские datasource через mgr/datasource/*

Формы
Pro добавляет CMP Forms, Form Builder и интеграцию с FetchIt.

Для форм предусмотрены:

• CSRF-защита
• honeypot
• обработка через FetchIt
• отправка email после commit
• webhook после commit

Отправленные данные форм не сохраняются в базе данных PageBuilder.

Секции quiz и contact_form требуют FetchIt на фронтенде.

Вывод секций на сайте
Pro использует стандартный сниппет PageBuilder для вывода опубликованных секций:

[[!PageBuilder]]

или:

{'!PageBuilder' | snippet}

Pro-секции выводятся тем же механизмом, что и секции Free. Для Pro-секций используются собственные Fenom Chunks с префиксом pagebuilderpro_.

Вывод секций другого ресурса
Опубликованные секции другого ресурса можно вывести через PageBuilderResource.

JSON и Headless
Free Public API остаётся доступен и в Pro. Он предназначен для read-only получения опубликованного контента в JSON.

Public API может возвращать:

• опубликованные значения секций
• HTML секций
• JSON документа
• каталог типов секций

Pro-секции также доступны через Public API, если они опубликованы на странице.

Agent API
Agent API предназначен для скриптов, агентов и собственных конструкторов.

Доступны операции:

• snapshot — получить revision, черновик, типы секций и схемы полей
• apply — добавить, заменить или обновить секции

Поддерживаются режимы:

• append
• prepend
• replace
• upsert

Можно передать publish=1, чтобы после применения сразу опубликовать страницу.

Agent API работает через assets/components/pagebuilder/connector.php, использует менеджерскую сессию MODX и проверяет права пользователя.

REST API v1
Pro предоставляет отдельный read-only REST API для опубликованного контента.

Доступны:

• GET /pages — список страниц
• GET /pages/{id-or-alias} — отдельная страница
• GET /catalog/sections — каталог секций

Авторизация выполняется через Authorization: Bearer.

Дополнительно поддерживаются:

• scopes
• отзыв токенов
• ETag / 304
• throttle по токену

REST API v1 предназначен для выдачи опубликованного контента. Для работы с черновиками и записи используется Agent API.

UTM
Pro добавляет новые UTM-правила и реестр UTM. Уже опубликованные UTM-правила продолжают исполняться механизмами Free.

Копирование между контекстами
Секции можно копировать между контекстами MODX с помощью Pro-функции i18n-copy.

Глобальная корзина
В панели управления доступна глобальная корзина для восстановления удалённых секций и строк таблиц между ресурсами.

Constructor Bundle
Bundle позволяет экспортировать и импортировать UI-типы секций.

Доступны:

• export
• dry-run
• проверка create
• проверка update
• проверка conflict
• import одной транзакцией

Bundle предназначен для переноса определений UI-типов. Секреты, API-токены, содержимое страниц и строки таблиц в Bundle не входят.

Для разработчиков
Pro расширяет API и механизм регистрации секций.

Новые типы секций регистрируются через pbOnRegisterSectionDefinitions.

Для собственных расширений доступны:

• JSON-определения секций
• Fenom Chunks
• пользовательские поля
• datasources
• события pbOn*
• Agent API
• Public API
• REST API v1
• Constructor Bundle

Требования

• MODX Revolution 3.0.3+
• PHP 8.2+
• VueTools
• pdoTools
• MySQL / MariaDB
• xPDO 3

Зависимости
PageBuilder Pro требует PageBuilder Free.

Для commerce-секций требуется MiniShop3.

Для секций quiz и contact_form на фронтенде требуется FetchIt.

Документация

• Документация PageBuilder
• PageBuilder Pro
• Каталог секций
• Справочник типов полей
• Тип поля table
• REST API v1