# ZetaLine Cookie

Переносимый плагин согласия для WordPress. Он не зависит от темы и не требует WooCommerce или Elementor. Открыть панель настроек можно шорткодом `[zetaline_cookie_settings]`, в том числе через виджет Shortcode в Elementor.

До выбора посетителя плагин удерживает только необязательные сервисы, которые оператор явно зарегистрировал. Встроенная Яндекс Метрика запускается после разрешения категории «Аналитика». Другими сервисами можно управлять через совместимые адаптеры или точное сопоставление WordPress handles скриптов и стилей.

В диагностике находится локальный справочник систем аналитики, рекламы, чатов и интеграций WordPress. На WordPress 6.9 и новее дополнительный HTML-сканер использует штатный фильтр готового шаблона и задерживает распознанные tracker-теги. Неизвестные и неоднозначные источники показываются для проверки и автоматически не блокируются. На WordPress 6.4–6.8 HTML-сканер недоступен; сопоставление зарегистрированных скриптов и поддерживаемые интеграции продолжают работать.

## Установка

1. Загрузите каталог `zetaline-cookie` в `/wp-content/plugins/` или установите ZIP в разделе «Плагины» WordPress.
2. Активируйте плагин.
3. Откройте ZetaLine Cookie в меню админки и настройте каждую необязательную систему.
4. На копии сайта проверьте согласие, отзыв, статистику, формы, вход, корзину и оформление заказа.

## Сканирование HTML

Сканер выключен по умолчанию и требует WordPress 6.9 или новее. Он обрабатывает готовый вывод через штатный фильтр WordPress и не открывает отдельный буфер вывода плагина. На WordPress 6.4–6.8 используйте сопоставление зарегистрированных скриптов и поддерживаемые интеграции.

Сканер не видит серверную обработку, закрытые контейнеры Google Tag Manager, код после загрузки страницы, обфускацию и запросы, которых нет в исходном HTML. Это не универсальный сетевой блокировщик. Не настраивайте как необязательные сервисы основные функции WordPress и WooCommerce: сессии, корзину, оформление заказа и вход.

## Журнал и ответственность оператора

Журнал хранится в базе данных самого сайта и содержит минимальную запись о действии и выбранных категориях. В ней нет IP-адреса, User-Agent, URL страницы или данных учётной записи. Деактивация плагина сохраняет настройки и журнал.

Плагин предоставляет технический механизм и сам по себе не гарантирует соблюдение закона. Оператор сайта определяет цели и основания обработки, проверяет поставщиков и потоки данных, а также поддерживает необходимые документы и уведомления.

Необязательный мост передаёт категории и поддерживаемый выбор сервисов отдельно установленному WP Consent API. По умолчанию он выключен и не блокирует произвольный код.

## Частые вопросы

### Плагин блокирует все cookie и сетевые запросы?

Нет. Он управляет только необязательными клиентскими сервисами, явно зарегистрированными адаптерами, карточками сервисов или включённым HTML-сканером. Серверные журналы, email, API и неизвестный код не контролируются.

### Отключает ли плагин WooCommerce?

Нет. Сессии, вход, корзина и оформление заказа должны работать. Не добавляйте эти функции в необязательные сервисы.

### Почему обнаруженный сервис не запускается после нажатия «Принять»?

Обнаружение не означает настройку. Проверьте источник и заполните карточку во вкладке «Другие сервисы» либо включите встроенный адаптер Яндекс Метрики. Пока обязательные сведения не заполнены, сервис остаётся выключенным.

### Как изменить внешний вид панели?

Во вкладке «Оформление» можно настроить расположение и отступы, типографику, цвета, кнопки, рамки, тени, ширину окна настроек и число колонок. Есть предпросмотр компьютера и телефона. Плагин не загружает внешние шрифтовые библиотеки.

### Нужен ли WP Consent API?

Нет. ZetaLine Cookie работает без него. Установите WP Consent API, только если его используют другие плагины, затем включите необязательный мост. На сайте должен быть один активный менеджер согласия.

## Скриншоты

1. Основные настройки управляют запросом согласия, HTML-сканированием и необязательным мостом WP Consent API.
2. Добавление статистики и других сервисов с указанием цели, поставщика, категории и источника.
3. Настройка внешнего вида панели согласия с предпросмотром компьютера и телефона.
4. Просмотр результатов HTML-сканирования, handles WordPress и возможных сервисов из справочника.

## Релиз 1.0.6

- После согласия внешние виджеты запускаются рядом со своей исходной разметкой. Это исправляет расположение интерактивной карты Яндекса и других скриптов, которым важен контейнер на странице.

## Релиз 1.0.5

- Сканер распознаёт встроенный код Метрики, который передаёт числовой ID счётчика через переменную `metricaId`.

## Релиз 1.0.4

- При повторном открытии окна настроек внутренняя прокрутка сбрасывается в начало, чтобы крестик закрытия оставался доступным.

## Релиз 1.0.3

- Исправлено удаление известных аналитических cookies с областью действия для домена и поддоменов при отзыве согласия.

## Релиз 1.0.2

- Исправлена загрузка локальных необязательных скриптов после разрешения соответствующей категории.

## Релиз 1.0.1

- Карта Яндекса и виджеты карты теперь ожидают разрешения внешних материалов.
- Скрипты атрибуции заказов WooCommerce ожидают разрешения аналитики; известные cookies `sbjs_*` удаляются при отзыве этого разрешения.

## Релиз 1.0.0

- Английская документация для каталога и русская локализация.
- Автор и сайт ZetaLine в метаданных; небольшая ссылка в настройках плагина.
- Исправления замечаний Plugin Check по обработке запросов, журналу, CSV-выгрузке и переводам.
