Klaro Veröffentlichungen

• Die Autofokus-Eigenschaft wird nur bei Aktivierung der entsprechenden Option autoFocus genutzt.

• Der Titel des Dialogs wird nur bei Aktivierung der entsprechenden Option showNoticeTitle angezeigt.

• Das vorherige Release schloss leider die SourceMaps von Klaro mit ein, wodurch die Binärdateien sehr groß wurden. Dieses Release behebt dies.

• Beheben eines Problem mit der kontextbasierten Einwilligung, durch welchen der "Immer" Button auch angezeigt wurde, wenn der Nutzer noch kein Einverständnis erklärt hat.
• Aktualisieren aller Softwarepakete.

• Hinzufügen von tschechischen Übersetzungen und Verbessern der portugiesischen Übersetzungen.
• Entfernen der '...' Platzhalter in der Einwilligungsnotiz, um eine Anpassung der Texte zu vereinfachen.
• Hinzufügen eines cookiePath Parameters, der den Pfad des Klaro-Cookies kontrolliert.

• Verbesserung des kontextbasierten Einwilligungsmechanismus, um ihn für Anwender einfacher verständlich zu machen.

• Klaro wird nun als UMD-Modul mit Namen erzeugt, was die Einbindung in Umgebungen mit 'require.js' unter bestimmten Umständen vereinfacht.
• Bessere Handhabung von SCRIPT-Tags mit undefinierten "type" Attributen.

• API-Konfigurationen werden nur geladen, wenn sie als aktiv markiert sind.

• Verbesserung der automatischen Sprachauswahl.

Beheben kleinerer Probleme die bei der kontextuellen Einwilligung auftraten.

• Hinzufügen eines styling Konfigurationsparameters, der das einfache Anpassen der Benutzeroberfläche von Klaro ermöglicht, entweder durch das Setzen von Themes oder über die Definition von CSS-Variablen (kompatibel mit IE11 und modernen Browsern).
• Behebung eines Fehlers der bei der kontextbasierten Einwilligung nicht immer korrekt einen Platzhalter für freizuschaltende Inhalte anzeigte.

• Behebung eines Problems bei der Definition regulärer Ausdrücke für Cookies.

• Hinzufügen von onAccept, onDecline und onInit Event-Callbacks die es erlauben, fortgeschrittene Einwilligungsmechanismen über zusätzlichen Javascript-Code zu implementieren, der dynamisch für einen gegebenen Service geladen werden kann.
• Beheben eines Fehlers der bei kontextbasierten Einwilligungen dazu führte, dass für das src Attribut eines iframe der Wert undefined gesetzt wurde.

• Aktivierung von optionalem HTML-Support für den Titel des Einwilligungsdialogs.

• Weiteres Bugfixing für kontextbasierte Einwilligungen.

• Beheben eines Fehlers in der kontextbasierten Einwilligung.

• Hinzufügen eines "Test" Einwilligungs-Stores, der das Testen von Klaro einfacher gestaltet und u.a. in den interaktiven Tutorials genutzt wird.

• Hinzufügen von kontextbasierten Einwilligungen, die es Nutzern erlauben, für eingebettete externe Inhalte (z.B. YouTube-Videos) kontextbasiert eine Einwilligung zu erteilen.

• Hinzufügen eines fehlenden Übersetzung-Strings.
• Verbessern der Verwaltung von link Tags durch das Unterstützen des onlyOnce Parameters.
• Beim Überfahren aller Buttons mit der Maus wird nun immer der "Hand" Cursor angezeigt.

• Behebung eines Problems, das bei der Verwendung der ungestylten Klaro-Version in Kombination mit der Klaro API dazu führt, dass die API-Koniguration nicht geladen wird.

• Beschreibungen von Diensten und Zwecken werden nun ebenfalls vom htmlTexts Parameter erfasst und können als HTML-Texte geschrieben werden.
• Zwecke können über den purposeOrder Parameter sortiert werden. Dieser kann eine Liste mit Zweckbezeichnungen enthalten, die dann in der gegebenen Reihenfolge im Einwilligungs-Hinweis und -Modal erscheinen.

