CookieConsentManager

Cookie Consent Manager — управление cookie и сторонними сервисами для MODX

Не просто cookie-баннер, а полноценный менеджер согласий: управление аналитикой, рекламными скриптами, видео, картами и собственными интеграциями из панели MODX.



Cookie Consent Manager учитывает выбор посетителя, контролирует загрузку подключённых сервисов и ведёт журнал согласий. Интерфейс, тексты и категории можно настроить под свой сайт без обязательной подписки на стороннюю облачную платформу. Никаких внешних зависимостей и Jquery

Два режима работы

• Strict — необязательные сервисы и внешний контент не загружаются до разрешения соответствующей категории.
• Legacy — при первом посещении сервисы могут запускаться до выбора пользователя. Сохранённые отказы и ранее заданные ограничения при этом учитываются.

Посетитель может принять все необязательные категории, отказаться от них или настроить разрешения самостоятельно.

Три варианта баннера и гибкая локализация

• Широкий баннер снизу, компактный справа или компактный слева.
• Необязательный заголовок, настройка текстов, названий кнопок, категорий и сервисов.
• Управление видимостью необязательных категорий.
• Русский и английский из коробки; собственные переводы для других языков сайта. (совместим со всеми пакетами мультиязычности)
• Предварительный просмотр в панели MODX.

Готовые интеграции

• Аналитика: Яндекс.Метрика (включая Вебвизор), Top.Mail.Ru, Google Analytics 4, Google Tag Manager.
• Реклама: Google Ads, VK Ads Pixel, Meta Pixel.
• Видео: YouTube, RUTUBE, VK Видео.
• Карты: Яндекс.Карты и Google Maps.
• Свои сервисы: подключение JavaScript-файлов по локальному пути или HTTPS-адресу.

Можно создавать несколько экземпляров сервиса и свободно назначать интеграции категориям. Посетитель управляет категориями, а не каждым отдельным счётчиком. Для Google-интеграций предусмотрена поддержка Consent Mode v2; правила согласия для отдельных тегов GTM настраиваются разработчиком.

Видео, карты и iframe под контролем

В режиме Strict вместо стороннего плеера или карты до согласия отображается заглушка с пояснением и кнопкой настроек. Сами iframe остаются неактивными.

• Сниппеты CookieConsentVideo и CookieConsentMap.
• Встраивание собственного доверенного HTML через тег template.
• Постеры, адаптивные размеры и горизонтальное или вертикальное видео.
• Работа с контентом, добавленным после загрузки страницы, например через AJAX.

Для разработчиков: адаптеры, которые можно изменять

Если сторонний сервис изменит способ подключения, встроенный JS-адаптер можно отредактировать на сервере. При обновлении пакета пользовательские правки сохраняются: компонент сравнивает SHA256 оригинальных файлов и автоматически заменяет только неизменённые адаптеры. Автоматического слияния конфликтующих правок нет.

Встроенные адаптеры собираются в единый минифицированный JavaScript-файл при установке, обновлении, очистке кеша из Manager или по кнопке пересборки. Если сборка завершается ошибкой, предыдущий рабочий файл сохраняется. На запросах посетителей исходники не проверяются и не компилируются; Node.js и npm на хостинге не нужны.

Публичный JavaScript API onAllowed() позволяет подключать собственную логику с проверкой разрешений, в том числе после асинхронных операций.

Умное обновление согласий

Компонент отслеживает изменение состава подключённых сервисов. Если обработка данных в категории изменилась, новый выбор требуется только для затронутой категории. Изменение оформления и переводов не сбрасывает согласия. При необходимости администратор может повторно запросить согласие у всех посетителей.

Журнал согласий

События сохраняются в файлах на сервере сайта. В MODX доступны дата и тип действия, выбранные категории, путь страницы, подробности записи, фильтрация и экспорт в CSV. Права просмотра журнала и изменения настроек разграничены.

Подключение к шаблону

Для рекомендуемого варианта достаточно двух сниппетов:

• [[!CookieConsentAssets]] — в месте вывода js
• [[!CookieConsentBanner]] — в месте вывода баннера

Для существующих интеграций предусмотрен единый сниппет [[!CookieConsent]]. Оба способа одновременно использовать не нужно.

В комплект входит руководство на русском и английском языках с примерами подключения, настройки сервисов и использования API.

Совместимость

• Этот пакет совместим только с MODX 2: 2.8.4–2.8.x, PHP 8.1+.

Cookie Consent Manager — единое место для управления согласиями, сторонними сервисами и внешним контентом вашего MODX-сайта.
Компонент предоставляет технические инструменты управления согласием. Соответствие GDPR и другим требованиям законодательства зависит от настройки сайта, используемого режима и применимых правовых норм.