Appearance

Update auf 1.5 ​

Version 1.5 macht den Kick Consent Manager fit für Joomla 6 und stellt den Build auf Vite um. Das Update läuft wie gewohnt über System → Erweiterungen → Update oder durch Installieren des neuen Pakets über die alte Version. Daten und Einstellungen bleiben erhalten.

Neue Mindestversionen ​

bisherab 1.5
Joomla!5.x5.4 oder höher (auch 6.x)
PHP8.18.1 oder höher

Das Backward-Compatibility-Plugin von Joomla 6 wird nicht mehr benötigt. Auf Joomla 5.0 bis 5.3 lässt sich 1.5 nicht installieren, die Installation bricht mit einem Hinweis ab. Diese Joomla-Versionen werden nicht mehr gepflegt.

Was sich ändert ​

Dateinamen ohne Version. Aus kcm.1.4.3.min.js wird kcm.min.js, aus kcm.1.4.3.css wird kcm.min.css. Die Version hängt Joomla als Cache-Buster an (kcm.min.js?1.5.0). Alte Dateien entfernt das Update automatisch.

Plugins mit Namespace. Beide Plugins sind moderne Joomla-Plugins mit Service-Provider. Die alte Datei kickconsentmanager.php wird beim Update gelöscht, die Plugins bleiben aktiv.

Datenbank. Datumsfelder ohne Wert enthalten NULL statt 0000-00-00 00:00:00. Das Update 1.5.0.sql wandelt bestehende Einträge um. Eigene Auswertungen oder SQL-Abfragen, die auf das Nulldatum prüfen, müssen auf IS NULL umgestellt werden.

Statistik. Die Statistik zählt jetzt Besucher (UUID) mit ihrer letzten Entscheidung im Zeitraum statt einzelner Einträge, kennt „Alles / Auswahl / Nur notwendige“ und wendet den Zeitraumfilter tatsächlich an. Die Prozente weichen deshalb nach dem Update von früheren Auswertungen ab, zum Beispiel, wenn Besucher ihre Auswahl mehrfach gespeichert haben. Details stehen unter Statistiken.

Sicherheit. Der CSV-Export der Statistik verlangt das Recht „Statistiken verwalten“ (core.manage.statistics), die Ansicht Import / Export das Recht core.admin. Die Website-Registrierung im Backend und das manuelle Bereinigen der Einwilligungen prüfen jetzt ein CSRF-Token. Die Registrierung verlangt außerdem das Recht core.admin für die Komponente.

Barrierefreiheit und Farben. Die Standardfarben wurden für ausreichenden Kontrast angepasst (Blau #0077b3, dunklere Grautöne und Schalterfarben). Bereits gespeicherte Design-Einstellungen bleiben unverändert. Mit Design auf Standard zurücksetzen übernehmen Sie die neuen Werte. Die Schalter sind jetzt per Tastatur bedienbar, siehe Barrierefreiheit.

Weitere Neuerungen

  • Optionaler Button zum erneuten Öffnen (standardmäßig aus)
  • Öffnen per data-kcm-open oder .kcm-js-open
  • Einstellung für den Fokusring, Banner als Dialog ausgezeichnet
  • Button Design auf Standard zurücksetzen im Tab „Design“
  • Statistik mit Verteilung, Zustimmungsrate pro Service, Tagesverlauf, Konfigurationsversion-Filter und CSV-Export
  • Google Tag Manager und Consent Mode v2 als Option im Tab „Google“ (aus, solange keine GTM-ID eingetragen ist)
  • Import / Export für Kategorien, Services, Cookies, Scripts und Einstellungen
  • Die Cookie-Erklärungsseite bleibt erhalten und ist jetzt ausdrücklich optional

Was Sie prüfen sollten ​

  1. Eigene Einbindungen. Wenn Sie die KCM-Dateien selbst eingebunden haben (zum Beispiel <script src=".../kcm.1.4.3.min.js"> in einem Template), stellen Sie auf die neuen Namen oder besser auf den WebAssetManager um.
  2. Template-Overrides und Custom-CSS. Die CSS-Klassen des Banners sind unverändert. Neu ist nur .kick-kcm-reopen für den Button.
  3. Links auf die Cookie-Erklärungsseite. Menüpunkte und Links funktionieren weiter.
  4. Eigener JavaScript-Code. window.KICK_KCM und die Events sind unverändert. showPreferenceCenter() öffnet jetzt auch dann den Dialog, wenn gerade kein Banner im DOM ist. Die JavaScript-API listet alles auf.
  5. Cache. Leeren Sie den Joomla-Cache und gegebenenfalls ein CDN, falls dort alte Dateien liegen.

Entfernt ​

  • Die Konfigurationsoption publicPath im Banner-Script. Sie war ein Relikt des alten Build-Systems und wird nicht mehr ausgewertet.
  • Ab 1.5.1: das alte Plugin „Installer - Kicktemp“ (plg_installer_kicktemp). Ältere Pakete haben es mitinstalliert. Es nutzt Klassen, die es in Joomla 6 ohne Backward-Compatibility-Plugin nicht mehr gibt, und bricht dort jede Installation und jedes Update mit einem Fehler ab. Das Update auf 1.5.1 deinstalliert es automatisch. Ein dort hinterlegter Download-Key wird als Download-Key der Update-Seite übernommen, falls dort noch keiner eingetragen ist.

Vor dem Upgrade auf Joomla 6

Aktualisieren Sie den Kick Consent Manager noch unter Joomla 5 auf 1.5.1 oder neuer und erst danach Joomla. Ist Joomla 6 bereits installiert und der Installer bricht mit Class "JPlugin" not found ab, löschen Sie per FTP den Ordner plugins/installer/kicktemp und installieren Sie anschließend das Paket 1.5.1. Das Update entfernt dann auch den verbliebenen Eintrag in der Datenbank.