=== Cookie Consent | Cover72 ===
Contributors: cover72
Tags: cookie consent, dsgvo, gdpr, privacy, consent management
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0.11
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Selbst gehostete Einwilligungsloesung (DSGVO/TDDDG). Blockt Drittanbieter-Inhalte serverseitig, bevor sie den Browser erreichen.

== Beschreibung ==

Portierung der Joomla-Erweiterung "cover72 Cookie Consent" nach WordPress. Uebliche Consent-Banner laden ihr eigenes Skript von einem fremden Server und raeumen dann im Browser auf - zu diesem Zeitpunkt ist eine Verbindung zum Drittanbieter aber oft schon aufgebaut. Dieses Plugin greift stattdessen in die fertig gerenderte Seite ein (Ausgabepufferung ueber `template_redirect`) und liefert Drittanbieter-Einbindungen erst gar nicht scharf aus:

* `<link href="fonts.googleapis.com/...">` wird ohne `href` ausgeliefert
* `<script src="...">` bekommt `type="text/plain"` und laedt nicht
* `<iframe src="...">` bekommt eine erklaerende Platzhalter-Box davor
* `preconnect`/`dns-prefetch`-Hinweise werden entfernt
* Inline-Schnipsel ohne `src` (z. B. das Google-Tag-Manager-Snippet) werden erkannt und stillgelegt
* Leere Widget-Container (Elfsight, Common Ninja, ...) bekommen eine Platzhalter-Box

Nach der Einwilligung setzt das mitgelieferte JavaScript (ohne Abhaengigkeiten) die Attribute zurueck und der Inhalt laedt nach.

= Was mitgeliefert wird =

* Banner in drei Varianten: Box unten links, Leiste ueber volle Breite, mittiger Dialog
* "Alle akzeptieren" und "Nur notwendige" gleich gestaltet (kein Dark Pattern)
* Kategorien einzeln wählbar: Notwendig, Schriftarten, Karten, Videos, Soziale Netzwerke, Statistik, Chatfunktion, Sonstige externe Inhalte, Formularschutz (standardmaessig aus)
* Rund 60 vorkonfigurierte Anbieter (Google Fonts/Maps/Analytics/Tag Manager/Ads/reCAPTCHA, YouTube, Vimeo, Facebook, Instagram, LinkedIn, TikTok, Matomo, Plausible, Elfsight, Tawk.to, Crisp, Intercom, HubSpot und weitere)
* Einwilligungsprotokoll in einer eigenen Datenbanktabelle (Nachweispflicht nach Art. 7 Abs. 1 DSGVO), Ansicht und CSV-Export im Backend
* Dauerhafter Schalter am Bildschirmrand zum Widerrufen, wahlweise mit Beschriftung und eigener Farbe fuer das Cookie-Symbol
* Hinweis vor externen Links zu erkannten Anbietern (z. B. Calendly), bevor die Seite verlassen wird - der Link bleibt dabei immer klickbar
* Kurzschreibweise fuer Einbettungen: `<div data-service="Youtube" data-id="..."></div>`
* JavaScript-Schnittstelle: `Cover72Consent.has()`, `.get()`, `.open()`, `.acceptAll()`, `.rejectAll()`, `.revoke()`
* Shortcode `[c72_consent_link]` fuer einen Widerrufs-Link im Beitrag
* Textbaustein fuer die WordPress-eigene Datenschutzerklaerung (Werkzeuge -> Datenschutz)
* Tastaturbedienung, Fokusfalle im Dialog, `prefers-reduced-motion`, Dunkelmodus nur fuer das Banner
* Deutsch als Ausgangssprache, ueber Standard-WordPress-Uebersetzung (.pot in /languages) anpassbar

== Installation ==

1. Plugin-Ordner nach `wp-content/plugins/` hochladen (oder als ZIP ueber "Plugins -> Installieren -> Plugin hochladen")
2. Aktivieren
3. Unter *Cookie Consent -> Einstellungen* die Reiter durchgehen (Darstellung, Dienste, Texte & Aussehen, Protokoll, Erweitert)
4. Im privaten Fenster pruefen: vor einer Entscheidung darf kein externer Request abgehen

Beim Umstieg von einem anderen Dienst: die Option *Fremde Consent-Skripte entfernen* (Reiter Erweitert) filtert cockpit.legal, Cookiebot, Usercentrics und consentmanager aus der Ausgabe.

