Менеджер згод
Менеджер згод - це опціональний модуль, який додає до магазину нативний банер згод на файли cookie з категоріями, сигналами Google Consent Mode v2 та реєстром ухвалених рішень. Інші модулі можуть “блокувати” свої скрипти та iframe-фрейми так, щоб вони запускалися лише після надання відвідувачем відповідної згоди.
Модуль надає інструменти, які допомагають збирати й поважати вибори щодо згод. Він сам по собі не гарантує жодного конкретного правового наслідку і не замінює юридичну консультацію.
Увімкнення модуля
Section titled “Увімкнення модуля”Модуль за замовчуванням вимкнено. Увімкніть його в WooCommerce > Polski > Moduły (розділ “Менеджер згод”, ключ модуля consent_manager). Після увімкнення банер з’являється у футері магазину, а в панелі стає доступним вигляд Реєстр згод. Цей вигляд та експорт CSV вимагають дозволу manage_woocommerce.
Категорії згод
Section titled “Категорії згод”Банер використовує сталий набір категорій. Категорія “Необхідні” завжди увімкнена і її неможливо вимкнути. Решта три є опціональними, і відвідувач може їх увімкнути або вимкнути.
| Категорія | Ключ | За замовчуванням | Опис |
|---|---|---|---|
| Необхідні | necessary | завжди on | Потрібні для роботи магазину. Завжди надано, неможливо вимкнути. |
| Аналітика | analytics | увімкнена | Вимірювання трафіку і статистика. |
| Маркетинг | marketing | увімкнена | Реклама й ремаркетинг. |
| Преференції | preferences | увімкнена | Персоналізація і функції, що запам’ятовують вибори. |
За замовчуванням усі три опціональні категорії активні в банері. Кожну з них можна вимкнути в налаштуваннях модуля, якщо магазин нею не користується.
Google Consent Mode v2
Section titled “Google Consent Mode v2”Коли підтримку Google Consent Mode увімкнено (за замовчуванням), модуль виводить стандартний стан згод ще перед кодом gtag/GTM (у wp_head з пріоритетом 0). Усі сигнали стартують як відхилені (denied), за винятком security_storage, а потім негайно оновлюються на основі збереженого cookie, якщо відвідувач уже зробив вибір. Завдяки цьому gtag/GTM бачать правильний стан від першого виклику.
Категорії банера зіставляються із сигналами Consent Mode так:
| Категорія | Сигнали Consent Mode v2 |
|---|---|
| Аналітика | analytics_storage |
| Маркетинг | ad_storage, ad_user_data, ad_personalization |
| Преференції | functionality_storage, personalization_storage |
Після того, як відвідувач робить вибір, банер викликає gtag('consent', 'update', ...) з актуальним станом.
Умовне завантаження скриптів та iframe
Section titled “Умовне завантаження скриптів та iframe”Модуль надає контракт, який дозволяє іншим модулям запускати скрипти та iframe-фрейми лише після надання відповідної категорії. Заблокований код рендериться як <script type="text/plain" data-polski-consent="КАТЕГОРІЯ">, тож браузер не виконує його під час завантаження сторінки. Контролер фронтенду перетворює його на виконуваний скрипт лише тоді, коли категорію надано (одразу, якщо це дозволяє cookie, або після події polskiConsentChange).
Після зміни вибору банер:
- зберігає cookie
polski_consentзі списком наданих категорій, - викликає
gtag('consent', 'update', ...), - генерує подію вікна
polskiConsentChange, на яку реагують заблоковані скрипти, - надсилає рішення до реєстратора REST.
Реєстр згод
Section titled “Реєстр згод”Кожне рішення, збережене з банера, потрапляє до реєстру згод. Це вигляд лише для читання, доступний у панелі, коли модуль увімкнено, призначений для документування виборів відвідувачів. Реєстр не замінює юридичну консультацію.
| Стовпець | Опис |
|---|---|
| Дата | Дата й час збереженого рішення. |
| Категорія | Категорія, якої стосується рішення. |
| Рішення | ”Надано” або “Відхилено”. |
| Користувач | ID користувача або “Гість” для неавторизованих. |
| IP адреса | IP адреса відвідувача (якщо доступна). |
| Версія вмісту | Хеш вмісту банера, який відвідувач фактично бачив. |
Кожен збережений вибір пов’язаний з версією вмісту банера (хешем заголовка, тексту й списку категорій), завдяки чому відомо, яке саме формулювання відвідувач прийняв.
Експорт CSV
Section titled “Експорт CSV”Кнопка Експортувати CSV завантажує повний реєстр як файл CSV. Експорт містить стовпці: id, created_at, category, granted, user_id, ip_address, user_agent, consent_version. Експорт вимагає дозволу manage_woocommerce і захищений nonce.
Налаштування
Section titled “Налаштування”Налаштування знаходяться на картці модуля в WooCommerce > Polski > Moduły.
| Налаштування | За замовчуванням | Опис |
|---|---|---|
| Категорія: Аналітика | увімкнена | Чи показується категорія аналітики в банері. |
| Категорія: Маркетинг | увімкнена | Чи показується категорія маркетингу в банері. |
| Категорія: Преференції | увімкнена | Чи показується категорія преференцій у банері. |
| Заголовок | (порожньо) | Опціональний заголовок банера. |
| Текст банера | стандартний текст | Головний текст банера (допускає базовий HTML). |
| Етикетка “Прийняти все" | "Accept all” | Текст кнопки прийняття всього. |
| Етикетка “Відхилити все" | "Reject all” | Текст кнопки відхилення опціональних категорій. |
| Етикетка “Керувати" | "Manage” | Текст кнопки, що відкриває вибір категорій. |
| Етикетка “Зберегти вибір" | "Save choices” | Текст кнопки збереження обраних категорій. |
| Позиція | низ | Розташування банера: верх, низ або середина. |
| Google Consent Mode | увімкнено | Чи виводити сигнали Google Consent Mode v2. |
Усунення несправностей
Section titled “Усунення несправностей”Банер не з’являється - переконайтеся, що модуль увімкнено в WooCommerce > Polski > Moduły і що тема викликає wp_footer(). Банер рендериться у футері.
Теги Google не реагують на згоду - перевірте, чи опція Google Consent Mode увімкнена та чи код gtag/GTM завантажується після сигналів Consent Mode (вони виводяться дуже рано в wp_head).
Заблокований скрипт не запускається - скрипт стартує лише після надання відповідної категорії. Перевірте, що відвідувач надав категорію та що скрипт було згенеровано через контракт блокування.
Повідомлення про проблеми: github.com/wppoland/polski/issues