PageBuilder
Визуальный конструктор секций для MODX 3: черновик и публикация без перезаписи content ресурса
Сниппеты PageBuilder
Пакет поставляет шесть сниппетов. Namespace chunks и секций: pagebuilder.
| Сниппет | Назначение |
|---|---|
| PageBuilder | HTML опубликованных секций текущего или заданного ресурса |
| PageBuilderResource | Секции другого ресурса (resource_id обязателен) |
| PageBuilderSitemap | XML sitemap страниц с опубликованными секциями |
| PageBuilderUtmSession | UTM из query string в сессию для правил видимости секций |
| PageBuilderUtmUrl | UTM из реестра панели управления к произвольному URL |
| PageBuilderTableRows | Строки табличных данных ресурса (JSON или chunk) |
Порядок на типовой странице
- PageBuilderUtmSession в общем layout, если на странице работают UTM-правила секций (один раз на запрос, до рендера секций).
- PageBuilder в шаблоне или поле content ресурса.
- PageBuilderTableRows отдельно, если таблица выводится вне секции
data_table.
Для блока с другой страницы (hero с главной, FAQ из лендинга) используйте PageBuilderResource.
Таблица соответствий (MODX / Fenom)
| Назначение | MODX | Fenom |
|---|---|---|
| Секции страницы | [[!PageBuilder]] | {'!PageBuilder' | snippet} |
| Фильтр секций | [[!PageBuilder? §ion_types=hero,cta]] | {'!PageBuilder' | snippet : ['section_types' => 'hero,cta']} |
| Секции другого ресурса | [[!PageBuilderResource? &resource_id=42]] | {'!PageBuilderResource' | snippet : ['resource_id' => 42]} |
| JSON для SEO | [[!PageBuilder? &return_values=1]] | {'!PageBuilder' | snippet : ['return_values' => 1]} |
| Sitemap | [[!PageBuilderSitemap]] | {'!PageBuilderSitemap' | snippet} |
| UTM в сессию | [[!PageBuilderUtmSession]] | {'!PageBuilderUtmSession' | snippet} |
| URL с UTM | [[!PageBuilderUtmUrl? &url=/contacts/]] | {'!PageBuilderUtmUrl' | snippet : ['url' => '/contacts/']} |
| Строки таблицы | [[!PageBuilderTableRows? &table_key=prices]] | {'!PageBuilderTableRows' | snippet : ['table_key' => 'prices']} |
Кэширование
PageBuilder и PageBuilderResource вызывайте некэшированно ([[!...]] или {'!...' | snippet}). Иначе MODX может отдать HTML без учёта свежей публикации.
PageBuilderUtmSession тоже некэшированный: сессия заполняется в том же HTTP-запросе, что и переход по UTM-ссылке.