• Anpassen des Verhaltens des "Alle aktivieren/deaktivieren" Sliders bei nicht-gruppierten Diensten um es an das Verhalten des Sliders bei gruppierten Diensten anzugleichen.

• Die Dritt-Dienste wurden von "Apps" in "Dienste" umbenannt, um innerhalb der Codebasis als auch in der Benutzeroberfläche eine einheitliche Terminologie zu verwenden. Der Begriff "Dienst" umfasst besser als "App" die Dritt-Software die auf Webseiten eingesetzt wird.

Wichtig:

Das Format der Konfigurationsdatei ändert sich mit diesem Release. Alte Konfigurationsdateien werden aktuell automatisch auf das neue Format umgeschrieben. Wir empfehlen trotzdem, die Konfigurationsdateien folgendermaßen zu ändern:

Zwingend notwendige Änderungen

• Umbenenen der Bezeichnung der Liste von Dritt-Services von apps in services.
• Gegebenenfalls Umbennenen des Unterschlüssels apps in services innherhalb des translations Schlüssels. Nur notwendig, falls Änderungen an den Standardübersetzungen in vorgenommen wurden.

Änderungen an eigenem CSS

Falls Klaro mit eigenem CSS angepasst wurde und Elemente der Klassen cm-apps oder cm-app überschrieben wurden, müssen diese ebenfalls in cm-services bzw. cm-service umbenannt werden.

Hinweise zum Upgrade:

Da bei diesem Upgrade auch CSS-Klassen umbenannt wurden kann es trotz der automatischen Anpassung von Konfigurationsdateien zu Problemen bei der Darstellung von Klaro kommen. Um zu vermeiden, dass bestehende Klaro-Installation hiervon betroffen sind wird dieses Release zunächst nicht mit der Version latest auf dem CDN publiziert, ein Upgrade muss manuell erfolgen. Wir raten nun generell davon ab, die latest Version zu nutzen um solche Probleme in Zukunft zu vermeiden. Um weiterhin automatisierte Bugfixes und kleinere rückwärtskompatible Anpassungen zu ermöglichen, werden wir in Zukunft das latest Tag im CDN mit Tags ersetzen, die aus der Haupt- und Neben-Versionsnummer eines Releases bestehen, z.B. 0.7. Dies soll uns ermöglichen, kritische Upgrades weiterhin automatisch ausliefern zu können ohne dabei Inkompatibilitäten zu riskieren. Ein Upgrade auf eine neue Haupt- oder Nebenversion soll dann manuell erfolgen.

• Beheben eines Fehlers, der zu Problemen bei der Verwendung von Klaro mit Internet Explorer führte.

• Ändern des (undokumentierten) klaro-config-name Parameters.

• Harmonisierung und Verbesserung (aus unserer Sicht) der Übersetzungen.
• Hinzufügen von Übersetzungen für standardisierte Verarbeitungszwecke.

• Verbesserung des Initialisierungscode um es zu vereinfachen, Klaro als Teil eines JS-Projekts zu nutzen.

• Vorbereitung der IDE-Integration für die Open-Source Version.
• Verbesserte Funktionalität für das Testen von Konfiguration.

• Änderung der Art, wie das "show" Event erfasst wird.

• Anpassung der API-Endpunkt-URLs an das neue Format (privacy-manager statt consent-manager).

• Release-Files schließen nun alle JS-Dateien im dist Verzeichnis ein, sowie alle JS und (S)CSS Dateien aus dem src Verzeichnis ein.

• Beim Senden anonymer Einwilligungs-Statistiken wird die ID der Konfiguration geschickt statt deren Namen. Dies macht die Einwilligungen direkt einer gegebenen Konfiguration zurechenbar und vereinfach u.a. A/B-Testing.

• Kleine Verbesserung des Event-Handler-Codes.

• Behebung eines Problems in der anonymen Einwillungserfassung, das dazu führte, dass keine Metriken beim normalen Speichern erfasst wurden.

• Bessere Erfassung von Einwilligungen mit optionaler Speicherung des Hostnamens, des Protokolls, des Ports und des Dateipfades, sowie Speicherung von Zustimmungsänderungen.
• Vorbereitung der Einbindung der integrierten Klaro-Entwicklungsumgebung zur einfachen und komfortablen Konfiguration

