EasyCookies

1.0.0-pl

Первая версия.

• Профили баннера: несколько на сайте, один активный. Копия профиля неактивна — на ней пробуют правки, не трогая сайт.
• Два вида баннера. Простой — уведомление с кнопкой «Понятно» и, по желанию, «Отказаться»; счётчики работают сразу (opt-out), в форме только текст, счётчики и вид. По требованиям — согласие до запуска счётчиков (opt-in) по GDPR, CCPA и похожим законам: категории, окно настроек с таблицей cookie, переводы, ревизии, Google Consent Mode v2. Вид меняется одной кнопкой без потери настроек.
• Сервисы, которые включает сам баннер: Яндекс Метрика (с Вебвизором), Google Analytics, Google Tag Manager, VK Реклама, Meta Pixel и свой код. Их запускают onAccept сервисов CookieConsent, при отказе их cookie удаляются и страница перезагружается.
• Настройки профиля — один JSON; конфиг CookieConsent из него собирает общий для админки и сайта src/core/build.ts, поэтому превью не расходится с сайтом.
• Превью прямо на странице менеджера: форма узкой колонкой по центру, баннер у краёв окна там, где он встанет на сайте. Тот же загрузчик, что на сайте, своя cookie ec_preview, без сервисов и затемнения, слой ниже окон менеджера и форм. Фокус превью у формы не отбирает: CookieConsent ставит его на своё окно при каждом показе, а превью перезапускается на каждую правку — закрывался только что открытый список и прерывался набор. Пока идёт превью, фокус внутрь баннера пускается, только если он уже там; на сайте всё как было. Баннер у верхнего или нижнего края окна отодвигает страницу редактора на свою высоту: высота меряется у самого баннера, а не угадывается по настройкам, поэтому любое поле и любая кнопка остаются доступными на прокрутке. У баннера по центру и у окна настроек отступа нет — докрутить до закрытого ими нельзя.
• Вид как в плейграунде CookieConsent: окно, облако или плашка, девять положений, окно настроек в центре или сбоку, темы Light, Dark, «как в системе», Turquoise, Funky, Elegant и свои цвета.
• Готовые тексты баннера на 14 языках; язык посетителя — из ` или браузера. {policy}` в текстах — адрес политики конфиденциальности или id ресурса; без адреса строки с такой ссылкой не выводятся.
• Плагин EasyCookies на OnWebPagePrerender: сигналы Consent Mode сразу после (с учётом уже данного согласия из cookie), стили, настройки и загрузчик перед. Только HTML-страницы; easycookies.exclude_resources исключает ресурсы. Сниппет EasyCookies — для ручного вывода.
• Загрузчик баннера — отдельная сборка Vite (vite.web.config.ts): IIFE-файл и CSS для обычного ``.
• Журнал согласий: баннер по требованиям записывает каждый ответ посетителя — первый и каждое изменение — с ID согласия, решением, категориями и сервисами, ревизией, языком, страницей без строки запроса, укороченным IP и User-Agent. Вкладка в админке: сводка за период (доли решений и категорий), фильтры, листание, выгрузка в CSV. Приёмник consent.php работает без сессии и cookie, принимает только подписанные страницей запросы (HMAC от site_id, неделя), не больше 60 в час с адреса и без повторов. Старые записи удаляются по easycookies.log_days; easycookies.log_ip выключает хранение IP.
• Мастер переноса счётчиков: «Найти на сайте» ищет в шаблонах и чанках Метрику, GA4, GTM, Meta Pixel и VK Рекламу — в базе и в файлах .tpl/.html (каталог элементов pdoTools и easycookies.migrate_paths, только внутри сайта и core/, без cache, vendor и т. п.; файл статичного элемента — через сам элемент; недоступный на запись файл помечается), вычитывает номера и Вебвизор, добавляет их в профиль и по желанию вырезает их код (блоки / и служебные комментарии; смешанные блоки остаются). Профиль перед этим сохраняется и включается. Прежнее содержимое элементов — в core/packages/easycookies/backups/, «Вернуть код» восстанавливает его, если элемент не правили после переноса.
• Global Privacy Control (флажок профиля, у новых баннеров по требованиям включён): при navigator.globalPrivacyControl маркетинговая категория и её сервисы для посетителя исчезают, в окне настроек — пояснение (gpcNotice, готовые тексты на 14 языках). Плагин по заголовку Sec-GPC: 1 сразу запрещает рекламные сигналы Consent Mode. В превью — галка «Сигнал GPC».
• Сниппет EasyCookiesAllowed: блок (tpl/tplElse, чанк или @INLINE) — только если посетитель разрешил категорию или сервис; без шаблонов — 1 или пусто для модификаторов. Учитывает ревизию, режим профиля (у простого до ответа всё разрешено) и GPC. Страницу с таким вызовом загрузчик перезагружает, когда разрешённое меняется.
• Контексты: у профиля — список контекстов (поле в форме, когда их больше одного); активный профиль — один на контекст, профиль с контекстами главнее общего. Плагин и сниппеты берут профиль контекста страницы; включение выключает только профили тех же контекстов.
• Экспорт профиля в JSON и импорт новым черновиком — без новых процессоров, на стороне админки; неизвестные сайту контексты при импорте отбрасываются.
• Таблица профилей: колонка «Контексты» (когда их на сайте больше одного; у активного общего профиля — «кроме …» тех контекстов, где активен свой) и «Согласия» — число записей журнала со ссылкой на журнал, отфильтрованный по профилю. Строки, как в гридах MODX, при наведении не подсвечиваются. Переключатель «Активный» — своей колонкой, в строке — «Настроить», а «Копия» и «Удалить» — в меню под кнопкой с тремя точками, оформленном как .x-menu менеджера (наведение в MODX 3 серое, в MODX 2 синее; стрелки, Escape). Дата изменения — в две строки: таблица помещается в окно 1440px.
• Сводка журнала — карточки итогов, график ответов по дням (решения стопкой, подсказка при наведении и фокусе; на длинном периоде — по несколько дней, не больше 60 столбиков) и доли категорий. Её рисует один модуль src/stats/ и на вкладке журнала под её фильтры, и в виджете рабочего стола «Согласия на cookie» за 30 дней (отдельная сборка vite.widget.config.ts в assets/components/easycookies/widget/). Числа считают EasyCookies::consentStats() и consentSeries(). При первой установке виджет встаёт последним на рабочий стол по умолчанию.
• Блок ревизии в редакторе — только у сохранённого профиля: новый ещё ни у кого согласия не спрашивал.
• Редактор: «К списку» — первой кнопкой в шапке. У превью постоянная раскладка: «Показать снова» и переключатель «Показывать» всегда на своих местах, параметры показа (язык, окно, сигнал GPC) — отдельной строкой; пока превью скрыто, они недоступны, а не пропадают. Список «Добавить язык» — двумя группами: языки с готовыми текстами и остальные языки, на которые переведён MODX (modLexicon::getLanguageList(), контроллер отдаёт их в конфиге админки), — их тексты начинаются с копии языка по умолчанию; внутри групп — по алфавиту на языке менеджера. Пункт меню строки — «Копировать».
• Интерфейс на английском, русском и таджикском. Общие слова — «Копировать», «Действия», «Сохранить», «Добавить», «Создать», «Экспорт», «Импорт», «Название», «Описание», «Загружается…» — берутся из словаря ядра MODX (core:default, он есть в MODX 2 и 3), а не дублируются в лексиконе компонента.
• Сборка: запущенный от root build.php отдаёт владельцу core/packages/ и кеш MODX (core/cache/) — иначе менеджер не мог записать кеш лексиконов и оставался с ключами вместо подписей.
• Таблицы сортируются по колонкам: щелчок по заголовку — по этой колонке, повторный — в обратную сторону, у активной колонки стрелка. Профили — по имени, числу согласий и дате изменения (у не менявшихся — создания); журнал — по дате, решению, профилю (по названию), странице, IP и ID. Сортирует сервер, поэтому порядок общий для всех страниц списка; колонки из JSON настроек профиля — вид, сервисы, языки — не сортируются.
• Правый клик по строке профиля открывает то же меню, что кнопка «⋯», — как контекстное меню грида MODX.