Vorwort
Andernfalls wird die WordPress-Seite mit Sicherheit Fehlermeldungen anzeigen und nicht mehr erreichbar sein.
Zudem kann es zu einem Datenverlust der Borlabs Cookie-Einstellungen kommen, wenn die Anweisungen nicht exakt befolgt werden.
Vorinstallierte Vorlagen (Cookies / Content-Blocker) sind nicht mehr verfügbar. Die Auswahl von Vorlagen erfolgt nun nicht mehr beim Hinzufügen eines Cookies, sondern über Pakete aus der Bibliothek von Borlabs Cookie 3.0.
Welche Pakete aus der Bibliothek deine Website benötigt, kann der Scanner in Borlabs Cookie 3.0 ermitteln. Grundsätzlich sind die vorgeschlagenen Pakete vom Typ "Kompatibilitäts-Patch" immer zu installieren.
Bei der Verwendung des Legacy Importers werden die erforderlichen Pakete automatisch ermittelt und installiert. Weitere Informationen dazu findest du im Abschnitt "Upgrade-Optionen".
Nach dem Import der Daten wird ein Bericht über den Import-Verlauf an die Administrator-E-Mail-Adresse (Einstellungen > Allgemein > Administrator-E-Mail-Adresse) gesendet.
Daten, Einstellungen und Abwärtskompatibilität
Design, Einstellungen und Texte
Alle Einstellungen und Texte aus den Bereichen "Einstellungen", "Cookie Box" und "Content-Blocker: Allgemeine Einstellungen" und "Content-Blocker: Darstellungs Einstellungen" werden, sofern in Borlabs Cookie 3.0 vorhanden, übernommen.
Folgende Einstellungen sind in Borlabs Cookie 3.0 nicht mehr vorhanden:
- jQuery Handle: jQuery wird nicht mehr verwendet.
- Integration [JavaScript | HTML]: Die Integration erfolgt ausschließlich über JavaScript, da dies die höchste Performance und Kompatibilität gewährleistet.
- Button [Button | Link]: Die Option, Buttons als Links darzustellen, ist aufgrund gesetzlicher Änderungen nicht mehr erlaubt und wurde daher entfernt.
- Vorausgewählten Status ignorieren: Wird nicht mehr benötigt.
Cookie-Gruppen / Service-Gruppen
Alle Cookie-Gruppen werden vollständig übernommen. In Borlabs Cookie 3.0 heißen "Cookie-Gruppen" jetzt "Service-Gruppen".
Cookies / Services
Alle Cookies werden übernommen, jedoch kann der Import unvollständig sein, da in Borlabs Cookie Legacy einige Informationen fehlen. In Borlabs Cookie 3.0 heißen "Cookies" jetzt "Services".
Vollständiger Import
Die folgenden Services werden durch Services aus den Paketen der Borlabs Cookie 3.0-Bibliothek ersetzt. Dabei werden alle Texte, Opt-in-, Opt-out- und Fallback-Codes durch die Informationen aus dem Service-Paket überschrieben und können zukünftig durch Aktualisierungen der Pakete in der Bibliothek auf dem neuesten Stand gehalten werden. Einstellungen, wie zum Beispiel Tracking-IDs (z. B. von Google Analytics), werden übernommen.
| Name | ID | Neue ID |
|---|---|---|
| Bing Ads | bing-ads | |
| Facebook Pixel | facebook-pixel | meta-pixel-package |
| Google Ads | google-ads | |
| Google AdSense | google-adsense | |
| Google Analytics | google-analytics | |
| Google Tag Manager | google-tag-manager | |
| Google Tag Manager - Consent | google-tag-manager-consent | google-tag-manager |
| Hotjar | hotjar | |
| HubSpot | hubspot | |
| Matomo | matomo | |
| Matomo Tag Manager | matomo-tag-manager | |
| Polylang | polylang | |
| Tidio | tidio | |
| TikTok Pixel | tikto-pixel | tiktok-pixel |
| Userlike | userlike | |
| WooCommerce | woocommerce | |
| WPML | wpml |
Kein Import
Die folgenden Services werden nicht importiert:
| ID | Begründung |
|---|---|
| borlabs-cookie | Es werden die Standard-Informationen von Borlabs Cookie 3.0 verwendet. |
| ezoic | Einwilligung erfolgt über das IAB TCF in Borlabs Cookie 3.0. |
| ezoic-marketing | Einwilligung erfolgt über das IAB TCF in Borlabs Cookie 3.0. |
| ezoic-preferences | Einwilligung erfolgt über das IAB TCF in Borlabs Cookie 3.0. |
| ezoic-statistics | Einwilligung erfolgt über das IAB TCF in Borlabs Cookie 3.0. |
| Wird automatisch durch das Content-Blocker-Paket aus der Bibliothek erstellt. | |
| googlemaps | Wird automatisch durch das Content-Blocker-Paket aus der Bibliothek erstellt. |
| Wird automatisch durch das Content-Blocker-Paket aus der Bibliothek erstellt. | |
| openstreetmap | Wird automatisch durch das Content-Blocker-Paket aus der Bibliothek erstellt. |
| Wird automatisch durch das Content-Blocker-Paket aus der Bibliothek erstellt. | |
| vimeo | Wird automatisch durch das Content-Blocker-Paket aus der Bibliothek erstellt. |
| youtube | Wird automatisch durch das Content-Blocker-Paket aus der Bibliothek erstellt. |
Unvollständiger Import
Alle Services, deren ID nicht unter "Vollständiger Import" oder "Kein Import" aufgeführt ist, werden importiert, jedoch ohne vollständige Informationen. Diese fehlenden Informationen müssen nachträglich manuell ergänzt werden.
Der erforderliche Provider wird automatisch erstellt, enthält jedoch nicht alle notwendigen Informationen, da diese in Borlabs Cookie Legacy nicht vorhanden sind.
Cookie-Informationen werden teilweise importiert, müssen anschließend überprüft und korrigiert werden.
Content-Blocker
Content-Blocker werden nur teilweise importiert. Das HTML und CSS des "Vorschau Blockierter Inhalt" wird durch die Standard-Voreinstellungen von Borlabs Cookie 3.0 ersetzt.
Der erforderliche Provider wird automatisch erstellt, enthält jedoch nicht alle notwendigen Informationen, da diese in Borlabs Cookie Legacy nicht vorhanden sind.
Script-Blocker
Alle Script-Blocker werden vollständig übernommen.
Abwärtskompatibilität
JavaScript-API
Die Bibliothek für die Abwärtskompatibilität zur alten JavaScript-API ist weitgehend verfügbar und wird bei Verwendung des Legacy Importers automatisch aktiviert. Es wird jedoch empfohlen, auf die neue JavaScript-API umzustellen, um zusätzliches JavaScript zu vermeiden und so die Auswirkungen auf PageSpeed-Scores und ähnliche Metriken zu minimieren.
PHP-API
Eine Abwärtskompatibilität zur alten PHP-API ist nicht verfügbar. Für Automatisierungen empfehlen wir die Verwendung von WP-CLI.
Vorbereitung und Ablauf
Beim Upgrade von Version 2.3 auf 3.2 wird die gesamte Verzeichnisstruktur von Borlabs Cookie ausgetauscht.
Daher müssen die Updates unbedingt in der richtigen Reihenfolge durchgeführt werden. Andernfalls kommt es definitiv zu einem Datenverlust der Borlabs Cookie-Einstellungen und die WordPress-Website wird Fehlermeldungen anzeigen.
- Backup erstellen, wir empfehlen das kostenlose Plugin WP Staging https://de.wordpress.org/plugins/wp-staging/.
- Borlabs Cookie auf Version 2.3 aktualisieren.
- Automatisches oder manuelles Upgrade durchführen.
- Automatisches Upgrade: Siehe Abschnitt "Automatisches Upgrade".
- Manuelles Upgrade: Siehe Abschnitt "Manuelles Upgrade".
- Nachbereitung durchführen.
Die Updates auf Version 2.2.68 und von 2.2.68 auf 2.3 müssen ausschließlich über die Plugin-Verwaltung durchgeführt werden, wie im Screenshot dargestellt.
Upgrade-Optionen
Sobald Borlabs Cookie 2.3 installiert ist, kann das Upgrade auf Borlabs Cookie 3.2 durchgeführt werden. Es stehen zwei Vorgehensweisen zur Auswahl, die im Folgenden näher erläutert werden.
Automatisches Upgrade
Beim automatischen Upgrade wird das Update auf Borlabs Cookie 3.2 sowie der Import automatisch ausgeführt, sobald die Version 3.2 verfügbar ist.
Um das automatische Upgrade zu aktivieren, wähle im Dashboard die Option "Upgrade auf Borlabs Cookie 3.0" aus.
Sobald das automatische Upgrade abgeschlossen ist, wird der Import durchgeführt. Anschließend wird ein Import-Bericht versendet.
Manuelles Upgrade
Vorbereitung
Das manuelle Upgrade erfordert die Installation der Version 2.3. Prüfe anschließend im Dashboard von Borlabs Cookie unter "Systemstatus", ob alle Prüfungen erfolgreich sind.
Upgrade
Anschließend kannst du die .zip-Datei von Borlabs Cookie 3.2 über die Plugin-Verwaltung von WordPress hochladen. Klicke dazu links im Menü auf Plugins > Neues Plugin hinzufügen > Plugin hochladen.
Bestätige, dass die vorhandene Installation überschrieben werden soll.
Dieser Vorgang kann einige Zeit in Anspruch nehmen und muss unbedingt abgewartet werden. Sobald die Meldung "Das Plugin wurde erfolgreich aktualisiert" erscheint, klicke im linken Menü auf den Dashboard-Eintrag von WordPress. Erst danach kannst du das Menü von Borlabs Cookie wieder verwenden.
Import
Nachdem das Dashboard von WordPress aufgerufen wurde, kann das Dashboard von Borlabs Cookie aufgerufen werden.
Borlabs Cookie ist zunächst deaktiviert und es erscheint eine Meldung, dass der Lizenzschlüssel aktiviert werden soll. Diese Meldung kann ignoriert werden, da im nächsten Schritt die Borlabs Cookie Legacy-Daten importiert werden, wodurch auch der Lizenzschlüssel übernommen wird.
Klicke auf System > Legacy-Importer und gehe zum Bereich "Legacy-Daten importieren", um die Daten von Borlabs Cookie Legacy (2.3) zu importieren.
Dieser Vorgang kann jederzeit durchgeführt werden und überschreibt vorhandene Einträge mit identischer ID mit den Daten aus Borlabs Cookie Legacy.
Es werden alle Daten aus Borlabs Cookie Legacy importiert; eine Auswahl einzelner Komponenten, wie zum Beispiel nur das Design, ist nicht möglich.
Vor dem Import kann unter "Importdaten-Vorschau" eingesehen werden, welche Daten übernommen werden und bei welchen Einträgen eine Änderung der ID erfolgt.
Wurde ein Shortcode mit einer alten ID (Legacy ID) verwendet, muss die ID entsprechend auf die neue (Neue ID) geändert werden. Andernfalls wird der Standard-Content-Blocker verwendet.
Nach jedem Import wird die Option "Bibliothek für Abwärtskompatibilität laden" aktiviert. In der Browser-Konsole erscheinen Hinweise, wenn eine Funktion der alten JavaScript-API verwendet wird, einschließlich der entsprechenden neuen JavaScript-Funktion.
Es wird empfohlen, den eigenen Code anzupassen und die neuen JavaScript-API-Funktionen zu nutzen. Danach kann die Option "Bibliothek für Abwärtskompatibilität laden" deaktiviert werden.
Import-Bericht
Nach Abschluss des Imports wird ein Import-Bericht per E-Mail an die Administrator-E-Mail-Adresse (Einstellungen > Allgemein > Administrator-E-Mail-Adresse) gesendet.
Der Bericht enthält eine Übersicht der importierten Komponenten sowie Informationen zur weiteren Nachbereitung.
Nachbereitung
Beim Import von benutzerdefinierten Content-Blockern und Services (früher Cookies) wird der erforderliche Provider automatisch erstellt. Dieser enthält jedoch nicht alle notwendigen Informationen, da diese in Borlabs Cookie Legacy nicht vorhanden sind, und muss daher nachträglich ergänzt werden.
Die Provider findest du unter Consent-Management > Provider.
Die IDs der automatisch erstellten Provider beginnen mit "ic-".
Nach dem Klick auf das Bearbeiten-Symbol müssen die Felder für Adresse, Beschreibung und Datenschutz-URL nachgepflegt werden.
Unter Consent-Management > Services müssen benutzerdefinierte Services ebenfalls überprüft und gegebenenfalls fehlende Informationen ergänzt werden.
Welche Services benutzerdefiniert sind, wird im Import-Bericht angegeben. Besonders die Informationen zum Service, HTML & JavaScript sowie die Cookies sollten auf ihre Richtigkeit überprüft werden.
Das Upgrade auf Borlabs Cookie 3.2 ist abgeschlossen.
Bitte schaue dir unbedingt unsere Videos zu Borlabs Cookie 3.0 an, da sich im Vergleich zu Borlabs Cookie 2.0 einiges geändert hat: https://de.borlabs.io/kbtopic/borlabs-cookie-3-0-videos/.