Власні інтеграції
Власні інтеграції - це опціональний модуль, який дозволяє вставляти ваші власні фрагменти коду (сніпети) в заголовок або футер магазину. Кожен фрагмент отримує призначену категорію згоди й випускається через шлюз Менеджера згод, тож запускається лише тоді, коли відвідувач надасть згоду на дану категорію. Завдяки цьому коди інструментів на кшталт Meta Pixel, TikTok, Matomo чи Google Consent Mode завантажуються у спосіб, що поважає вибір користувача.
Код ви постачаєте самостійно. Плагін не виконує жодних HTTP-запитів з рівня PHP і не містить жорстко прописаних зовнішніх адрес. Це інструменти, які допомагають відповідально завантажувати ваші власні сніпети, вони не є юридичною консультацією і самі по собі не гарантують жодного конкретного правового ефекту.
Увімкнення модуля
Section titled “Увімкнення модуля”Модуль за замовчуванням вимкнений. Увімкніть його в WooCommerce > Polski > Модулі (секція “Власні інтеграції”). Після увімкнення фрагменти вставляються на фронті магазину, ніколи в адмін-панелі. Керування налаштуваннями потребує права manage_woocommerce.
Як це працює
Section titled “Як це працює”Кожен фрагмент “шлюзується” через Менеджер згод. Замість одразу виконуваного скрипту на сторінці з’являється плейсхолдер, який фронтенд Менеджера згод замінює на робочий скрипт лише після надання згоди на відповідну категорію. Фрагменти з категорією “Необхідні” запускаються завжди.
| Елемент | Поведінка |
|---|---|
| Місце випуску | Фрагменти із заголовка потрапляють до wp_head, з футера до wp_footer (пріоритет 30). |
| Лише фронт | Фрагменти ніколи не вставляються в адмін-панелі. |
| Шлюз згоди | Кожен фрагмент проходить через шлюз Менеджера згод і чекає на згоду для своєї категорії. |
| Необхідні | Фрагменти з категорією “Необхідні” працюють завжди, без очікування на згоду. |
| Немає трафіку з PHP | Плагін не надсилає жодних HTTP-запитів із сервера, завантажується виключно ваш код. |
Поля фрагмента
Section titled “Поля фрагмента”Список фрагментів повторюваний, ви можете додати будь-яку їх кількість. Кожен рядок має такі поля:
| Поле | Опис |
|---|---|
| Мітка | Читабельна назва фрагмента, допомагає розпізнати його у списку. Опціональна. |
| Розміщення | head (заголовок) або footer (футер). За замовчуванням футер. |
| Категорія згоди | Категорія з Менеджера згод, яку треба прийняти, щоб фрагмент запустився. Нерозпізнане значення трактується як “Необхідні”. |
| Код | Сам фрагмент коду. Рядки з порожнім кодом пропускаються. |
Обробка коду
Section titled “Обробка коду”Якщо ваш фрагмент обгорнутий в один тег <script>...</script>, його вміст вилучається і передається до шлюзу як вміст скрипту. Якщо ви вставляєте сам код JavaScript без тегу, він трактується як тіло inline-скрипту. Будь-який код поза тегом <script> пропускається, до шлюзу потрапляє лише вміст скрипту (до моменту надання згоди плейсхолдер залишається типу text/plain).
Налаштування
Section titled “Налаштування”Налаштування знаходяться на картці модуля в WooCommerce > Polski > Модулі. Список фрагментів зберігається як одне повторюване налаштування.
| Налаштування | За замовчуванням | Опис |
|---|---|---|
| Список фрагментів | (порожній) | Повторюваний список сніпетів (мітка, розміщення, категорія, код). |
Усунення проблем
Section titled “Усунення проблем”Фрагмент не запускається - перевірте, чи відвідувач надав згоду на категорію, призначену цьому фрагменту. Фрагменти, окрім “Необхідних”, чекають на згоду. Переконайтеся також, що Менеджер згод активний.
Фрагмент не з’являється в коді сторінки - переконайтеся, що поле коду не порожнє і що модуль увімкнений. Фрагменти не вставляються в адмін-панелі, перевіряйте їх на фронті магазину.
Частина коду зникає - до шлюзу потрапляє виключно вміст скрипту. Теги і код поза одним <script>...</script> пропускаються. Вставте код JavaScript або обгорніть його в один тег <script>.
Повідомлення про проблеми: github.com/wppoland/polski/issues