Krótkie kody, CSS i narzędzia dla programistów

Krótkie kody

Krótki kod	Co robi
[kncc_cookie_policy]	Deklaracja plików cookie: pliki cookie w podziale na kategorie, bieżący wybór odwiedzającego i przycisk Edytuj preferencje plików cookie
[kncc_cookie_settings]	Odnośnik, który ponownie otwiera ustawienia plików cookie
[kncc_cookie_settings text="Manage cookies"]	Ten sam odnośnik z własnym tekstem

Umieść odnośnik do ustawień w stopce lub menu, aby odwiedzający zawsze mogli zmienić swój wybór.

Otwieranie ustawień z własnego odnośnika

Każdy element z klasą kncc-open-settings otwiera baner po kliknięciu:

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

Z poziomu JavaScript:

window.knccEditConsent();

Niestandardowy CSS

Karta Dokumentacja we wtyczce zawiera szablon CSS ze wszystkimi selektorami używanymi przez wtyczkę. Skopiuj go do Wygląd → Dostosuj → Dodatkowy CSS, motywu potomnego lub wtyczki do fragmentów kodu i odkomentuj potrzebne reguły.

• Jeśli reguła nie działa, poprzedź ją klasą .kncc-banner lub dodaj !important.
• W typografii Stylu wtyczki reguły czcionek używają !important. Przełącz na Styl motywu, aby łatwiej nadpisywać style.
• Wartość z-index banera to 999999, a pływającego przycisku – 999998. Zwiększ je, jeśli motyw wyświetla nakładki nad banerem.

Plik cookie zgody

Wybór jest zapisywany w pliku cookie first-party kncc_consent na jeden rok, jako JSON zakodowany w formacie URL:

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

choice przyjmuje wartość accept, reject lub custom. Odczytuj go ze swojego kodu, jeśli potrzebujesz wyboru odwiedzającego, ale nie zapisuj go: użyj banera lub knccEditConsent().

Zdarzenia

• dataLayer: consent_update z consent_analytics, consent_marketing i consent_preferences, przekazywane, gdy odwiedzający dokona wyboru. Zobacz Google Consent Mode v2 i Tag Manager.
• Google Consent Mode: gtag('consent', 'update', …) z sygnałami dozwolonych kategorii.
• WP Consent API: wybór jest udostępniany wtyczkom obsługującym to API.

Wstrzymywanie własnych skryptów

Aby Twój własny skrypt czekał na kategorię, wstaw go z typem text/plain i kategorią:

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

Wtyczka uruchamia go, gdy odwiedzający zezwoli na tę kategorię. Bez zmieniania kodu to samo robi reguła Blokuj według adresu na karcie Blokowanie skryptów.

Filtry

Filtr	Domyślnie	Zastosowanie
kncc_block_html_scripts	true	Zwróć false, aby wyłączyć blokowanie skryptów w kodzie HTML strony i skryptów dodawanych później
kncc_block_injected_scripts	true	Zwróć false, aby wyłączyć tylko strażnika skryptów dodawanych po załadowaniu strony
kncc_block_iframes	true	Zwróć false, aby wyłączyć blokowanie YouTube i Vimeo

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