Bild-Import

ReadySync unterstützt den automatischen Import von Produktbildern aus Ihrem FTP-Server zu Shopware.

Übersicht

Der Bild-Import ermöglicht:

• ✅ Automatischer Upload: Bilder werden automatisch von FTP zu Shopware hochgeladen
• ✅ Mehrere Bilder: Unterstützung für mehrere Bilder pro Produkt
• ✅ Intelligente Synchronisation: Nur neue/geänderte Bilder werden hochgeladen
• ✅ Flexible Konfiguration: Trennzeichen, Force-Upload, Verzeichnisse

Funktionsweise

1. CSV-Felder: Bildnamen werden aus der Import-Datei gelesen (z.B. BildName, Artikelmultimediadateien)
2. FTP-Download: Bilder werden vom konfigurierten FTP-Bildverzeichnis geladen
3. Upload zu Shopware: Bilder werden über die Shopware Media API hochgeladen
4. Produkt-Zuordnung: Bilder werden den Produkten zugeordnet (Cover + Galerie)

Konfiguration

Schritt 1: Bildverzeichnis konfigurieren

Im Tab "ERP" → "FTP" der Verbindungskonfiguration:

• Bildverzeichnis: Pfad zum Bilder-Verzeichnis auf dem FTP-Server (z.B. images/)
• Standard: Leer (Bilder werden im gleichen Verzeichnis wie Import-Dateien gesucht)

Mehr über Bildverzeichnis →

Schritt 2: Bilder im Mapping zuordnen

Im Mapping-Editor können Sie folgende Bildfelder zuordnen:

• image_1: Erstes Bild (wird als Cover gesetzt)
• image_2: Zweites Bild (Galerie)
• image_3: Drittes Bild (Galerie)
• images: Mehrere Bilder (komma- oder doppelpunkt-separiert)

Mehr über Bild-Mapping →

Schritt 3: Trennzeichen konfigurieren

Für mehrere Bilder in einem Feld (z.B. images):

• Trennzeichen: Komma (,), Doppelpunkt (:), etc.
• Standard: Komma (,)

Beispiel:

• CSV: "JS4A17351.jpg:JS4A17352.jpg:JS4A17353.jpg"
• Trennzeichen: :
• Ergebnis: 3 Bilder werden zugeordnet

Mehr über Trennzeichen →

Schritt 4: Bild-Upload-Optionen

• Bilder immer neu hochladen (image_force): Upload auch bei unveränderten Bildern
• Intelligente Synchronisation: Upload nur wenn Quelle neuer als Shopware-Medium

Mehr über Optionen →

Import-Ausführung

Es gibt zwei Möglichkeiten, Bilder zu importieren:

Option 1: Automatisch nach Produktimport

Der Bildimport kann automatisch nach einem Produktimport gestartet werden:

1. Navigieren Sie zu Verbindungen
2. Hover über den Import-Button (Delta-Import oder Vollimport)
3. Klicken Sie auf das Bild-Icon (links oben auf dem Button) um den automatischen Bildimport zu aktivieren
4. Wenn aktiv (cyan leuchtend): Der Button zeigt "+ Bilder" an
5. Starten Sie den Import - nach Abschluss des Produktimports startet automatisch der Bildimport

Vorteile:

• ✅ Ein Klick für Produkt- und Bildimport
• ✅ Bildimport läuft als separater Job (keine Timeouts)
• ✅ Übersichtliche Job-Historie

Option 2: Separater Bildimport

Sie können Bilder auch unabhängig vom Produktimport synchronisieren:

1. Navigieren Sie zu Verbindungen
2. Klicken Sie auf den "Bildimport"-Button
3. Wählen Sie im Dropdown:
   • Delta (nur geänderte): Verwendet die Delta-Importdatei
   • Vollständig (alle Bilder): Verwendet die Vollimport-Datei

Planabhängig

Der separate Bildimport ist nur in bestimmten Plänen (Pro, Enterprise) verfügbar.

Zeitgesteuerte Ausführung

Im Zeitplan (Zahnrad-Icon auf den Import-Buttons) können Sie den automatischen Bildimport aktivieren:

1. Öffnen Sie die Zeitplan-Einstellungen für Delta- oder Vollimport
2. Aktivieren Sie die Checkbox "Bilder importieren"
3. Speichern Sie die Einstellungen

Bei jedem zeitgesteuerten Import wird automatisch auch der Bildimport gestartet.

Performance

Der Bild-Import ist für große Produktmengen optimiert:

• Paralleler Upload: Bis zu 3 Bilder gleichzeitig
• Intelligente Übersprung-Logik: Nur neue/geänderte Bilder werden hochgeladen
• Batch-Verarbeitung: Effiziente Verarbeitung großer Mengen

Unterstützte Formate

ReadySync unterstützt gängige Bildformate:

• ✅ JPEG (.jpg, .jpeg)
• ✅ PNG (.png)
• ✅ WebP (.webp)
• ✅ GIF (.gif)

Nächste Schritte

• Bildverzeichnis konfigurieren
• Bilder im Mapping zuordnen
• Trennzeichen konfigurieren
• Bild-Upload-Optionen