PageBuilder
Visual section builder for MODX 3. Draft and publish without overwriting resource content
PageBuilder CMP
Components → PageBuilder (SectionTypesManager.vue). Permission pagebuilder_manage_types is required for the Blocks tab. Other CMP tabs use standard manager permissions.
Four site-level tabs, not tied to a single resource:
| Tab | Tier | Purpose |
|---|---|---|
| Blocks | Free | UI builder for section types (pb_section_types) |
| UTM | Free | Global UTM parameter registry (pb_utm_params) |
| Collections | Free | Resource form tab sets by template (pb_collections) |
| Basket | Pro | Global basket for deleted sections and table rows |
Blocks
CRUD section types without PHP deploy. Built-in JSON from core/components/pagebuilder/sections/*.json can be edited, hidden, and restored in the catalog via CMP.
| Action | What happens |
|---|---|
| Override | Row in pb_section_types, overridesCode flag. Database wins at runtime |
| Hide | Type hidden from the resource catalog; still visible in CMP with a Hidden badge |
| Remove (code type) | removedCode tombstone in the database. Package JSON is not deleted |
| Restore | Enable Show hidden → Restore |
On extra upgrade, pb_section_types rows are not overwritten: the database wins. Sections on already published pages keep rendering.
Processor mgr/sectiontype/remove accepts POST parameter lifecycle: hide, remove, restore (do not confuse with connector action).
JSON schema details: Developer → Section definition.
UTM
Parameters for {{utm:key}} placeholders and default values. Section visibility rules are set in the resource inspector (settings.utm), not on this tab.
Call PageBuilderUtmSession before PageBuilder on the front. See Snippets.
Collections
A collection binds to template_ids (empty list = all templates). When pagebuilder_collections_enabled = 1, legacy tabs resource_tab_enabled / resource_tables_tab_enabled are replaced by the dynamic set from CMP.
Tab types (tab_type)
| Type | Behavior on resource |
|---|---|
sections | “Sections” tab (Vue pagebuilder-resource) |
table | Tabular resource data (table_key optional) |
resources | Child resources |
empty | Placeholder (config.message) |
modx_collections | Bridge to MODX Collections (pagebuilder_collections_modx_bridge_enabled) |
iframe | URL in <iframe> |
Processors: mgr/collection/list, save, remove, resolve.
Settings: System settings → Collections.
Basket (Pro)
Capability basket. Per-page basket in the resource draft stays in Free.
Indexes sections from draft.trash[] and table rows on delete. Syncs on pbOnAfterSave. On resource OnEmptyTrash, index entries for that resource_id are removed.
| Action | Purpose |
|---|---|
mgr/basket/list | List (item_type, pagination) |
mgr/basket/restore | Restore section or table row |
mgr/basket/purge | Remove from index |
mgr/basket/restoreall / purgeall | Bulk by ids array |
| Where | What it does |
|---|---|
| Resource editor → Basket | Per-page: restore / purge in draft (Free) |
| CMP → Basket | Cross-resource: list, restore to source resource, purge (Pro) |
CMP restore inserts the section at settings._trashIndex, same as per-page basket.