Skip to content
PageBuilder
Визуальный конструктор секций для MODX 3: черновик и публикация без перезаписи content ресурса
  1. Компоненты
  2. PageBuilder
  3. Вывод на сайте
  4. Сниппеты
  5. PageBuilderUtmUrl

Сниппет PageBuilderUtmUrl

Добавляет UTM-параметры из реестра панели управления к произвольному URL. Значения берутся из query string, $_SESSION['utm'] или default_value записи в pb_utm_params.

Назначение

Ссылка на лендинг или форму с теми же метками, что у текущего визита, без ручной сборки query string в шаблоне.

Где вызывать

Шаблон, chunk секции (через MODX), кнопки вне PageBuilder. Для полей url/button внутри секций удобнее {{utm:key}} в инспекторе.

Параметры

ПараметрПо умолчаниюОписание
urlпустоЦелевой URL. Пустой → пустой ответ
paramsпустоJSON с дополнительными query-параметрами. Ключи из params перекрывают реестр

Базовый вызов

modx
[[!PageBuilderUtmUrl?
  &url=`https://example.com/landing`
]]
fenom
{'!PageBuilderUtmUrl' | snippet : [
  'url' => 'https://example.com/landing'
]}

Дополнительные параметры в query

modx
[[!PageBuilderUtmUrl?
  &url=`/contacts/`
  &params=`{"utm_content":"hero-cta"}`
]]
fenom
{'!PageBuilderUtmUrl' | snippet : [
  'url' => '/contacts/',
  'params' => '{"utm_content":"hero-cta"}'
]}

Fenom: модификатор utm_query

pdoTools регистрирует модификатор на pdoToolsOnFenomInit:

fenom
<a href="{$button.url|utm_query}">{$button.label}</a>

Эквивалент вызова сниппета для URL из данных секции.

Сессия UTM

Чтобы в ссылку попали метки первого захода, перед рендером вызовите PageBuilderUtmSession или полагайтесь на плагин PageBuilder.

См. также