CSV- & XML-Import/Export für PrestaShop — Vollständiges Handbuch
CSV- & XML-Import/Export installieren und konfigurieren: Profile, visuelles Mapping, FTP/SFTP/URL-Quellen, Cron, Protokolle.
DF CSV & XML Pro ist eine universelle Import-/Export-Engine für PrestaShop 8 und 9. Es verbindet jede CSV- oder XML-Datei über ein visuelles Spalten-Mapping mit Ihrem Shop, speichert jede Konfiguration in einem wiederverwendbaren Profil und kann Ihre Lieferanten-Feeds automatisch von FTP, SFTP oder einer URL abholen. Dieses Handbuch behandelt Installation, Profilerstellung, die erwarteten Spaltenformate, Cron-Planung, Protokolle und Fehlerbehebung.
Installation
Gehen Sie zu Module > Modul-Manager > Modul hochladen, senden Sie die Datei dfcsvpro.zip und klicken Sie auf Installieren. Nach der Installation erscheint ein Tab DF CSV Pro unter Erweiterte Parameter.
Das Modul fügt keinen PrestaShop-Core-Override hinzu und deinstalliert sich sauber. Zwei Tabellen werden angelegt (Profile und Protokolle) sowie einige Konfigurationswerte; sie werden bei der Deinstallation entfernt.
Ein Profil erstellen
Ein Profil beschreibt einen vollständigen Vorgang: Richtung (Import oder Export), Entität, Format, Quelle, Spalten-Mapping, Optionen und Zeitplan. Es startet mit einem Klick oder wird automatisch per Cron ausgelöst. Klicken Sie auf Neues Profil: Ein Assistent führt Sie durch vier Schritte.
1. Allgemein
Wählen Sie die Richtung (Import / Export), die Entität, das Format (CSV oder XML) und die Ziel-Sprache. Stellen Sie für CSV das Trennzeichen ein (oder lassen Sie die Auto-Erkennung aktiv), die Kodierung (UTF-8, ISO-8859-1 oder Windows-1252), die Anzahl der vor der Kopfzeile zu überspringenden Zeilen und das Mehrfachwert-Trennzeichen (standardmäßig Komma). Für XML können Sie den Item-Knoten angeben oder ihn vom Modul erkennen lassen.
Verfügbare Entitäten beim Import: Produkte, Kombinationen, Kategorien, Kunden, Bestand & Preise. Beim Export: Produkte, Kategorien, Kunden, Bestellungen.
2. Quelle
Wählen Sie, woher die Datei kommt (Import) oder wohin das Ergebnis abgelegt wird (Export): manueller Upload, URL (HTTP/HTTPS), FTP, SFTP oder lokaler Pfad. Geben Sie für FTP/SFTP Host, Port, Benutzer und Passwort ein und verwenden Sie die Schaltfläche Verbindung testen, um vor dem Speichern zu validieren.
3. Visuelles Mapping
Laden Sie eine Beispieldatei hoch (oder holen Sie sie aus der entfernten Quelle): Das Modul erkennt die Spalten, zeigt eine Vorschau der ersten Zeilen und ordnet jede Spalte dank FR/EN-Erkennung automatisch dem richtigen PrestaShop-Feld zu (Referenz/SKU, Preis, Menge/Bestand, EAN/Barcode, MwSt. usw.). Passen Sie die Zuordnungen in der Tabelle an; jede auf „nicht zugeordnet“ belassene Spalte wird einfach ignoriert.
Der Abgleichsschlüssel (Schritt 4) bestimmt, wie ein bestehendes Produkt gefunden wird: ID, Referenz/SKU, EAN-13 oder MPN. Stellen Sie sicher, dass die entsprechende Spalte zugeordnet ist.
4. Optionen & Zeitplan
Legen Sie das Import-Verhalten fest: fehlende Elemente anlegen, bestehende aktualisieren, Kategorien spontan anlegen, Bilder aus URLs herunterladen, bestehende Bilder bei der Aktualisierung ersetzen oder behalten, und die Batch-Größe (pro AJAX-Aufruf verarbeitete Zeilen). Aktivieren Sie optional die Planung und wählen Sie die Frequenz (stündlich, täglich oder wöchentlich). Speichern: Das Profil erscheint in der Liste, bereit zum Ausführen oder Planen.
Spaltenformate
Das Modul versteht die Geschäftsformate von PrestaShop. Hier die in Ihren Dateien erwarteten Konventionen:
| Feld | Erwartetes Format |
|---|---|
| Preis | Dezimal, Komma oder Punkt: 19,90 oder 19.90 |
| Boolesche Werte (aktiv usw.) | 1/0, yes/no, ja/nein, true/false |
| Kategorien | Namen oder IDs, getrennt durch das Mehrfachwert-Trennzeichen (Standard ,). Optionale spontane Anlage. |
| Bilder | URLs, getrennt durch das Mehrfachwert-Trennzeichen. Die erste wird zum Titelbild. |
| Merkmale | Name:Wert|Name:Wert |
| Kombinationen | Gruppe:Wert|Gruppe:Wert (z. B. Größe:M|Farbe:Rot) |
| MwSt.-Satz | Numerischer Wert (z. B. 20), verknüpft mit der Steuergruppe des Standardlands |
Kombinationen
Die Attributspalte folgt dem Format Gruppe:Wert|Gruppe:Wert. Fehlende Attributgruppen und -werte werden automatisch angelegt, und die Kombination wird an ihrem exakten Attributsatz erkannt — ein erneuter Import erzeugt daher keine Duplikate. Das übergeordnete Produkt wird je nach Abgleichsschlüssel über seine Referenz oder ID gefunden.
Merkmale
Verwenden Sie das Format Name:Wert|Name:Wert. Jedes Merkmal und sein Wert werden angelegt, falls sie noch nicht existieren.
Kategorien, Bilder und Tags
Diese Felder akzeptieren mehrere Werte, getrennt durch das im Profil definierte Mehrfachwert-Trennzeichen. Bei Kategorien können Sie Namen und IDs mischen; das erste aufgeführte Bild dient als Titelbild.
Entfernte Quellen und Sicherheit
Beim Import holt das Modul die Datei von einer URL (HTTP/HTTPS, bei Bedarf mit Basic-Authentifizierung), einem FTP-Server (passiver oder aktiver Modus), einem SFTP-Server oder einem auf das Shop-Verzeichnis beschränkten lokalen Pfad. Beim Export kann es die erzeugte Datei auf FTP/SFTP oder in einem lokalen Ordner ablegen oder zum Download anbieten.
SFTP benötigt die PHP-Erweiterung ssh2. Fehlt sie in Ihrem Hosting, weist die Oberfläche deutlich darauf hin, und Sie können stattdessen FTP oder eine URL verwenden.
FTP-/SFTP-Passwörter werden ruhend in der Datenbank verschlüsselt (AES-256-CBC, Schlüssel abgeleitet vom Verschlüsselungsschlüssel Ihres Shops) und nie im Klartext an den Browser zurückgegeben.
Batch-Import und Wiederaufnahme
Manuelle Importe laufen in aufeinanderfolgenden AJAX-Batches, mit einem Fortschrittsbalken und Echtzeit-Zählern (OK / Fehler / gesamt). Nach jedem Batch wird die exakte Position gespeichert: Eine Datei mit Zehntausenden Zeilen wird ohne PHP-Timeout importiert, selbst beim Shared Hosting. Im Cron-Modus läuft die Verarbeitung synchron bis zur letzten Zeile.
Export
Erstellen Sie ein Export-Profil, indem Sie die Entität (Produkte, Kategorien, Kunden, Bestellungen), das Format (CSV oder XML) und die einzuschließenden Felder wählen. Die erzeugte Datei wird zum sofortigen Download angeboten und/oder automatisch auf dem konfigurierten entfernten Ziel abgelegt. Exporte werden in Batches erzeugt, um bei großen Volumen performant zu bleiben.
Planung (Cron)
Um ein Profil zu automatisieren, aktivieren Sie seine Planung (Schritt 4) und rufen dann die Cron-URL des Moduls in regelmäßigen Abständen auf. Bei jedem Aufruf laufen nur die Profile, deren Frequenz fällig ist.
*/15 * * * * curl -s "https://ihr-shop.tld/index.php?fc=module&module=dfcsvpro&controller=cron&token=IHR_TOKEN" > /dev/nullDie genaue URL und der Token befinden sich im Tab Scheduling / Cron des Moduls, mit einer Schaltfläche zum Regenerieren des Tokens. Zwei optionale Parameter:
&id_profile=N: führt nur das angegebene Profil aus.&force=1: ignoriert die Frequenzprüfung und führt das Profil sofort aus.
Der Shop muss erreichbar sein, damit der Cron funktioniert: Der Wartungsmodus blockiert die Front-Controller, einschließlich dieses Endpunkts.
Protokolle und E-Mail-Benachrichtigungen
Jeder Durchlauf wird mit seinem Status, seinen Zählern und zeilenweisem Fehlerdetail protokolliert (die ersten 200). Der Tab Logs listet den Verlauf auf und lässt Sie die Fehler eines Imports einsehen. Sobald ein Import fehlschlägt oder fehlerhafte Zeilen enthält, wird automatisch eine E-Mail-Benachrichtigung (FR- oder EN-Vorlage) an die in den Einstellungen konfigurierte Adresse gesendet.
Einstellungen
Im Tab Einstellungen aktivieren oder deaktivieren Sie E-Mail-Benachrichtigungen, legen die Empfängeradresse, die Standard-Batch-Größe und die Aufbewahrungsdauer der Protokolle fest (ältere Protokolle werden automatisch bereinigt). Temporäre Import-/Export-Dateien werden nach 48 Stunden entfernt.
XML-Format
Beim XML-Import wird der wiederholte Item-Knoten automatisch erkannt (oder im Profil angegeben). Die Items werden abgeflacht: verschachtelte Elemente werden zu Eltern/Kind-Spalten, Attribute zu @attribut, und wiederholte Elemente werden mit name#1, name#2 suffigiert. Diese abgeflachten Spalten ordnen Sie dann wie bei einer CSV zu.
Kompatibilität und technische Hinweise
- Kompatibel mit PrestaShop 8.0 bis 9.x, PHP 7.4 bis 8.3, Multishop.
- CSV: automatische Trennzeichen-Erkennung, BOM-Handhabung, Kodierungsumwandlung ISO-8859-1 und Windows-1252.
- Kunden mit bcrypt-gehashtem Passwort importiert und per Name einer Gruppe zugewiesen.
- Kein Core-Override; das Legacy-AJAX verwendet die PS9-Konventionen.
Fehlerbehebung
Die Modul-Oberfläche bleibt leer oder die Dropdowns füllen sich nicht. Leeren Sie den PrestaShop-Cache und erzwingen Sie dann ein Neuladen des Browsers (Strg+Umschalt+R). Wenn ein Cache-/CCC-Manager aktiv ist, regenerieren Sie die Assets.
SFTP schlägt fehl. Prüfen Sie, ob die PHP-Erweiterung ssh2 auf dem Server installiert ist; andernfalls verwenden Sie FTP oder eine URL.
Der Cron löst nicht aus. Prüfen Sie den Token, dass der Shop nicht im Wartungsmodus ist, und dass das Profil eine aktivierte Planung und eine automatische Quelle hat (Profile mit manuellem Upload können nicht geplant werden).
Einige Zeilen sind fehlerhaft. Öffnen Sie das Protokolldetail: Jeder Fehler zeigt die Zeilennummer und die Ursache (fehlende Schlüsselspalte, ungültiger Wert usw.).