Individuelle Anfrage

Dokumentation

Joomla-Plugin: Anleitung

1. Voraussetzungen

  • Joomla 4.4, 5.x oder 6.x mit PHP 8.0 oder neuer
  • ein cookieblocker-Abo für die Website – das Plugin ist die Anbindung an den Dienst cookieblocker, der in Deutschland betrieben wird (Preise)
  • Site-ID und API-Schlüssel der Website aus dem cookieblocker-Dashboard

Das Plugin selbst steht unter der GNU General Public License (Lizenz).

2. Installation

Vorkonfiguriertes Paket (empfohlen)

  1. Im cookieblocker-Dashboard unter Website → Installation das Joomla-Paket herunterladen. Es enthält die Zugangsdaten Ihrer Website.
  2. In Joomla unter System → Installieren → Erweiterungen das ZIP hochladen.
  3. Fertig: Das Plugin übernimmt die Zugangsdaten, löscht sie aus dem Paket, aktiviert sich und lädt Banner und Einstellungen.

Allgemeines Paket

  1. Das Paket installieren wie oben.
  2. Unter System → Plugins „System – cookieblocker“ öffnen.
  3. Site-ID und API-Schlüssel (beginnt mit cbk_) eintragen, das Plugin aktivieren und speichern.

Der Status oben in den Plugin-Einstellungen zeigt, ob die Verbindung steht. Mit Jetzt synchronisieren holt das Plugin den aktuellen Stand sofort.

3. Einstellungen

Reiter „Plugin“

  • Status: Verbindung, Stand der Konfiguration, Zahl der automatisch blockierten und lokal ausgelieferten Dienste, Plugin-Version.
  • Site-ID und API-Schlüssel: stehen im Dashboard unter Website → Installation.

Reiter „Erweitert“

  • cookieblocker-Hinweis ausblenden (ab der nächsten Plugin-Version): blendet den kleinen Hinweis „cookieblocker schützt Ihre Privatsphäre“ mit Link auf cookieblocker.de in Video-, Karten- und Bild-Platzhaltern aus – unabhängig von der Einstellung im Dashboard.
  • Automatische Updates: Standard aus. Eingeschaltet installiert das Plugin neue Versionen höchstens einmal am Tag selbst.
  • API-Adresse: nur für Tests ändern. Leer bedeutet https://cdn.cookieblocker.de.

Design, Texte, Sprachen und Dienste des Banners stellen Sie im Dashboard ein. Änderungen kommen sofort auf der Website an; zusätzlich prüft das Plugin alle 5 Minuten beim Seitenaufruf, ob es etwas Neues gibt.

4. Platzhalter für Datenschutzerklärung, Beiträge und Menü

Auf der Datenschutzseite, die im Dashboard eingetragen ist, erscheinen Datenschutz-Text und Cookie-Übersicht automatisch am Ende des Inhalts. Gezielt platzieren lassen sie sich mit diesen Platzhaltern in Beiträgen und Modulen:

  • {cookieblocker_privacy} – kompletter Abschnitt zu Cookies und Diensten mit Cookie-Übersicht
  • {cookieblocker_declaration} – nur die Cookie-Übersicht
  • {cookieblocker_settings} – Link „Cookie-Einstellungen“, eigener Text mit {cookieblocker_settings text="…"}
  • {cookieblocker_revoke} – Link „Einwilligung widerrufen“

Im Menü: einen Menüeintrag vom Typ „URL“ mit der Adresse #cb-settings anlegen – er öffnet die Cookie-Einstellungen.

5. Was das Plugin blockiert

Das Plugin schreibt jede Seite um, bevor Joomla sie ausliefert – unabhängig von Template und Erweiterungen:

  • Der Banner steht als Erstes im <head>.
  • Scripts einwilligungspflichtiger Dienste laden erst nach der Zustimmung.
  • YouTube, Vimeo, Karten (auch das YOOtheme-Kartenelement), Instagram, Calendly, reCAPTCHA und Widgets erscheinen als Zwei-Klick-Platzhalter. YouTube-Vorschaubilder liegen auf Ihrem Server.
  • Ladehinweise (preconnect, dns-prefetch, preload) zu blockierten Diensten werden entfernt.
  • Mit Lokal einbinden im Dashboard lädt das Plugin Google Fonts und Bibliotheken von CDNs auf Ihren Server und liefert sie selbst aus.

Welche Dienste blockiert werden, legt das Dashboard fest. Der nächtliche Scan findet neue Dienste, eine KI bestimmt unbekannte – mehr dazu auf der Seite KI-Cookie-Banner.

6. Updates

Neue Versionen erscheinen wie gewohnt unter System → Updates (und in Verwaltungswerkzeugen, die den Joomla-Update-Server nutzen). Jedes Paket ist digital signiert: Das Plugin prüft vor der Installation eine Signatur über alle Dateien und lehnt veränderte oder ältere Pakete ab. Ihre Einstellungen bleiben bei Updates erhalten.

7. Umstieg von einem anderen Cookie-Banner

Deaktivieren Sie bisherige Cookie-Banner- und Zwei-Klick-Erweiterungen sowie den Cookie-Modus Ihres Templates (z. B. in YOOtheme). Zwei Banner gleichzeitig führen zu doppelten Abfragen. cookieblocker erkennt gängige andere Banner und meldet sie im Dashboard, bis sie entfernt sind. Mehr dazu: Cookie-Banner wechseln.

8. Fehlerbehebung

  • Kein Banner sichtbar: Nutzt die Website keine einwilligungspflichtigen Dienste, blendet cookieblocker den Banner bewusst aus (Einstellung „automatisch“). Prüfen Sie im Dashboard die Übersicht der Website.
  • „Nicht verbunden“: Site-ID und API-Schlüssel prüfen und Jetzt synchronisieren klicken. Der Server muss ausgehende HTTPS-Verbindungen zu cdn.cookieblocker.de erlauben.
  • Alter Stand im Browser: Seiten-Cache von Joomla oder einer Cache-Erweiterung leeren. Nach einer Synchronisierung leert das Plugin den Joomla-Seiten-Cache selbst.
  • Ein Dienst lädt trotzdem: Melden Sie uns die Seite – oft wird er beim nächsten nächtlichen Scan automatisch erkannt.

9. Deinstallation

Unter System → Verwalten → Erweiterungen „System – cookieblocker“ deinstallieren. Das Plugin entfernt dabei auch die lokal abgelegten Dateien in media/cookieblocker. Denken Sie daran, danach einen anderen Weg zur Einwilligung einzurichten, falls Ihre Website einwilligungspflichtige Dienste nutzt.

10. Support

Fragen, Fehler und Wünsche: Support-Seite oder direkt per E-Mail an info@odenwald-it-service.de.