ICTECH CMS Import Export
Benutzerhandbuch
Shopware 6.7 Plugin • Version 1.0.0 • von iCreative Technologies
1. Einführung
ICTECH CMS Import Export ist ein Shopware 6.7 Plugin, das Teams ermöglicht, CMS-Seiten (Shopping Experiences) schnell und sicher zwischen Shopware-Umgebungen zu übertragen – ohne manuelle Neuerstellung.
Welches Problem wird gelöst?
Zeitaufwendige manuelle Neuerstellung von Layouts
Menschliche Fehler bei Sektionen, Blöcken und Slots
Fehlende oder falsche Medien zwischen Umgebungen
Unklare Überschreibungsrisiken ohne Vorschau
Das Plugin bietet einen geführten und sicheren Transferprozess mit Prüf- und Vorschaufunktionen vor dem endgültigen Import.
Typische Anwendungsfälle
Übertragung von CMS-Layouts von Staging zu Live
Deployment von lokalen Umgebungen zu Staging
Kopieren von Layouts zwischen Shopware-Shops
Plugin-Informationen
Plugin-Name: ICTECH CMS Import Export
Version: 1.0.0
Entwickler: iCreative Technologies
Kompatibilität: Shopware 6.7.x
Nur für die Administration
2. Installation & Konfiguration
Plugin installieren
Laden Sie die Plugin-ZIP-Datei unter Erweiterungen > Meine Erweiterungen > Erweiterung hochladen hoch.
Klicken Sie auf Installieren und anschließend auf Aktivieren.
Leeren Sie den Cache mit bin/console cache:clear.
Plugin konfigurieren
Klicken Sie nach der Installation neben dem Plugin auf Konfigurieren.
Vertriebskanal auswählen
Transferverlauf aktivieren
Konfiguration speichern
Der Transferverlauf hilft Teams dabei, alle CMS-Import- und Exportvorgänge nachzuverfolgen.
3. Export eines CMS-Layouts
Das Plugin bietet mehrere Möglichkeiten, CMS-Layouts als ZIP-Paket zu exportieren.
Export aus der CMS-Übersicht
Navigieren Sie zu Inhalte > Erlebniswelten.
Wählen Sie das gewünschte CMS-Layout aus.
Klicken Sie auf das Drei-Punkte-Menü.
Wählen Sie CMS herunterladen.
Die ZIP-Datei wird automatisch heruntergeladen.
Export aus der CMS-Detailansicht
Öffnen Sie das CMS-Layout.
Klicken Sie auf das Export-Symbol in der Seitenleiste.
Öffnen Sie das Layout-Export-Panel.
Klicken Sie auf CMS herunterladen.
Details der Exportdatei
Die generierte ZIP-Datei enthält:
dataset.json
Referenzierte Mediendateien
CMS-Layout-Metadaten
Sektionen, Blöcke und Slots
4. Import eines CMS-Layouts
Der Importprozess erfolgt in mehreren geführten Schritten.
Importdialog öffnen
Navigieren Sie zu Inhalte > Erlebniswelten.
Klicken Sie auf CMS importieren.
Das Importfenster wird geöffnet.
Überblick über den Importprozess
ZIP-Paket auswählen
Importmodus auswählen
Archiv prüfen
Änderungen vorschauen
Import starten
Importmodi
Neues Layout erstellen
Erstellt ein vollständig neues CMS-Layout, ohne bestehende Inhalte zu überschreiben.
Bestehendes Layout aktualisieren
Findet bestehende Layouts und ersetzt deren Sektionen, Blöcke und Slots.
Archiv prüfen
Das Plugin validiert:
ZIP-Struktur
dataset.json-Schema
Vorhandene Ziel-Layouts
Medien-Dateien
Änderungen vorschauen
Die Vorschau zeigt:
Sektionsvergleich
Blockvergleich
Slotvergleich
Medienübersicht
Typänderungen
Während der Vorschau werden keine Datenbankänderungen vorgenommen.
Import starten
Während des Imports:
Aktualisiert sich die Fortschrittsanzeige live
Werden Medien importiert
Wird die CMS-Struktur erstellt
Wird eine Erfolgsmeldung angezeigt
5. Transferverlauf
Wenn der Transferverlauf aktiviert ist, werden alle Import- und Exportvorgänge protokolliert.
Der Verlauf enthält
Status
Vorgangstyp
Zeitstempel
Beschreibung
Transfer-Metadaten
Transferdetails
Jeder Verlaufseintrag zeigt:
Quellseite
Zielseite
Exportzeitpunkt
Zeitpunkt des Vorgangs
Metadaten-JSON
6. Medienverwaltung
Zielordner
Importierte Mediendateien werden gespeichert unter:
ICTECH Layout Transfer Assets
Wiederverwendungslogik
Hash-Treffer → vorhandene Datei wiederverwenden
Dateiname-Treffer → vorhandene Datei wiederverwenden
Kein Treffer → neue Mediendatei erstellen
Medienvorschau
Die Vorschau zeigt:
Gesamtanzahl der Dateien
Wiederverwendete Dateien
Neue Dateien
Gesamtgröße des Pakets
7. Sicherheit
Archivvalidierung
ZIP-Validierung
Schema-Validierung
Dateigrößenlimits
Schutz vor ungültigen Archiven
Schutz vor Path Traversal
Unsichere Pfade werden blockiert
Temporäre isolierte Extraktion wird verwendet
Serverseitige Bereinigung wird angewendet
Sitzungsbasierte Verarbeitung
Eindeutige Importsitzungen
Temporäre Verzeichnisse
Sichere Abbruchfunktion
Automatische Bereinigung
8. Kompatibilität
Gleiche Shopware-Version
Für zuverlässige Transfers wird empfohlen, identische Shopware-Versionen zu verwenden.
Unterschiedliche Shopware-Versionen
Unterschiedliche Versionen können verursachen:
Inhaltsverlust
Fehlerhafte Layouts
Probleme mit Medienreferenzen
Importfehler
Unvorhersehbare Vorschauergebnisse
Best Practices
Gleiche Shopware-Versionen verwenden
Vorschau immer prüfen
Importierte Layouts manuell kontrollieren
Zum Testen „Neues Layout erstellen“ verwenden
9. Fehlerbehebung
Häufige Probleme
Importfehler bei Medien
Überprüfen Sie die Schreibrechte des Medienordners.
Layout erscheint leer
Benötigte Drittanbieter-CMS-Blöcke könnten fehlen.
Fortschrittsbalken stoppt
Warten Sie auf den Abschluss des Imports und aktualisieren Sie die Seite nicht.
CMS herunterladen fehlt
Administration neu bauen und Cache leeren.
Admin-Rebuild-Befehle
./bin/build-administration.sh
bin/console cache:clear
10. Schnellübersicht
Export – Schnellschritte
Erlebniswelten öffnen
CMS-Layout auswählen
CMS herunterladen klicken
ZIP-Datei speichern
Import – Schnellschritte
CMS importieren öffnen
ZIP-Datei hochladen
Importmodus auswählen
Archiv prüfen
Änderungen vorschauen
Import starten
ICTECH CMS Import Export
Version 1.0.0 • Shopware 6.7 Plugin • von iCreative Technologies