== Einrichtung ==

**Darstellung** - Links zu Datenschutz und Impressum, Position, Akzentfarbe, Guiltigkeit der Einwilligung, Version der Einwilligung (hochzaehlen, um alle Besucher erneut zu fragen), Schalter am Bildschirmrand inkl. eigener Symbolfarbe.

**Dienste** - Kategorien einzeln an/aus. Zusaetzliche Anbieter und weitere Widget-Container lassen sich je Zeile im Format `host-fragment|kategorie|Anzeigename` eintragen; eigene Hosts (CDN, zweite Domain) werden nie blockiert.

**Texte & Aussehen** - eigene Banner-Ueberschrift/-Einleitung, eigenes CSS.

**Protokoll** - Protokollierung an/aus, Besucherkennung (Hash/gekuerzte IP/keine), Aufbewahrungsdauer. Die Eintraege selbst stehen unter *Cookie Consent -> Protokoll*: sortierbar, durchsuchbar, filterbar, mit CSV-Export und "Abgelaufene loeschen".

**Erweitert** - Inline-Skripte pruefen, fremde Consent-Skripte entfernen, Hinweis vor externen Links, Diagnose-Kommentar am Seitenende.

== Sicherheit ==

* Der Protokoll-Endpunkt (`admin-ajax.php?action=cover72_consent_log`) prueft die `Origin`, akzeptiert nur bekannte Vorgangsarten und Kategorien, begrenzt auf 12 Eintraege je Besucherkennung in 5 Minuten und 120 insgesamt pro Minute.
* CSV-Export und "Abgelaufene loeschen" verlangen `manage_options` und einen gueltigen WordPress-Nonce.
* Die Besucherkennung wird als HMAC-SHA256 mit dem WordPress-Salt gebildet (Modus "Hash") - nicht auf eine IP-Adresse zurueckrechenbar.
* CSV-Zellen, die mit `=`, `+`, `-` oder `@` beginnen, bekommen ein fuehrendes Apostroph (Schutz vor Formel-Injektion in Excel/LibreOffice).
* Datenschutz- und Impressum-Adresse werden auf das Schema geprueft; `javascript:` wird verworfen.

== Updates ==

Das Plugin prueft periodisch (und beim Klick auf "Nach Aktualisierungen suchen" in *Plugins -> Installiert*) die eigene, selbst gehostete Update-Quelle unter `https://update.cover72.de/wordpress/cover72-cookie-consent.json` - nach demselben Prinzip wie die Joomla-Erweiterungen ueber `update.cover72.de/joomla/`. Ist dort eine neuere Versionsnummer hinterlegt, zeigt WordPress den normalen "Update verfuegbar"-Hinweis samt Update-Button; ein Klick darauf laedt das in der JSON-Datei genannte ZIP-Archiv herunter und ersetzt die Installation - kein Deaktivieren/Loeschen/erneutes Hochladen mehr noetig.

Fuer eine neue Version muessen auf dem Server zwei Dinge aktualisiert werden:

1. Das ZIP-Archiv der neuen Version, z. B. unter `https://update.cover72.de/wordpress/dateien/cover72-cookie-consent-1.0.7.zip`
2. Die JSON-Datei `https://update.cover72.de/wordpress/cover72-cookie-consent.json` mit mindestens `version` (muss zur Versionsnummer im Plugin-Header passen) und `download_url` (Link auf das ZIP aus Schritt 1); optional `homepage`, `requires`, `tested`, `requires_php`, `last_updated`, `sections.description`/`sections.changelog` fuer die Detailansicht sowie `sha256` (siehe unten).

Ist der Server nicht erreichbar, bleibt die Anzeige einfach unveraendert - die eigentliche Blockade und das Banner sind davon nie betroffen. Die Update-Quelle laesst sich abschalten, indem die Konstante `COVER72_CONSENT_UPDATE_URL` vor dem Laden des Plugins auf einen leeren String gesetzt wird (z. B. in der `wp-config.php`).

Wichtig bei einem Wechsel der Update-Adresse (wie hier von `cover72.de/Wordpress_Software/` zu `update.cover72.de/wordpress/`): eine bereits installierte Version hat die ALTE Adresse fest in ihrer eigenen Datei stehen und fragt deshalb weiterhin dort nach, egal was auf der neuen Adresse liegt. Der automatische Update-Button greift diesmal also nicht - die auf die neue Adresse zeigende Version muss einmalig von Hand eingespielt werden (Plugin deaktivieren, loeschen, neues ZIP hochladen, aktivieren). Danach findet der automatische Mechanismus auch kuenftige Updates wie gewohnt.

