Installation & Aktivierung
Consenta viene installato come un normale Plugin WordPress. Hai bisogno di WordPress 5.8+ e PHP 7.4+.
Installa Plugin
Accedi in Il mio account e scarica l'ultimo consenta.zip.
Gehe zu WordPress Admin → Plugins → Installieren → Plugin hochladen. Wähle die ZIP-Datei und klicke Jetzt installieren.
Klicke auf Plugin aktivieren. Consenta erscheint danach im linken Menü unter Consenta.
Gehe zu Consenta → Einstellungen → Lizenz und gib deinen Lizenzschlüssel ein (aus der Bestätigungs-E-Mail).
Attiva licenza
Du findest deinen Schlüssel in der Bestätigungs-E-Mail (Format: CONSENTA-XXXX-XXXX-XXXX) oder unter Mein Konto → Lizenzen.
Apri Consenta → Impostazioni → Licenza, incolla la chiave e clicca su Attiva.
Nach erfolgreicher Aktivierung zeigt das Dashboard Aktiv und deinen Plan (Starter / Pro / Agency).
Cookie-Scan ausführen
Der Cookie Scanner durchsucht deine Website automatisch nach allen gesetzten Cookies und kategorisiert sie in die 6 Standard-Kategorien.
Gehe zu Consenta → Cookie Scanner und klicke Scan starten. Der Scanner durchsucht alle Seiten deiner Website.
Nach dem Scan siehst du alle gefundenen Cookies mit Name, Anbieter, Kategorie und Laufzeit. Prüfe die automatische Kategorisierung.
Ändere bei Bedarf die Kategorie einzelner Cookies per Dropdown. Die 6 Kategorien sind: Notwendig, Funktional, Statistik, Marketing, Präferenzen und Sonstige.
Dialog / Banner / Widget anpassen
Consenta bietet drei Consent-Elemente: den Consent-Dialog (Modal), den Cookie Banner und das Privacy Widget (Toggle). Alle sind unter Consenta → Darstellung konfigurierbar.
Consent-Kategorien verwalten
Consenta verwendet 6 Standard-Kategorien für die granulare Cookie-Verwaltung:
| Kategorie | Descrizione |
|---|---|
| Notwendig | Technisch erforderliche Cookies (immer aktiv, nicht abwählbar) |
| Funktional | Cookies für erweiterte Funktionalität (z.B. Sprache, Region) |
| Statistik | Analyse-Cookies (z.B. Google Analytics, Matomo) |
| Marketing | Werbe- und Remarketing-Cookies (z.B. Facebook Pixel, Google Ads) |
| Präferenzen | Cookies für persönliche Einstellungen (z.B. Theme, Layout) |
| Sonstige | Nicht kategorisierte Cookies |
Google Consent Mode v2
Google Consent Mode v2 wird vollständig unterstützt. Consenta sendet automatisch die richtigen Consent-Signale an Google-Dienste.
Configurazione
Unter Consenta → Einstellungen → Google Consent Mode den Toggle aktivieren.
Consenta setzt automatisch: ad_storage, analytics_storage, ad_user_data und ad_personalization basierend auf der Consent-Entscheidung des Besuchers.
IAB TCF konfigurieren
Das IAB Transparency & Consent Framework 2.0 wird vollständig unterstützt. TC-Strings werden automatisch generiert und verwaltet.
Unter Consenta → Einstellungen → IAB TCF den Toggle aktivieren.
Wähle die relevanten IAB-Vendoren für deine Website. Der TC-String wird automatisch generiert.
Geolocation aktivieren
Zeigt den Consent-Dialog nur Besuchern aus der EU oder konfigurierbaren Regionen. Besucher außerhalb der konfigurierten Regionen sehen keinen Banner.
Unter Consenta → Einstellungen → Geolocation den Toggle aktivieren.
Wähle die Länder/Regionen, in denen der Consent-Dialog angezeigt werden soll. Standard: alle EU-Länder.
Service Worker Blocking v1.4
Consenta verwendet einen dreistufigen Blocking-Mechanismus, der Cookies und Scripts noch vor der Ausführung abfängt. Das Service Worker Blocking ist die dritte und tiefste Schicht und aktiviert sich automatisch im Vollzustimmungsmodus (Full-Consent-Mode).
Die 3 Blocking-Schichten
| Schicht | Descrizione |
|---|---|
| Layer 1 — Script Blocking | Blockiert bekannte Third-Party-Scripts anhand einer Blockliste, bevor sie ins DOM eingefügt werden. |
| Layer 2 — Cookie Blocking | Überwacht document.cookie per Setter-Override und verhindert das Schreiben nicht-genehmigter Cookies. |
| Layer 3 — Service Worker | Fängt ausgehende Netzwerk-Requests auf Service-Worker-Ebene ab und blockiert Requests an Tracking-Endpunkte, bevor sie den Browser verlassen. |
WooCommerce v1.4
Die WooCommerce-Integration erkennt automatisch alle von WooCommerce gesetzten Cookies und ordnet sie den richtigen Consent-Kategorien zu. Tracking-Cookies von WooCommerce-Analytics und Marketing-Erweiterungen werden erst nach Consent geladen.
Automatisch blockierte Elemente
- WooCommerce Analytics — Tracking-Cookies (
wp_woocommerce_session_*) werden der Kategorie Statistik zugeordnet. - Marketing-Pixel — Facebook Pixel, Google Ads Conversion und andere Remarketing-Scripts werden blockiert, bis Marketing-Consent vorliegt.
- Session-Cookies — Warenkorb- und Session-Cookies werden als Notwendig kategorisiert und nie blockiert.
Deklarierte Cookies
| Cookie | Kategorie | Descrizione |
|---|---|---|
| woocommerce_cart_hash | Notwendig | Warenkorb-Hash für Cache-Invalidierung |
| woocommerce_items_in_cart | Notwendig | Speichert ob Artikel im Warenkorb liegen |
| wp_woocommerce_session_* | Funktional | Eindeutige Session-ID für den Checkout |
| tk_ai | Statistik | WooCommerce Analytics Tracking-Identifier |
Filter-Hook für Entwickler
Mit dem Filter consenta_woo_cookie_map kannst du die automatische Kategorisierung von WooCommerce-Cookies überschreiben:
// Eigene Zuordnung hinzufügen / Override mapping
$map['my_custom_cookie'] = 'marketing';
return $map;
});
Gutenberg-Block v1.4
Consenta liefert einen nativen Gutenberg-Block, mit dem du den Consent-Dialog oder einzelne Consent-Elemente direkt im Block-Editor platzieren kannst.
Block einfügen
Im Block-Editor auf + klicken und nach Consenta suchen. Der Block erscheint in der Kategorie Widgets.
Wähle in der rechten Seitenleiste die gewünschten Attribute (siehe Tabelle unten). Die Vorschau aktualisiert sich live.
Der Block rendert das Consent-Element an der gewählten Position auf der Seite.
Verfügbare Attribute
| Attribut | Typ | Descrizione |
|---|---|---|
| purpose | string | Consent-Kategorie, die der Block abfragt. Werte: functional, statistics, marketing, preferences. Standard: marketing. |
| show_type | string | Darstellung des Elements. Werte: dialog (Consent-Dialog), banner (Inline-Banner), toggle (einzelner Toggle-Switch). Standard: banner. |
| show_lifespan | boolean | Zeigt die Cookie-Laufzeit im Element an. Standard: false. |
CMP-Import v1.4
Migriere deine bestehende Cookie-Konfiguration von CookieBot, OneTrust oder Usercentrics mit wenigen Klicks zu Consenta. Der Importer übernimmt Cookie-Listen, Kategorien und Beschreibungen.
Schritt-für-Schritt-Anleitung
Exportiere deine Cookie-Liste aus CookieBot (CSV), OneTrust (JSON) oder Usercentrics (CSV). Gehe dazu in die jeweilige CMP-Verwaltung und nutze die Export-Funktion.
Gehe zu Consenta → Tools → CMP-Import und wähle deine bisherige CMP aus dem Dropdown.
Lade die exportierte Datei hoch. Consenta erkennt das Format automatisch und zeigt eine Vorschau der zu importierenden Cookies.
Prüfe die automatische Kategorie-Zuordnung. Die 6 Consenta-Kategorien werden den Kategorien der bisherigen CMP zugeordnet. Passe bei Bedarf einzelne Zuordnungen an.
Klicke Importieren. Bestehende Cookies werden nicht überschrieben, neue werden hinzugefügt.
Auto-Scan v1.4
Der Auto-Scan führt den Cookie-Scan automatisch in regelmäßigen Intervallen aus und benachrichtigt dich per E-Mail, wenn neue Cookies gefunden werden.
Configurazione
Gehe zu Consenta → Cookie Scanner → Auto-Scan und aktiviere den Toggle.
Wähle das Scan-Intervall: Täglich, Wöchentlich oder Monatlich. Standard: Wöchentlich.
Gib eine oder mehrere E-Mail-Adressen ein (kommagetrennt). Du erhältst eine E-Mail, wenn neue oder unbekannte Cookies gefunden werden.
Consent-Proof v1.4
Generiere einen PDF-Report als Nachweis deiner DSGVO-konformen Cookie-Consent-Konfiguration. Der Report eignet sich für Audits, Datenschutzbeauftragte und Behördenanfragen.
PDF-Report generieren
Gehe zu Consenta → Protokolle → Consent-Proof.
Wähle den Zeitraum für den Report (z.B. letzte 30 Tage, Quartal oder benutzerdefiniert).
Klicke PDF generieren. Der Report wird erstellt und als Download bereitgestellt.
Inhalt des Reports
- Consent-Statistiken — Akzeptierungsrate, Ablehnungsrate, Opt-in-Rate pro Kategorie
- Cookie-Inventar — Vollständige Liste aller deklarierten Cookies mit Kategorie, Anbieter und Laufzeit
- Blocking-Konfiguration — Aktive Blocking-Level und Service-Worker-Status
- Consent-Log-Auszug — Anonymisierte Stichprobe der letzten Consent-Einträge als Nachweis
- Konfigurationsübersicht — GCM-Status, TCF-Status, Geolocation-Einstellungen, Dialog-Konfiguration
Protokolle & Reports
Consenta protokolliert jede Consent-Entscheidung für die DSGVO-Nachweispflicht. Unter Consenta → Protokolle findest du alle Einträge.
Multi-Site Dashboard
Verwalte Cookie-Consent-Einstellungen für alle deine WordPress-Sites zentral. Consent-Statistiken aller Sites auf einen Blick.
Consenta → Sites → Site-Token kopieren (auf der Haupt-Site generiert).
Sul sito remoto: Consenta → Impostazioni → Multi-Site → Inserisci il Token e l'URL del sito principale.
Klicke Verbindung testen. Die Remote-Site sendet ab sofort Consent-Daten an die Haupt-Site.
REST API v1.4
Die REST API ermöglicht die programmgesteuerte Verwaltung von Consent-Einstellungen, Cookie-Listen, Protokollen und Remote-Sites. Alle Endpoints verwenden den Namespace /wp-json/consenta/v1/.
Authentifizierung
Alle Endpoints (außer /log) erfordern Authentifizierung. Generiere einen API-Token unter Consenta → Einstellungen → API und sende ihn als Bearer-Token im Authorization-Header:
POST /consenta/v1/log
Speichert einen Consent-Eintrag. Dieser Endpoint wird vom Frontend-Script automatisch aufgerufen und erfordert keine Authentifizierung (öffentlich).
| Parameter | Typ | Descrizione |
|---|---|---|
| categories | array | Akzeptierte Consent-Kategorien, z.B. ["necessary","statistics"] |
| uid | string | Anonymer Besucher-Identifier (vom Frontend generiert) |
| timestamp | integer | Unix-Timestamp der Consent-Entscheidung |
| user_agent | string | Browser User-Agent (optional, wird sonst aus dem Request gelesen) |
| tcf_string | string | IAB TCF TC-String, falls TCF aktiv (optional) |
POST /wp-json/consenta/v1/log
Content-Type: application/json
{
"categories": ["necessary", "functional", "statistics"],
"uid": "a1b2c3d4e5",
"timestamp": 1713200000
}
GET /consenta/v1/config
Gibt die aktuelle Consent-Konfiguration zurück (Cookie-Liste, Kategorien, Dialog-Einstellungen, Blocking-Level). Erfordert API-Token.
| Response-Feld | Typ | Descrizione |
|---|---|---|
| cookies | array | Liste aller deklarierten Cookies mit Name, Kategorie, Anbieter, Laufzeit |
| categories | array | Konfigurierte Consent-Kategorien mit Label und Beschreibung |
| blocking_level | integer | Aktives Blocking-Level (1–3) |
| gcm_enabled | boolean | Google Consent Mode v2 aktiv |
| tcf_enabled | boolean | IAB TCF aktiv |
| dialog_type | string | Dialog-Typ: modal, banner oder widget |
GET /wp-json/consenta/v1/config
Authorization: Bearer sk_live_xxxxxxxxxxxxx
POST /consenta/v1/revoke
Widerruft den Consent eines Besuchers anhand der UID. Nützlich für Datenlöschungsanfragen (DSGVO Art. 17). Erfordert API-Token.
| Parameter | Typ | Descrizione |
|---|---|---|
| uid | string | Anonymer Besucher-Identifier, dessen Consent widerrufen werden soll (Pflichtfeld) |
| reason | string | Grund des Widerrufs, z.B. user_request oder gdpr_erasure (optional) |
POST /wp-json/consenta/v1/revoke
Authorization: Bearer sk_live_xxxxxxxxxxxxx
Content-Type: application/json
{ "uid": "a1b2c3d4e5", "reason": "gdpr_erasure" }
GET /consenta/v1/stats
Gibt aggregierte Consent-Statistiken zurück. Erfordert API-Token.
| Query-Parameter | Typ | Descrizione |
|---|---|---|
| from | string | Startdatum im Format YYYY-MM-DD (optional, Standard: 30 Tage zurück) |
| to | string | Enddatum im Format YYYY-MM-DD (optional, Standard: heute) |
| group_by | string | Gruppierung: day, week oder month (optional, Standard: day) |
| Response-Feld | Typ | Descrizione |
|---|---|---|
| total_decisions | integer | Gesamtzahl der Consent-Entscheidungen im Zeitraum |
| accept_rate | float | Akzeptierungsrate (0.0–1.0) |
| reject_rate | float | Ablehnungsrate (0.0–1.0) |
| category_rates | object | Opt-in-Rate pro Kategorie, z.B. {"statistics": 0.72, "marketing": 0.34} |
| timeline | array | Zeitreihe mit Datenpunkten pro group_by-Intervall |
GET /wp-json/consenta/v1/stats?from=2026-03-01&to=2026-03-31&group_by=week
Authorization: Bearer sk_live_xxxxxxxxxxxxx
GET /consenta/v1/remote/settings
Ruft die Consent-Einstellungen einer verbundenen Remote-Site ab. Wird vom Multi-Site-Dashboard verwendet. Erfordert API-Token + Remote-Token.
| Header | Descrizione |
|---|---|
| Authorization | Bearer <api-token> — API-Token der Haupt-Site |
| X-Consenta-Remote-Token | <remote-token> — Token der Remote-Site (unter Consenta → Sites generiert) |
GET /wp-json/consenta/v1/remote/settings
Authorization: Bearer sk_live_xxxxxxxxxxxxx
X-Consenta-Remote-Token: rt_abc123def456
GET /consenta/v1/remote/entities
Listet alle verbundenen Remote-Sites mit Status, letztem Sync und Consent-Zusammenfassung. Erfordert API-Token.
| Response-Feld | Typ | Descrizione |
|---|---|---|
| entities | array | Liste der Remote-Sites |
| entities[].url | string | URL der Remote-Site |
| entities[].status | string | Verbindungsstatus: connected, disconnected, error |
| entities[].last_sync | string | ISO 8601 Zeitstempel des letzten Sync |
| entities[].total_consents | integer | Gesamtanzahl gespeicherter Consent-Einträge dieser Site |
GET /wp-json/consenta/v1/remote/entities
Authorization: Bearer sk_live_xxxxxxxxxxxxx
Fehler-Codes
| Code | Descrizione |
|---|---|
| 401 | Fehlender oder ungültiger API-Token |
| 403 | API-Zugang nicht im aktuellen Plan enthalten (Agency erforderlich) |
| 404 | Ressource nicht gefunden (z.B. unbekannte UID bei /revoke) |
| 422 | Ungültige Parameter (z.B. fehlendes Pflichtfeld) |
| 429 | Rate Limit überschritten (max. 120 Requests/Minute) |
X-RateLimit-Remaining und X-RateLimit-Reset zurückgegeben.White Label Setup
Ersetze das Consenta-Branding durch dein eigenes. Unter Consenta → Einstellungen → White Label konfigurierbar.
RTL-Support v1.4
Consenta unterstützt Right-to-Left-Sprachen (Arabisch, Hebräisch, Farsi u.a.) vollautomatisch. Wenn das HTML-Attribut [dir="rtl"] auf der Seite gesetzt ist, werden alle Consent-Elemente — Dialog, Banner, Widget und Admin-Dashboard — automatisch gespiegelt.
dir="rtl" automatisch, wenn eine RTL-Sprache als Seitensprache konfiguriert ist. Consenta erkennt dies und passt Layout, Text-Ausrichtung und Icon-Positionen entsprechend an.Troubleshooting
Consent-Dialog wird nicht angezeigt
Prüfe: (1) Ist die Lizenz aktiv? (2) Ist der Dialog unter Consenta → Darstellung aktiviert? (3) Gibt es JavaScript-Fehler in der Browser-Konsole? (4) Ist ein Caching-Plugin aktiv? Lösche den Cache.
Cookies werden trotz Ablehnung gesetzt
Prüfe das Blocking-Level unter Consenta → Einstellungen. Level 1 blockiert nur bekannte Cookies. Erhöhe auf Level 2 oder 3 für umfassendere Blockierung. Führe einen neuen Cookie-Scan aus um alle Cookies zu erfassen.
Google Consent Mode sendet keine Signale
Prüfe: (1) Ist der GCM-Toggle unter Einstellungen aktiviert? (2) Ist das Consenta-Script vor dem GTM-Script geladen? (3) Prüfe die Browser-Konsole auf Fehler.
Lizenzschlüssel funktioniert nicht
Verifica: (1) Nessuno spazio prima/dopo la chiave. (2) L'URL del sito corrisponde a quello utilizzato durante l'attivazione. (3) La licenza non è scaduta. Se i problemi persistono: Contatta il supporto.
FAQ
Consenta funziona con i Plugin di caching?
Ja. Consenta arbeitet vollständig clientseitig. Cookie Blocking und Consent-Dialog funktionieren unabhängig von Server-seitigem Caching.
Brauche ich Consenta zusätzlich zu Google Consent Mode?
Ja. Google Consent Mode ist nur die Schnittstelle — du brauchst eine Consent Management Platform (CMP) wie Consenta, die die Consent-Signale sendet.
Wie viele Sprachen werden unterstützt?
Über 30 Sprachen. Kompatibel mit WPML und Polylang.
Dove trovo la mia licenza dopo l'acquisto?
Nell'e-mail di conferma e in Il mio Account → Licenze.
Altre domande?
Il nostro team di supporto risponde di norma entro 24 ore.