Update

OXID eShop 7.5 wird mit Visual CMS 10 ausgeliefert — keine manuelle Installation erforderlich. Das Content & Medien Bundle wird automatisch mit dem OXID eShop Update über Composer aktualisiert.

Wenn Sie von einer älteren OXID eShop Version aktualisieren (z. B. 7.3 mit Bundle 8), haben Sie vor dem Update zwei Möglichkeiten:

Auf Ihrer aktuellen Bundle Version bleiben — behalten Sie Visual CMS 8 oder 9 und bleiben Sie kompatibel mit Ihren vorhandenen Inhalten.
Auf Visual CMS 10 aktualisieren — erhalten Sie alle neuen Funktionen, aber Sie müssen Ihre vorhandenen Inhalte anschließend migrieren (siehe unten).

Note

Wenn Sie bereits OXID eShop 7.4.x mit Visual CMS 9 verwenden, können Sie direkt auf Visual CMS 10 aktualisieren, ohne Inhalte zu migrieren.

Versionskompatibilität

OXID eShop 7.5 unterstützt drei Visual CMS Versionen parallel:

Visual CMS 10 — neueste Version (Content & Medien Bundle 10, empfohlen)
Visual CMS 9.2 — Verbleib auf aktueller Version (Content & Medien Bundle 9)
Visual CMS 8.0 — Verbleib auf aktueller Version (Content & Medien Bundle 8)

Um auf Bundle 8 oder 9 zu bleiben, geben Sie die Zielversion in Ihren Composer-Einstellungen vor dem Update an. Details finden Sie in der Update-Anleitung der OXID eShop Dokumentation.

Migration von Visual CMS 8

Wenn Sie von Visual CMS 8 aktualisieren, verwenden Ihre Inhalte das alte parse Format und müssen migriert werden, um mit Visual CMS 9 oder 10 zu funktionieren.

Wenn Sie von Visual CMS 9 auf 10 aktualisieren, ist keine Inhaltsmigration erforderlich — das Speicherformat ist bereits das neue tree Format.

Warning

Führen Sie vor der Migration 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.

Führen Sie nach dem Update diese Migrationsschritte aus:

Visual CMS Inhalte migrieren — konvertieren Sie von parse zu tree Format (siehe Geänderte Codebasis unten).
Medien-URLs zu IDs konvertieren — für Visual CMS und WYSIWYG-Inhalte (siehe Medien-IDs im Visual CMS und Medien-IDs im WYSIWYG Editor unten).

Die folgenden Abschnitte beschreiben jeden Schritt im Detail.

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.

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
(...)

Produktbeschreibungen:

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

Kategoriebeschreibungen:

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

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

Alt-Text-Platzhalter im WYSIWYG Editor

Important

Dieser Befehl steht ausschließlich in WYSIWYG-Editor 7 (Content & Medien Bundle 10) zur Verfügung. Er wurde nicht auf WYSIWYG-Editor 6 (Bundle 9) oder ältere Versionen zurückportiert.

Mit WYSIWYG-Editor 7 können Alt-Texte von Medien-Bildern sprachabhängig aus der Mediathek gezogen werden. Der folgende Befehl ersetzt leere oder fehlende Alt-Attribute in bestehenden Inhalten durch den Platzhalter oeMediaAlt:

./vendor/bin/oe-console ddoewysiwyg:migrate:alt-texts <table-name> <field-name> <table-id-key>

Die Argumente sind identisch zu ddoewysiwyg:migrate:urls-to-ids:

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.

Hint

Bestehende, manuell vergebene Alt-Texte werden nicht überschrieben. Der Befehl gibt am Ende eine Liste der Bilder aus, die einen benutzerdefinierten Alt-Text enthalten, damit diese bei Bedarf manuell geprüft werden können.