= Pruefsumme des Archivs (optional, empfohlen) =

Enthaelt die JSON-Datei zusaetzlich `sha256` mit dem SHA-256-Hash des ZIP-Archivs (z. B. `shasum -a 256 cover72-cookie-consent-1.0.7.zip` bzw. `Get-FileHash -Algorithm SHA256`), wird die heruntergeladene Datei vor der Installation dagegen geprueft; stimmt sie nicht ueberein, bricht WordPress die Installation mit einer Fehlermeldung ab, statt das Archiv einzuspielen. Fehlt das Feld, laeuft das Update wie bisher ohne Pruefung - das Feld ist rein additiv und aendert am bestehenden Verhalten nichts. Diese Kontrolle schuetzt nur gegen ein waehrend der Uebertragung oder auf dem Server veraendertes Archiv; wer selbst Schreibzugriff auf den Serverpfad hat, koennte auch die hinterlegte Pruefsumme mit anpassen - entscheidend bleibt deshalb, die Zugangsdaten zu `update.cover72.de` (FTP/SFTP, Hosting-Login) gut zu schuetzen.

== Deinstallation ==

Beim Loeschen des Plugins (nicht beim Deaktivieren) werden die Protokolltabelle und alle Einstellungen entfernt. Wer das Protokoll aufheben moechte, exportiert vorher die CSV.

== Changelog ==

= 1.0.11 =
* Neu: einzelne Elfsight-Widgets lassen sich jetzt ueber ihre Widget-ID eigen benennen (z. B. "Elfsight - Google Maps" statt nur "Elfsight"), damit die Platzhalter-Box beim Anzeigen mehrerer Elfsight-Widgets auf einer Seite erkennen laesst, um welchen Inhalt es jeweils geht. Siehe Feld "Weitere Widget-Container" im Reiter Dienste - die Widget-ID steht im Klassennamen der Platzhalter-Box ("elfsight-app-…").
* Fix: eigene Eintraege im Feld "Weitere Widget-Container" werden jetzt VOR den eingebauten Zuordnungen geprueft (wie bei den Hosts ohnehin schon), damit eine genauere eigene Regel eine allgemeinere eingebaute Regel (z. B. "elfsight-app-") ueberschreiben kann.

= 1.0.10 =
* Neu: Elfsight-Widgets (z. B. Bewertungen, Instagram-Feed, Formulare) sind jetzt eine eigene Kategorie ("Elfsight-Widgets") statt Teil von "Sonstige externe Inhalte" - im Banner separat wähl- und abwählbar, ebenso in den Einstellungen (Reiter Dienste). Hinweis: nach dem Update die Zahl bei "Revision" erhöhen, damit bereits entschiedene Besucher erneut gefragt werden - sonst bleibt Elfsight für sie auf dem alten Stand ("erlaubt", weil es vorher zu "Sonstige externe Inhalte" gehörte).

= 1.0.9 =
* Neu: die Platzhalter-Box, die anstelle eines blockierten Inhalts erscheint, nennt jetzt zusaetzlich zum Dienstnamen auch die passende Kategorie-Beschreibung (z. B. bei einer Fotogalerie "Eingebettete Inhalte weiterer Anbieter..." oder bei Google Maps "Zeigt eingebettete Karten an..."). Macht direkt an Ort und Stelle deutlich, was genau blockiert wird - bislang stand das nur in den Banner-Einstellungen.

= 1.0.8 =
* Neu: eigene Farbe fuer das Cookie-Symbol im Schalter am Bildschirmrand (Reiter Darstellung, Feld "Farbe des Cookie-Symbols"). Leer lassen behaelt das bisherige Verhalten (automatisch Schwarz oder Weiss, je nach Lesbarkeit auf der Akzentfarbe); ein eigener Farbcode faerbt nur das Symbol, nicht die Beschriftung daneben.

