EasyCookies
Баннер cookie для MODX 2 и 3 — простое уведомление или согласие по требованиям законов, со счётчиками и журналом согласий
Счётчики и сервисы
Счётчики в EasyCookies вставляются не в шаблон, а в профиль. Код сервиса запускает сам баннер, когда его категория разрешена: у простого баннера — сразу, у баннера по требованиям — после согласия. Когда посетитель отказывается, cookie сервиса удаляются.
Сервисы
| Сервис | Что указать | Категория по умолчанию | Cookie, которые удаляются при отказе |
|---|---|---|---|
| Яндекс Метрика | номер счётчика, Вебвизор | аналитические | _ym_uid, _ym_d, _ym_isad, _ym_visorc |
| Google Analytics | идентификатор потока G-XXXXXXXXXX | аналитические | _ga, _ga_* |
| Google Tag Manager | идентификатор контейнера GTM-XXXXXXX | аналитические | — |
| VK Реклама | ID пикселя | маркетинговые | tmr_lvid, tmr_lvidTS, tmr_detect |
| Meta Pixel | ID пикселя | маркетинговые | _fbp |
| Свой код | любые теги, в <head> или в конец <body> | аналитические | те, что вы укажете |
Сервис добавляется кнопкой с его названием под списком. У каждого сервиса:
- переключатель — выключенный сервис остаётся в профиле, но не запускается;
- название в окне настроек — его видит посетитель;
- идентификатор — форма подскажет, если он не похож на идентификатор этого сервиса. Без идентификатора сервис не запускается;
- категория и таблица cookie — только у баннера по требованиям.
Один и тот же сервис можно добавить несколько раз, например два счётчика Метрики.
«Свой код» вставляется как есть, скрипты в нём выполняются. Сюда подойдёт чат, пиксель или счётчик, которого нет в списке.
Категории и cookie
У баннера по требованиям сервис относится к категории: функциональные, аналитические или маркетинговые. Посетитель разрешает категорию целиком или отдельные сервисы в ней.
Cookie сервиса перечислены в разделе «Cookie сервиса»: имя, срок хранения и назначение. Они выводятся таблицей в окне настроек и удаляются, когда посетитель отказывается. Имя со звёздочкой — шаблон: _ga_* снимает все cookie, начинающиеся на _ga_. Скрипт, который уже отработал, со страницы не выгрузить, поэтому после отказа страница перезагружается.
Сроки и назначения подставляются на языке менеджера, когда сервис добавляют. Дальше их можно править.
Google Consent Mode v2
Теги Google получают сигналы согласия: analytics_storage — от аналитических, ad_storage, ad_user_data и ad_personalization — от маркетинговых, functionality_storage и personalization_storage — от функциональных.
Плагин ставит сигналы по умолчанию сразу после <head>, раньше любых тегов Google, в том числе вставленных в шаблон вручную. Если посетитель уже отвечал, сигналы с первой строки соответствуют его выбору. Когда посетитель отвечает или меняет выбор, баннер их обновляет.
У баннера по требованиям Consent Mode включается флажком «Google Consent Mode v2» и включён у новых профилей. Простой баннер ставит сигналы, только если в профиле есть Google Analytics или Google Tag Manager.
Global Privacy Control
Если браузер посетителя передаёт сигнал GPC — «не продавать и не передавать мои данные» (Firefox, Brave, DuckDuckGo, расширения), — маркетинговая категория и её сервисы для него не запускаются, а в окне настроек появляется пояснение. Этого требует CCPA в Калифорнии. При заголовке Sec-GPC: 1 плагин сразу запрещает рекламные сигналы Consent Mode.
Учёт сигнала включается флажком «Учитывать Global Privacy Control», у новых баннеров по требованиям он включён. Галка «Сигнал GPC» в превью показывает баннер глазами такого посетителя.
Перенос из шаблонов
Почти на каждом сайте Метрика и Analytics уже вставлены в шаблон. Кнопка «Найти на сайте» в карточке сервисов ищет их и переносит в профиль.
Где ищет
- Шаблоны и чанки в базе. Файл статичного элемента правится через сам элемент.
- Файлы
.tplи.htmlв каталоге элементов pdoTools (core/elements/) и в каталогах из настройкиeasycookies.migrate_paths. Только внутри сайта иcore/, безcache,vendor,node_modules,.gitиpackages.
Узнаёт Яндекс Метрику, Google Analytics, Google Tag Manager, Meta Pixel и VK Рекламу, вычитывает номера счётчиков и Вебвизор. Для каждого найденного счётчика видно, где он стоит, и его код.
- «уже в профиле» — такой счётчик в профиле уже есть.
- «Номер не читается» — номер задан тегом MODX или плейсхолдером. Такой счётчик перенесите вручную.
- Если веб-сервер не может записать файл, код там останется — мастер об этом предупредит.
Перенос
Отметьте счётчики и нажмите «Перенести». Счётчики добавятся в профиль, и профиль сохранится.
Если отмечено «Убрать их код из шаблонов и чанков», профиль ещё и включается на сайте — без него счётчики перестали бы работать. Затем из шаблонов, чанков и файлов вырезаются блоки <script> и <noscript> найденных счётчиков вместе с их служебными комментариями вроде <!-- Yandex.Metrika counter -->.
Внимание
Мастер режет блок <script> целиком. Блок, где вместе со счётчиком стоит код другого узнанного сервиса, вырезается, только если переносят все его сервисы. Если в одном <script> со счётчиком лежит ваш собственный код, проверьте шаблон после переноса — при необходимости код можно вернуть.
Возврат
Прежнее содержимое элементов и файлов сохраняется в core/packages/easycookies/backups/. Кнопка «Вернуть код» появляется в окне сразу после переноса и возвращает код, если элемент или файл с тех пор не правили. Позже, после закрытия окна, вернуть код можно только вручную из этого каталога.
Подсказка
«Вернуть код» не трогает профиль: счётчики в нём остаются, а профиль — включённым. Уберите лишнее из профиля сами, иначе счётчики сработают дважды.