Shortcody, CSS a vývojáři

Shortcody [kncc_cookie_policy] a [kncc_cookie_settings], vlastní CSS, JavaScript API, události, cookie se souhlasem a filtry.

Shortcody

Shortcode	Co dělá
`[kncc_cookie_policy]`	Přehled cookies: cookies podle kategorií, aktuální volba návštěvníka a tlačítko Upravit předvolby cookies
`[kncc_cookie_settings]`	Odkaz, který znovu otevře nastavení cookies
`[kncc_cookie_settings text="Manage cookies"]`	Stejný odkaz s vaším vlastním textem

Dejte odkaz na nastavení do patičky nebo menu, aby mohli návštěvníci svou volbu kdykoli změnit.

Otevření nastavení z vlastního odkazu

Kterýkoli prvek s třídou kncc-open-settings po kliknutí otevře banner:

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

Z JavaScriptu:

window.knccEditConsent();

Vlastní CSS

Karta Dokumentace v pluginu obsahuje šablonu CSS se všemi selektory, které plugin používá. Zkopírujte ji do Vzhled → Přizpůsobit → Dodatečné CSS, do své podřízené šablony nebo do pluginu pro úryvky kódu a odkomentujte pravidla, která potřebujete.

Pokud se pravidlo neuplatní, přidejte před něj .kncc-banner nebo přidejte !important.
U typografie Styl pluginu používají pravidla písma !important. Pro snazší přepisování přepněte na Styl šablony.
Hodnota z-index banneru je 999999 a plovoucího tlačítka 999998. Zvyšte je, pokud vaše šablona zobrazuje překryvné vrstvy nad bannerem.

Volba se ukládá na jeden rok do cookie první strany kncc_consent jako JSON zakódovaný pro URL:

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

choice je accept, reject nebo custom. Pokud volbu návštěvníka potřebujete, čtěte ji z vlastního kódu, ale nezapisujte ji: použijte banner nebo knccEditConsent().

Události

dataLayer: consent_update s consent_analytics, consent_marketing a consent_preferences, odesláno při volbě návštěvníka. Viz Google Consent Mode v2 a Tag Manager.
Google Consent Mode: gtag('consent', 'update', …) se signály povolených kategorií.
WP Consent API: volba se sdílí s pluginy, které toto API podporují.

Zadržení vlastních skriptů

Aby váš vlastní skript čekal na kategorii, vypište ho s typem text/plain a kategorií:

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

Plugin ho spustí, když návštěvník danou kategorii povolí. Bez zásahu do kódu totéž udělá pravidlo Blokovat podle adresy na kartě Blokování skriptů.

Filtry

Filtr	Výchozí hodnota	Použití
`kncc_block_html_scripts`	`true`	Vraťte `false`, chcete-li vypnout blokování skriptů v HTML stránky i skriptů přidaných později
`kncc_block_injected_scripts`	`true`	Vraťte `false`, chcete-li vypnout jen hlídač skriptů přidaných po načtení stránky
`kncc_block_iframes`	`true`	Vraťte `false`, chcete-li vypnout blokování YouTube a Vimeo

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