Шорткодове, CSS и разработчици

Шорткодове

Шорткод	Какво прави
[kncc_cookie_policy]	Декларацията за бисквитките: бисквитките по категории, текущият избор на посетителя и бутон „Промяна на предпочитанията за бисквитки“
[kncc_cookie_settings]	Връзка, която отваря отново настройките за бисквитки
[kncc_cookie_settings text="Manage cookies"]	Същата връзка с ваш собствен текст

Сложете връзката към настройките в долния колонтитул или в менюто си, за да могат посетителите винаги да променят избора си.

Отваряне на настройките от ваша собствена връзка

Всеки елемент с клас kncc-open-settings отваря банера при кликване:

<a href="#" class="kncc-open-settings">Cookie settings</a>

От JavaScript:

window.knccEditConsent();

Собствен CSS

В раздела Документация на добавката има CSS шаблон с всеки селектор, който добавката използва. Копирайте го в Облик → Персонализиране → Допълнителен CSS, в дъщерната си тема или в добавка за кодови фрагменти и премахнете коментарите от правилата, от които имате нужда.

• Ако правило не се прилага, добавете отпред .kncc-banner или добавете !important.
• При типография Стил на добавката правилата за шрифтовете използват !important. Превключете на Стил на темата за по-лесно презаписване.
• z-index на банера е 999999, а на плаващия бутон — 999998. Увеличете ги, ако темата ви показва слоеве над банера.

Бисквитката за съгласие

Изборът се съхранява в бисквитката от първа страна kncc_consent за една година, като JSON, кодиран за URL:

{ "necessary": true, "analytics": true, "marketing": false, "preferences": false, "choice": "custom", "timestamp": "2026-10-28T09:00:00.000Z" }

choice е accept, reject или custom. Четете я от собствения си код, ако ви трябва изборът на посетителя, но не я записвайте: използвайте банера или knccEditConsent().

Събития

• dataLayer: consent_update с consent_analytics, consent_marketing и consent_preferences, изпращано, когато посетителят направи избор. Вижте Google Consent Mode v2 и Tag Manager.
• Google Consent Mode: gtag('consent', 'update', …) със сигналите на разрешените категории.
• WP Consent API: изборът се споделя с добавките, които поддържат API-то.

Задържане на собствените ви скриптове

За да накарате собствения си скрипт да изчаква дадена категория, изведете го с тип text/plain и категорията:

<script type="text/plain" data-kncc-category="marketing" src="https://example.com/widget.js"></script>

Добавката го изпълнява, когато посетителят разреши тази категория. Без да пипате кода, същото прави правило Блокиране по адрес в раздела „Блокиране на скриптове“.

Филтри

Филтър	По подразбиране	Предназначение
kncc_block_html_scripts	true	Върнете false, за да изключите блокирането на скриптове в HTML кода на страницата и на скриптове, добавени по-късно
kncc_block_injected_scripts	true	Върнете false, за да изключите само защитния скрипт за скриптове, добавени след зареждането на страницата
kncc_block_iframes	true	Върнете false, за да изключите блокирането на YouTube и Vimeo

// Example: turn off the guard for scripts added after load.
add_filter('kncc_block_injected_scripts', '__return_false');