docs.modx.pro
CookieConsentManager
Управление согласиями, загрузкой аналитики, рекламных сервисов, видео и карт в MODX Revolution.
  • MODX 2
  • MODX 3
  • PHP 8.1
  1. Компоненты
  2. CookieConsentManager
  3. Быстрый старт

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

Установка ​

  1. Сделайте резервную копию БД, core/, assets/, шаблонов и существующих журналов.
  2. Установите пакет для своей платформы через штатный Package Manager: cookieconsentmanager-1.0.8-pl5 для MODX 2 либо cookieconsentmanager3-1.0.8-pl7 для MODX 3. Это разные transport-пакеты.
  3. Откройте Компоненты → CookieConsentManager (название и положение пункта могут различаться в Manager).
  4. В Сервисах включите необходимую категорию для показа посетителю, затем нужные сервисы и задайте действительные идентификаторы.
  5. На вкладке Тексты проверьте надписи и язык.
  6. Сохраните изменения. Для аудита укажите каталог журналов, доступный PHP на запись и недоступный посетителям по HTTP.

Новая установка не должна неожиданно запускать необязательные сервисы: сначала настройте их явно.

Рекомендуемый способ подключения ​

Добавьте в общий шаблон MODX один вызов без кеширования, например в <head>:

html
<head>
    [[!CookieConsentAssets]]
</head>

И второй вызов, например перед </body>:

html
<body>
    <!-- Контент сайта -->
    [[!CookieConsentBanner]]
</body>

Добавьте в подвал сайта кнопку для повторного открытия настроек:

html
<button type="button" data-cookie-settings-open>Настройки cookie</button>

Вызовы выполняются без кеширования ([[!…]]). Для Fenom используйте форму вызова, которую ваш шаблон гарантированно не преобразует, например {'!CookieConsentAssets'|snippet} и {'!CookieConsentBanner'|snippet} при корректной настройке pdoTools/Fenom.

Альтернативный способ — один [[!CookieConsent]] вместо пары Assets/Banner. Не смешивайте оба способа и не вставляйте один и тот же вызов несколько раз.

Перенос существующих скриптов ​

Если счётчик уже подключён отдельным <script> или через иной менеджер тегов, уберите дублирующий вызов и настройте сервис через CookieConsentManager. Сам компонент не блокирует сторонний код, вставленный напрямую.

Проверка после настройки ​

Откройте страницу в приватном окне с вкладкой браузера Network:

  1. В Strict до выбора не должно быть запросов к необязательным SDK/iframe, которые контролирует компонент.
  2. Разрешите аналитику и убедитесь, что нужный счётчик загружается.
  3. Отклоните необязательные категории, затем обновите страницу: они не должны запускаться.
  4. Откройте настройки повторно через data-cookie-settings-open.
  5. Проверьте событие в журнале согласий и соответствующую запись на сервере.

После тестирования см. штатное удаление и повторную установку: изменённые адаптеры и журналы не уничтожаются автоматически.

Подсказка

Проверяйте не только внешний вид баннера, но и реальные сетевые запросы до и после выбора.