Mass Product Updater (CSV/Excel). Mass Product Updater importiert eine CSV- oder Excel-Datei (.xlsx) und aktualisiert Preis, Lagerbestand, Status und Kennzeichen Ihrer bestehenden Produkte. Sie speichern wiederverwendbare Profile für die Spaltenzuordnung, prüfen jede Änderung zeilenweise in einem Testlauf, bevor irgendetwas geschrieben wird, lassen den Import stapelweise laufen und erhalten dabei einen Fehlerbericht pro Zeile, und Sie machen den letzten Lauf bei Bedarf rückgängig. Ein per Token geschützter Cron automatisiert Lieferantenfeeds. Kein Code, keine Änderungen am Theme.
Mass Product Updater importiert eine CSV- oder Excel-Datei (.xlsx) und aktualisiert Preis, Lagerbestand, Status und Kennzeichen Ihrer bestehenden Produkte. Sie speichern wiederverwendbare Profile für die Spaltenzuordnung, prüfen jede Änderung im zeilenweisen Testlauf, bevor irgendetwas geschrieben wird, lassen den Import stapelweise laufen und erhalten dabei einen Fehlerbericht pro Zeile, und Sie machen den letzten Lauf bei Bedarf rückgängig. Ein per Token geschützter Cron automatisiert Lieferantenfeeds. Kein Code, keine Änderungen am Theme.
1. Installation
- Gehen Sie im Back Office auf Module → Modulmanager → Modul hochladen und wählen Sie die ZIP-Datei des Moduls aus.
- Klicken Sie nach der Installation auf Konfigurieren, um den Assistenten zu öffnen.
.local, .test, localhost) sind immer zugelassen. Sobald eine neue Version vorliegt, wird sie direkt im Modul angezeigt.Steht statt der Bestätigung „Upload failed“ da, hat PrestaShop das Modul möglicherweise abgeschaltet, ohne es Ihnen zu sagen: Einstellungen und Daten bleiben erhalten. Wie man ein Modul aktualisiert, und was bei „Upload failed“ zu tun ist.
2. Konfiguration: Schritt für Schritt
Die Seite Konfigurieren hat vier Reiter: Import / Aktualisierung, Zuordnungsprofile, Verlauf und Rückgängig sowie Einstellungen. Ein gewöhnlicher Import läuft als kurzer Assistent: hochladen → Spalten zuordnen → Testlauf → anwenden.
1. Eine CSV- oder Excel-Datei hochladen hier beginnen
Wählen Sie im Reiter Import / Aktualisierung eine Datei (.csv / .xlsx) und klicken Sie auf Hochladen. Erlaubt sind .csv, .txt und .xlsx bis 20 MB. CSV wird vollständig unterstützt; XLSX wird nach Möglichkeit gelesen, sofern die PHP-Erweiterungen ZIP und SimpleXML vorhanden sind. Wenn Sie bereits ein Profil gespeichert haben, wählen Sie es unter Gespeichertes Profil verwenden aus, damit Zuordnung und Leseoptionen vorbelegt werden. Wichtig: Dieses Werkzeug aktualisiert ausschließlich bestehende Produkte und legt niemals neue an.
2. Spalten zuordnen und Leseoptionen setzen
Nach dem Hochladen zeigt das Modul die Kopfzeile und die ersten Zeilen der Datei an, damit Sie jede Quellspalte zuordnen können. Setzen Sie oben die Leseoptionen, darunter die Spaltenzuordnung.
- Produkte erkennen über: das Kennzeichen, mit dem das Produkt gefunden wird, Produkt-ID, Artikelnummer, EAN13, UPC oder Lieferanten-Artikelnummer.
- Trennzeichen / Textbegrenzer: das Feldtrennzeichen (
\tfür Tabulator) und das Anführungszeichen. - Zeichensatz / Dezimalzeichen: der Zeichensatz der Datei (zum Beispiel
UTF-8,ISO-8859-1,Windows-1252; er wird nach UTF-8 umgewandelt) und das Dezimaltrennzeichen (.oder,). - Erste Zeile ist die Kopfzeile: ankreuzen, wenn Zeile 1 die Spaltennamen enthält.
- Wenn kein Produkt passt: Stillschweigend überspringen oder Im Protokoll vermerken.
- Zuordnungstabelle: Wählen Sie für jede Spalte, worauf sie abgebildet wird: ** ERKENNUNGSSCHLÜSSEL (Kennzeichen) **, Preis (netto), Einkaufspreis, Lagerbestand (Wert), Lagerbestand (Delta +/-), Sonderpreis (fest), Aktiv (0/1), Gewicht, Artikelnummer, EAN13, UPC, Mindestmenge, oder lassen Sie sie auf -- ignorieren --.
Genau eine Spalte muss als ERKENNUNGSSCHLÜSSEL gesetzt sein und mindestens eine Spalte auf ein Feld, das aktualisiert werden soll.
3. Testlauf und Vergleich empfohlen
Klicken Sie auf Testlauf (Vorschau), um den Import zu simulieren, ohne etwas zu schreiben. Das Modul meldet, wie viele Zeilen erkannt wurden, wie viele nicht gefunden wurden und wie viele einen Fehler ergaben, und öffnet die Laufdetails mit einem zeilenweisen Vergleich: Jedes geänderte Feld erscheint als alter Wert → neuer Wert. Prüfen Sie den Vergleich immer, bevor Sie anwenden.
4. Import ausführen (anwenden)
Wenn der Vergleich stimmt, klicken Sie auf Änderungen anwenden und bestätigen Sie. Der Import läuft stapelweise (die Stapelgröße in den Einstellungen bestimmt, wie viele Zeilen pro Transaktion verarbeitet werden). Am Ende erhalten Sie eine Übersicht, aktualisierte, nicht gefundene und fehlerhafte Zeilen von der Gesamtzahl, dazu die vollständigen Laufdetails mit dem Protokoll pro Zeile.
5. Zuordnungsprofile wiederverwendbar
Im Reiter Zuordnungsprofile speichern Sie eine Spaltenzuordnung einmal und verwenden sie für wiederkehrende Feeds erneut. Ein Profil merkt sich den Profilnamen, das Erkennungsfeld, Trennzeichen, Textbegrenzer, Zeichensatz und Dezimaltrennzeichen, die Kopfzeile, das Verhalten bei nicht gefundenen Produkten und die Zuordnung jeder Spalte (nach Spaltennummer, beginnend bei 0). Gespeicherte Profile lassen sich bearbeiten und löschen und stehen im Reiter Import sowie für den Cron zur Auswahl.
6. Verlauf und Rückgängig
Der Reiter Verlauf und Rückgängig listet die letzten Läufe mit Modus (Testlauf / angewendet), Quelle, Summen und Status. Öffnen Sie einen Lauf, um Statistik, Protokoll pro Zeile (nach Ergebnis filterbar) und die Schaltfläche Bericht herunterladen (CSV) zu sehen. Bei einem angewendeten Lauf können Sie auf Diesen Lauf rückgängig machen klicken, um die vorherigen Werte aller geänderten Felder wiederherzustellen, sofern die Sicherung vor dem Import aufbewahrt wurde (siehe Einstellungen).
7. Per Token geschützter Cron Automatisierung
Im Reiter Einstellungen liefert der Abschnitt Geplanter Import (Cron) eine fertige Cron-URL mit einem geheimen Token. Rufen Sie sie aus Ihrer Zeitsteuerung auf (zum Beispiel der Crontab), um das gewählte Cron-Profil auf die eingestellte Cron-Quelle anzuwenden: eine http(s)-Adresse eines Lieferantenfeeds oder schlicht den Namen einer Datei im Arbeitsordner des Moduls (modules/cll_csvimport/work/). Mit Cron-Token neu erzeugen wechseln Sie das Token. Das Token ist Pflicht und wird per Hash geprüft.
8. Einstellungen: Vorgaben und Daten
Der Reiter Einstellungen enthält außerdem: Modul aktivieren, die Stapelgröße (20 bis 5000 Zeilen pro Transaktion; je niedriger, desto schonender für kleine Server), die Standard-Leseoptionen (Trennzeichen, Textbegrenzer, Zeichensatz, Dezimaltrennzeichen, Kopfzeile, Verhalten bei nicht gefundenen Produkten), mit denen neue Importe vorbelegt werden, Sicherung vor dem Import aufbewahren (nur damit ist Rückgängig möglich, lassen Sie es an) und Daten bei Deinstallation löschen (standardmäßig aus; ist es an, löscht die Deinstallation alle Profile und den gesamten Verlauf).
3. Prüfen, ob alles läuft
- Laden Sie eine kleine Datei hoch und starten Sie einen Testlauf; öffnen Sie die Laufdetails und prüfen Sie, ob der zeilenweise Vergleich die erwarteten Werte zeigt, alt → neu.
- Führen Sie Änderungen anwenden für zwei, drei Zeilen aus, öffnen Sie danach die betroffenen Produkte und prüfen Sie, ob Preis und Bestand wie angezeigt geändert wurden.
- Öffnen Sie diesen angewendeten Lauf unter Verlauf und Rückgängig und klicken Sie auf Diesen Lauf rückgängig machen; kontrollieren Sie, ob die Produkte wieder ihre alten Werte haben.
- Fügen Sie die Cron-URL in einen Browser ein (oder rufen Sie sie mit
curlauf): Im Verlauf muss ein Lauf mit dem eingestellten Profil und der eingestellten Quelle erscheinen.
4. Häufige Fragen
Legt das Modul neue Produkte an?
Nein. Mass Product Updater aktualisiert ausschließlich Produkte, die bereits vorhanden sind. Zeilen, deren Kennzeichen zu keinem Produkt passt, werden übersprungen oder vermerkt, aber nie angelegt.
Welche Dateiformate werden unterstützt?
CSV (und tabulatorgetrennter Text .txt) wird vollständig unterstützt. Excel .xlsx wird nach Möglichkeit gelesen, sofern die PHP-Erweiterungen ZIP und SimpleXML vorhanden sind. Dateien werden bis 20 MB angenommen.
Wie werden die Produkte erkannt?
Sie wählen einen Erkennungsschlüssel, Produkt-ID, Artikelnummer, EAN13, UPC oder Lieferanten-Artikelnummer, und ordnen ihm eine Spalte zu. Jede Zeile wird über dieses Kennzeichen einem Produkt zugeordnet, bevor ein einziges Feld geändert wird.
Ist das Rückgängigmachen sicher?
Ja, solange Sicherung vor dem Import aufbewahren aktiv ist (Standard). Das Modul hält den vorherigen Wert jedes geänderten Feldes fest und stellt einen angewendeten Lauf damit genau wieder her. Ein Lauf lässt sich nur ein einziges Mal rückgängig machen.