• Behebung eines Fehlers bei der Interpretation der Cookie-Konfiguration.

• Backend-Funktionalität hinzugefügt: Klaro kann optional Konfigurationen von einer API laden und Einwilligungsinformationen (anonym) an eine API senden.

• Der Parameter hideLearnMore wurde wieder aktiviert, er erlaubt es, den "Anpassen" Link im Hinweisdialog zu entfernen.
• In der Beschreibung des Hinweisdialogs kann nun der "Anpassen" Link direkt im Text angezeigt werden.
• Das Erscheinungsbild der Buttons im Hinweisdialog auf kleinen Bildschirmen wurde verbessert.

• Formatierung der Übersetzungen verbessert und Informationen zu fehlenden Übersetzungs-Strings hinzugefügt.
• Klaro-Binärdateien / Distribution-Dateien werden wieder eingeschlossen.

• Quelldateien wie JS und SCSS werden nun im NPM-Package bereitgestellt, was es einfacher macht mit diesen zu arbeiten um z.B. SCSS-Dateien direkt zu importieren.

• Das lang Attribut des Klaro div-Elements enthält nun die aktuell eingestellte Sprach Sprache für Klaro, was z.B. die Anpassung von Stylesheets basierend auf der gewählten Sprache einfacher macht.
• Der additionalClass Parameter wurde hinzugefügt, über welchem dem Klaro-Element zusätzliche CSS-Klassen zugewiesen werden können.

• noticeAsModal Parameter hinzugefügt, der das Einwilligungs-Hinweisfenster als modales Fenster darstellt und den Nutzer dazu zwingt, eine Entscheidung zu treffen bevor die Seite genutzt werden kann.

• Cookie-Attribute SameSite=Lax wird gesetzt um modernen Cookie-Richtlinien zu entsprechen. Siehe MDN für eine technische Erläuterung.

• Ein Fehler in der klaro.resetManagers() Funktion wurde behoben.
• Beim Kopieren eines script Elements werden nun alle Attribute übernommen.

• Maximale Größe der Einwilligungs-Notiz auf 360px erhöht, damit Text in den Buttons nicht gebrochen wird.

• Die extraHTML-Felder wurden aus den Feldern extraHTML im Zustimmungsmodus und in der Zustimmungsmitteilung entfernt, um HTML in Beschreibungen generell zuzulassen. Sie können jetzt htmlTexts: true in der Konfiguration einstellen, was Klaro anweist, die von Ihnen bereitgestellten Übersetzungsstrings als HTML-Inhalt zu rendern. Wenn eine bestimmte Zeichenfolge nicht mit einer öffnenden Klammer (<) beginnt, wird Klaro den resultierenden HTML/Text trotzdem innerhalb eines Absatzes (<p>...</p>) einfügen, andernfalls wird er "so wie er ist" dargestellt.

Wir hoffen, dass diese Änderung es einfacher macht, das Erscheinungsbild der Einverständniserklärung und des Modals anzupassen, ohne auf zusätzliche Konfigurationsparameter zurückgreifen zu müssen. Wenn wir uns entscheiden, HTML an mehr Stellen zu unterstützen, können wir das tun, ohne das Konfigurationsformat erneut zu brechen.

Wir entschuldigen uns für die Einführung einer brechenden Konfigurationsänderung, da die Option extraHTML zu Beginn recht neu war, die Änderung sollte nicht viele Benutzer betreffen und wir denken, dass sie auf lange Sicht von Vorteil sein wird.

• Prüfsummen zu allen lokal erzeugten Builddateien hinzugefügt, z.B. zur Verwendung als Subresource-Integrity-Tags. Siehe MDN für weitere Einzelheiten hierzu.

• Es wurde die Konfigurationsoption groupByPurpose hinzugefügt, die Anwendungen nach ihrem Zweck in Kategorien gruppiert und es dem Benutzer erlaubt, ganze Gruppen von Anwendungen auf einmal zu aktivieren oder zu deaktivieren. Dies reduziert auch den Platzbedarf des Modals, was besonders für Websites wichtig ist, die viele Anwendungen von Drittanbietern verwenden.