Update

Updates von Visual CMS sowie Mediathek und WYSIWYG-Editor erfolgen automatisch bei jedem OXID eShop Update über Composer.

Update zu Visual CMS 9

Warning

Führen Sie vor dem Migrationsprozess eine vollständige Sicherung der Datenbank und des Dateisystems durch. So können Sie die Migrationsschritte sofort rückgängig machen, falls unerwartete Probleme auftreten.

Folgende Erweiterungen sind in OXID eShop 7.4 vorinstalliert:

  • Visual CMS 9

  • Mediathek 4

  • WYSIWYG-Editor 6

Um den vollen Funktionsumfang nutzen zu können, sind nach der Aktualisierung Ihres OXID eShops zusätzliche Schritte erforderlich:

  1. Konvertieren Sie Medien-URLs zu IDs für WYSIWYG-Inhalte: Medien-IDs im WYSIWYG Editor.

  2. Migrieren Sie Visual CMS-Inhalte auf die neue Codebasis: Geänderte Codebasis.

  3. Konvertieren Sie Medien-URLs zu IDs für Visual CMS Widgets: Medien-IDs im Visual CMS.

Geänderte Codebasis

Mit Visual CMS 9, eingeführt in OXID eShop 7.4, wurde die Codebasis der Visual CMS Inhalte von parse auf tree umgestellt. Dies verbessert die Speicherstruktur der Inhalte und bietet eine optimierte und stabile Codebasis für zukünftige Updates.

CMS-Inhalte mit der Zeichenkette veparse funktionieren im Frontend des Shops nicht mehr und können zu Fehlern führen. Daher ist es zwingend erforderlich, diese Inhalte von der parse- in die tree-Struktur zu migrieren. Dies ist ganz einfach mit dem folgenden Befehl der OE-Konsole möglich:

./vendor/bin/oe-console ddoevisualcms:migrate:veparse-to-vetree

Der Befehl konvertiert alle Inhalte, die veparse nutzen, zur neue vetree Struktur. Anschließend können diese wie gewohnt im Visual CMS-Editor bearbeitet werden.

CMS-Inhalte, die nur aus reinem HTML bestehen, werden nicht in die neue Struktur migriert. Die Option Widgets deaktivieren und nur Text verwenden ist nach dem Update automatisch aktiv. Dadurch wird sichergestellt, dass die Inhalte weiterhin wie vorgesehen funktionieren. Wenn Sie die Inhalte später mit Widgets bearbeiten möchten, können Sie die Option Widgets deaktivieren und nur Text verwenden deaktivieren und diese dann wie gewohnt modifizeren. Nach dem Speichern werden die Inhalte in der neuen tree-Struktur gespeichert.

Warning

Beim Wechsel zum Widget-Editor wird ein leerer Arbeitsbereich geöffnet. Ihre vorherigen Nur-Text-Inhalte werden beim Speichern überschrieben. Sichern Sie deshalb unbedingt den Text, den Sie behalten möchten, bevor Sie den Modus wechseln.

Einführung von Medien-IDs

Mit der Mediathek 4, eingeführt in OXID eShop 7.4, haben wir Dateipfade im WYSIWYG-Editor und Visual CMS zu Medien-IDs geändert. Dadurch wird sichergestellt, dass die Mediendatei auch nach Namens- oder Pfadänderung gefunden wird. Während die Pfaddefinition auch nach dem Update weiterhin funktioniert, empfehlen wir, vorhandene Inhalte zu konvertieren, um die neue ID-Definition zu verwenden und von den Vorteilen zu profitieren.

Medien-IDs im WYSIWYG Editor

Der WYSIWYG-Editor wird für verschiedene Inhalte im OXID eShop verwendet. Sie können vorhandene Inhalte von Medien-URLs zu IDs konvertieren, indem Sie die folgenden Befehle in der OE-Konsole ausführen:

Hint

Denken Sie daran, alle Felder für alle Sprachen zu konvertieren, z. B. OXCONTENT, OXCONTENT_1, OXCONTENT_2 usw., wie im ersten Beispiel gezeigt.

  1. Allgemeine Inhalte wie CMS-Seiten:

    ./vendor/bin/oe-console ddoewysiwyg:migrate:urls-to-ids oxcontents OXCONTENT
./vendor/bin/oe-console ddoewysiwyg:migrate:urls-to-ids oxcontents OXCONTENT_1
./vendor/bin/oe-console ddoewysiwyg:migrate:urls-to-ids oxcontents OXCONTENT_2
(...)

  2. Produktbeschreibungen:

    ./vendor/bin/oe-console ddoewysiwyg:migrate:urls-to-ids oxartextends OXLONGDESC

  3. Kategoriebeschreibungen:

    ./vendor/bin/oe-console ddoewysiwyg:migrate:urls-to-ids oxcategories OXDESC

  4. Zahlugsartbeschreibungen:

    ./vendor/bin/oe-console ddoewysiwyg:migrate:urls-to-ids oxpayments OXDESC

Sie können andere WYSIWYG-Inhalte, wie z. B. benutzerdefinierte Datenbankfelder, mit dem Befehl migrieren, indem Sie die korrekten Werte für Folgendes übergeben:

  • Die Datenbanktabelle mit den zu konvertierenden Daten.

  • Der spezifische Feldname in der ausgewählten Datenbanktabelle.

  • Der eindeutige ID-Schlüssel (Primärschlüssel) der Tabelle. Der Standardwert ist OXID.

./vendor/bin/oe-console ddoewysiwyg:migrate:urls-to-ids <table-name> <field-name> <table-id-key>

Medien-IDs im Visual CMS

Das Visual CMS enthält Widgets für Medien, wie das Bild-Widget oder die Galerie. Sie können die Medienpfade in diesen Widgets einfach konvertieren, indem Sie den folgenden Befehl in der OE-Konsole ausführen:

./vendor/bin/oe-console ddoevisualcms:migrate:urls-to-ids

Warning

Hintergrundbilder, z.B. im Hero-Widget, werden aktuell nicht in Medien-IDs umgewandelt, funktionieren aber wie bisher. Nach dem Update hinzugefügte Hintergrundbilder werden mit neuen IDs statt alten URLs gespeichert.

Entferntes Icon-Widget

Das Visual CMS Icon-Widget wurde mit OXID eShop 7.0 entfernt. Diese Änderung verbessert die Shop-Performance, da Font-Awesome nicht mehr auf jeder Seite integriert werden muss. Voraussetzung hierfür ist, dass in den Moduleinstellungen die Option Erweiterungen ‣ Module ‣ Visual CMS ‣ Einstellungen ‣ Frontend ‣ Font-Awesome einfügen deaktiviert ist.

In CMS-Inhalten, in denen das Widget verwendet wurde, wird es automatisch entfernt, wenn diese in Visual CMS geöffnet und gespeichert werden.