Shortcodes, CSS und Entwickler

Die Shortcodes [kncc_cookie_policy] und [kncc_cookie_settings], eigenes CSS, die JavaScript-API, Ereignisse, das Einwilligungs-Cookie und Filter.

Shortcodes

Shortcode	Funktion
`[kncc_cookie_policy]`	Die Cookie-Erklärung: Cookies pro Kategorie, die aktuelle Auswahl des Besuchers und eine Schaltfläche „Cookie-Auswahl ändern“
`[kncc_cookie_settings]`	Ein Link, der die Cookie-Einstellungen wieder öffnet
`[kncc_cookie_settings text="Manage cookies"]`	Derselbe Link mit Ihrem eigenen Text

Setzen Sie den Einstellungslink in Ihren Footer oder in Ihr Menü, damit Besucher ihre Auswahl jederzeit ändern können.

Einstellungen über einen eigenen Link öffnen

Jedes Element mit der Klasse kncc-open-settings öffnet beim Anklicken das Banner:

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

Per JavaScript:

window.knccEditConsent();

Eigenes CSS

Der Tab Dokumentation im Plugin enthält eine CSS-Vorlage mit allen Selektoren, die das Plugin verwendet. Kopieren Sie sie nach Design → Customizer → Zusätzliches CSS, in Ihr Child-Theme oder in ein Code-Snippets-Plugin und entfernen Sie bei den Regeln, die Sie brauchen, die Kommentarzeichen.

Wenn eine Regel nicht greift, stellen Sie ihr .kncc-banner voran oder ergänzen Sie !important.
Bei der Typografie im Plugin-Stil verwenden die Schriftregeln !important. Wechseln Sie zum Theme-Stil, um sie leichter zu überschreiben.
Der z-index des Banners ist 999999, der der schwebenden Schaltfläche 999998. Erhöhen Sie die Werte, wenn Ihr Theme Overlays über dem Banner anzeigt.

Die Auswahl wird ein Jahr lang im First-Party-Cookie kncc_consent gespeichert, als URL-codiertes JSON:

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

choice ist accept, reject oder custom. Lesen Sie es in Ihrem eigenen Code, wenn Sie die Auswahl des Besuchers brauchen, schreiben Sie es aber nicht: Verwenden Sie das Banner oder knccEditConsent().

Ereignisse

dataLayer: consent_update mit consent_analytics, consent_marketing und consent_preferences, gesendet, wenn der Besucher eine Auswahl trifft. Siehe Google Consent Mode v2 und Tag Manager.
Google Consent Mode: gtag('consent', 'update', …) mit den Signalen der erlaubten Kategorien.
WP Consent API: Die Auswahl wird mit Plugins geteilt, die die API unterstützen.

Eigene Skripte zurückhalten

Damit Ihr eigenes Skript auf eine Kategorie wartet, geben Sie es mit dem Typ text/plain und der Kategorie aus:

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

Das Plugin führt es aus, wenn der Besucher diese Kategorie erlaubt. Ohne Eingriff in den Code erreicht eine Regel unter Nach Adresse blockieren im Tab „Skript-Blockierung“ dasselbe.

Filter

Filter	Standard	Verwendung
`kncc_block_html_scripts`	`true`	Geben Sie `false` zurück, um die Blockierung von Skripten im HTML der Seite und von später hinzugefügten Skripten auszuschalten
`kncc_block_injected_scripts`	`true`	Geben Sie `false` zurück, um nur den Guard für Skripte auszuschalten, die nach dem Laden der Seite hinzugefügt werden
`kncc_block_iframes`	`true`	Geben Sie `false` zurück, um die Blockierung von YouTube und Vimeo auszuschalten

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