docs.modx.pro
PageBuilder
PageBuilder
Визуальный конструктор секций для MODX 3: черновик и публикация без перезаписи content ресурса
  • MODX 3
  • PHP 8.2
  • Vue 3
Зависимости
  1. Компоненты
  2. PageBuilder
  3. Начало работы

Быстрый старт ​

1. Установите зависимости и пакет ​

ТребованиеВерсия
MODX Revolution3.0.3+
PHP8.2+
VueTools1.1.2+
pdoTools3.0+
PageBuilder (Free)1.0.15-beta
PageBuilder Pro1.0.15-beta, требует pagebuilder ≥ 1.0.15

Пакеты PageBuilder (Free) и PageBuilder Pro ставятся из modstore.pro. Сообщение Package provider not found бывает только у шифрованного transport Pro, если провайдер не подключён. У текущего Free transport не зашифрован. Этой фразы при установке Free не будет.

  1. Подключите ModStore.
  2. Установите VueTools и pdoTools, если их ещё нет на сайте.
  3. Extras → Installer → Download Extras: найдите PageBuilder (Free) или PageBuilder Pro → Download → Install.
  4. Настройки → Очистить кэш. В списке пакетов должен появиться namespace pagebuilder.

Pro

Достаточно установить PageBuilder Pro: ядро Free (pagebuilder) Package Manager обычно подтягивает сам как зависимость requires.pagebuilder. Если зависимость не скачалась, установите Free вручную с того же провайдера.

2. Выдайте права ​

В Пользователи → Группы пользователей добавьте политике редактора:

  • pagebuilder_view
  • pagebuilder_save
  • pagebuilder_manage_types: типы секций в панели управления

3. Включите вкладку «Секции» ​

По умолчанию вкладка выключена. В Системные настройки → namespace pagebuilder:

КлючЗначение
pagebuilder_resource_tab_enabled1
pagebuilder_resource_tab_parentsпусто = все ресурсы, или ID родителей через запятую

Позицию вкладки задаёт pagebuilder_resource_tab_index (0 первая и сразу открыта, -1 последняя).

Вкладка «Секции» на ресурсе

Подробнее: Системные настройки.

4. Подключите вывод в шаблон ​

В шаблон страницы или в поле content ресурса:

modx
[[!PageBuilder]]
fenom
{'!PageBuilder' | snippet}

Сниппет отрисовывает опубликованные секции текущего ресурса. Черновик на сайте не показывается.

5. Соберите страницу в менеджере ​

  1. Откройте ресурс → вкладка Секции.
  2. Добавьте секцию (например Hero), заполните поля.
  3. Сохраните ресурс MODX (Сохранить в панели ресурса). Редактор проверяет обязательные поля, пишет черновик и публикует секции на сайт.
  4. Автосохранение во вкладке пишет только черновик. На сайте его нет, пока не сохраните ресурс.

При pagebuilder_fake_enabled = 1 в инспекторе появляется кнопка Fake: заполняет поля демо-данными для проверки вёрстки.

Превью черновика без публикации: кнопка Preview во вкладке (токен через preview.php).

6. Проверьте на сайте ​

Откройте ресурс на сайте. Должен появиться HTML секций. По умолчанию подключается pagebuilder-sections.css (настройка pagebuilder_load_frontend_css).

Если блок пустой:

  • ресурс не сохранили после правок (автосохранение не публикует)
  • у сниппета нет прав на ресурс
  • в шаблоне вызов без ! попал в кеш. Используйте [[!PageBuilder]]

Секции quiz и contact_form (Pro) на сайте нуждаются в FetchIt. Без него форма покажет сообщение о недоступности.

Дальше ​