= 1.0.7 =
Ergebnis einer Sicherheitspruefung, vier Punkte behoben:
* Neu: optionale Pruefsummenkontrolle (`sha256`) des Update-Archivs vor der Installation - siehe Abschnitt "Pruefsumme des Archivs" unter Updates.
* Haerter: der oeffentliche Protokoll-Endpunkt prueft jetzt zusaetzlich den `Referer`-Kopf, wenn `Origin` fehlt, und begrenzt Anfragen ohne beide Kopfzeilen deutlich enger (20 statt 120 pro Minute) - ohne dabei echte Einwilligungs-Nachweise zu verwerfen.
* Fix: die Blockade erkennt Adressen jetzt auch in nicht in Anfuehrungszeichen gesetzten HTML-Attributen (`<script src=... >` statt nur `<script src="...">`), wie es HTML5 ebenfalls erlaubt.
* Fix: die Google-Maps-Kurzschreibweise (erweiterte `pb`-Einbettung) entfernt jetzt Zeichen ohne legitime Bedeutung (`< > " '`) aus der uebergebenen Kennung, zusaetzlich zur ohnehin bereits escapten Ausgabe.
* Geaendert: Update-Quelle liegt jetzt unter `update.cover72.de/wordpress/` statt `cover72.de/Wordpress_Software/` (Umzug der Serveradresse, analog zu `update.cover72.de/joomla/`).

= 1.0.6 =
* Neu: Hinweis vor externen Links (Reiter Erweitert, standardmaessig eingeschaltet). Ein Link zu einem erkannten Anbieter (z. B. Calendly) bleibt voll funktionsfaehig, zeigt aber vor dem Verlassen der Seite einen kurzen Hinweis - auszer die betroffene Kategorie wurde bereits erlaubt.

= 1.0.5 =
* Geaendert: Anzeigename im Backend von "cover72 Cookie Consent" zu "Cookie Consent | Cover72".
* Neu: Copyright-/Lizenzhinweis (Cover72 | Timo Biehl, GPLv2 oder spaeter) im Hauptplugin-Datei-Kopf ergaenzt.

= 1.0.4 =
* Neu: automatische Update-Pruefung gegen die eigene Update-Quelle (update.cover72.de, wie bei den Joomla-Erweiterungen). WordPress zeigt ab jetzt selbst den "Update verfuegbar"-Hinweis samt Update-Button, sobald dort eine neuere Version hinterlegt ist - kein manuelles Deaktivieren/Loeschen/Hochladen mehr noetig.

= 1.0.3 =
* Fix: Bannertexte, Protokoll-Badge, Schliessen-Symbol und die Links zu Datenschutz/Impressum verwendeten `rem` und richteten sich damit nach der Grundschrift der jeweiligen Website statt nach der eigenen. Auf Seiten, die `html { font-size: 62.5% }` oder aehnliches setzen (verbreitete Technik fuer einfache rem-Rechnung), wirkte das Banner dadurch winzig - sichtbar u. a. an sehr kleinen Impressum-/Datenschutz-Links. Umgestellt auf `em`, zusaetzlich Link-Schrift leicht vergroessert.
* Fix: Der Schalter am Bildschirmrand (FAB) erbte aus demselben Grund die Schriftgroesse der Seite statt eine eigene, feste Grundlage zu haben; jetzt unabhaengig von der Website-Schriftgroesse.
* Neu: HubSpot (Tracking-Skript, Formulare, Chat-Widget) als vorkonfigurierter Anbieter ergaenzt - lief bisher unter keiner Kategorie und wurde deshalb nicht blockiert.

= 1.0.2 =
* Fix: Speichern auf einem Reiter (z. B. "Dienste") setzte die Einstellungen der anderen Reiter (z. B. den Schalter am Bildschirmrand) fälschlich zurück, weil jedes Formular nur seine eigenen Felder überträgt. Jeder Reiter speichert jetzt ausschließlich seine eigenen Werte, alle anderen bleiben unangetastet.
* Fix: Rücksprung zur Einstellungsseite nach dem Speichern weiter abgesichert (Ausgabepuffer gegen fremde Warnungen vor dem Redirect-Header; ein ungültiger Sicherheits-Token führt jetzt zu einer Meldung mit Rücksprung statt zu einer Sackgasse).

= 1.0.1 =
* Fix: Einstellungsseite kehrte nach dem Speichern nicht zuverlässig zurück ("headers already sent", weil der Redirect erst im Seiten-Callback nach admin-header.php lief). Speichern + Redirect laufen jetzt auf dem frühen load-{hook}-Zeitpunkt.

= 1.0.0 =
* Erste Fassung: Portierung der Joomla-Erweiterung cover72 Cookie Consent 1.8.6 nach WordPress.