- moduł został kompletnie przepisany pod nowy PrestaShop 9.x
XML-Quellen und Anpassung des Katalogs an den Shop
- Mehrere Datenquellen: Jede Quelle hat einen eigenen Namen, eine Verbindungskonfiguration, einen Aktivitätsstatus und einen zugewiesenen Adapter, also einen Mechanismus, der ihre XML-Struktur ausliest.
- Allgemeine und individuelle Einstellungen: Ausgewählte Importparameter können für eine bestimmte Quelle überschrieben werden, unter anderem der Preisbereich, Aktualisierungsregeln, das Herunterladen von Bildern und die Vorgehensweise bei fehlenden Produkten.
- Hinzufügen von Produkten und Aktualisierung bestehender Produkte: Das Modul speichert Verknüpfungen zwischen Quellprodukten und Produktkarten in PrestaShop und nutzt diese bei weiteren Importen.
- Anpassung an den eigenen Katalog: Bestehende Produkte können anhand des ausgewählten Feldes erkannt werden: Produktreferenz, EAN-13, UPC oder MPN, sofern das jeweilige Feld in der verwendeten Shop-Version verfügbar ist. Die Wirksamkeit der Zuordnung hängt von der Übereinstimmung und Eindeutigkeit der Kennungen ab.
- Kategoriezuordnung: Quellkategorien können mit Shop-Kategorien verknüpft oder während des Imports erstellt werden. Die Konfiguration umfasst die Standardkategorie sowie die Aktivität der Verknüpfungen.
- Zuordnung von Herstellern, Lieferanten, Merkmalen und Attributen: Separate Ansichten helfen dabei, Quelldaten den entsprechenden Elementen des PrestaShop-Katalogs zuzuweisen. Es stehen auch automatische Zuordnungsoperationen anhand von Namen zur Verfügung.
Import von Produktdaten und Kontrolle der Aktualisierung
- Namen und Beschreibungen: Import von Name, Langbeschreibung und Kurzbeschreibung, mit separaten Schaltern für deren Aktualisierung. Die Daten müssen von der Quelle bereitgestellt und von ihrem Adapter unterstützt werden.
- Kennungen und physische Parameter: Unterstützung für Referenz, EAN-13, UPC, MPN, Gewicht und Produktabmessungen, abhängig von den Quelldaten und der Verfügbarkeit der Felder in PrestaShop.
- Preise und Verfügbarkeit: Aktualisierung von Verkaufspreis, Einkaufspreis, Menge sowie Aktivitätsstatus des Produkts in dem von der Quelle unterstützten Umfang. Das Modul ermöglicht außerdem die Konfiguration von Verfügbarkeitstexten und Hinweisen zur Lieferzeit.
- Produktbilder: Herunterladen von Bildern aus in den Daten übergebenen Adressen, Möglichkeit zum Deaktivieren des Bilddownloads sowie zur Begrenzung der Anzahl importierter Bilder. Die Aktualisierung von Bildern kann separat für importierte Produkte und für Produkte gesteuert werden, die dem bestehenden Katalog zugeordnet wurden.
- Technische Merkmale: Zuweisung von Merkmalen zu Produkten sowie Auswahl zwischen dem Ersetzen ihres Satzes und dem Zusammenführen. Beim Zusammenführen werden die im Import vorhandenen Merkmale aktualisiert und die übrigen Produktmerkmale beibehalten.
- Produktkombinationen: Ein vollständiger Import kann Varianten auf Basis der unterstützten Kombinationsstruktur, ihrer Attribute, Kennungen, Mengen sowie der Auswirkung auf Preis und Gewicht erstellen und aktualisieren.
- Separate Regeln für zugeordnete Produkte: Für vom Importer erstellte Produktkarten können andere Aktualisierungseinstellungen verwendet werden als für Produkte, die im bestehenden Katalog anhand einer Kennung erkannt wurden.
Bei der Aktualisierung von Kombinationen ordnet das Modul Varianten anhand von Attributsätzen zu, fügt neue hinzu und kann bestehende Varianten entfernen, die im übergebenen Satz nicht vorhanden sind. Es gibt auch eine Option zum Entfernen bisheriger Kombinationen bei der ersten Zuordnung eines Produkts. Die Wahl dieser Einstellungen ist für Shops wichtig, die eigene Varianten pflegen.
Preisregeln und Auswahl des importierten Sortiments
- Preisberechnung: Die Regeln unterstützen das Addieren und Subtrahieren eines Betrags, das Multiplizieren sowie das Erhöhen oder Verringern des Preises um einen Prozentsatz. Eine prozentuale Erhöhung bedeutet einen Aufschlag auf den Quellpreis.
- Regelbedingungen: Der Preis kann vom Bereich des Eingangspreises, der Kategorie, dem Hersteller und dem Lieferanten abhängig gemacht werden. Regeln können allgemein sein oder einer bestimmten Quelle zugewiesen werden.
- Prioritäten: Der Importer wählt eine passende Preisregel nach Priorität aus und berücksichtigt bei gleicher Priorität die Detailgenauigkeit ihrer Bedingungen.
- Aufschlag und Rundung: Nach Anwendung der Regel kann ein konfigurierter Betrag hinzugefügt und am Ende der Netto- oder Bruttopreis auf eine volle Einheit gerundet werden.
- Verknüpfung von Steuersätzen mit den Shop-Steuern: Die Konfiguration ermöglicht es, unterstützte MwSt.-Sätze aus den Quelldaten den in PrestaShop vorhandenen Steuerregelgruppen zuzuweisen.
- Importfilter: Es stehen eine untere und obere Schwelle des Quellpreises sowie Einstellungen für den Import von Produkten ohne Bilder und mit einer Menge von null zur Verfügung.
- Produkte, die aus dem XML verschwinden: Nach Abschluss eines vollständigen Imports können sie unverändert belassen, deaktiviert, die Menge des Basisprodukts auf null gesetzt oder die Deaktivierung mit dem Nullsetzen dieser Menge kombiniert werden.
Vorbereitung von Inhalten und SEO-Feldern der Produkte
- Wörterbuch für Textänderungen: Ersetzung bestimmter Fragmente in Namen, Lang- und Kurzbeschreibungen sowie in den Feldern Meta Title und Meta Description. Die Regeln können einfache Ersetzungen oder reguläre Ausdrücke verwenden.
- Namensvorlagen: Die Konfiguration ermöglicht es, Namen aus verfügbaren Daten wie Quellname, Referenz, Hersteller, Lieferant oder EAN aufzubauen. Das Wörterbuch bietet eine Vorschau der Umwandlung anhand eines Beispieltexts.
- Eigene Beschreibungsfragmente: Möglichkeit, Inhalte vor und nach der Lang- oder Kurzbeschreibung hinzuzufügen, mit Spracheinstellungen und individuellen Einstellungen pro Quelle.
- SEO-Felder: Unterstützung für vom Adapter übergebene Meta-Titel und Meta-Beschreibung sowie Erstellung eines suchmaschinenfreundlichen URL-Fragments des Produkts auf Basis des Namens. Bei der Aktualisierung bestehender Produkte sind die SEO-Felder mit der Einstellung zur Aktualisierung des Namens verknüpft.
- Mehrsprachige Daten: Der Import kann Sprachversionen verwenden, die von der Quelle und dem Adapter bereitgestellt werden. Falls diese fehlen, kann der Mechanismus verfügbare Inhalte in andere Sprachen übernehmen; eine automatische Übersetzung wird nicht durchgeführt.
Automatisierung des Imports und Überwachung der Vorgänge
- Import in Etappen im Panel: Separate Vorgänge zum Abrufen des XML, zur Vorbereitung von Kategorien, Herstellern, Lieferanten, Merkmalen und Attributen sowie zum Produktimport.
- Verarbeitung in Chargen: Konfigurierbare Anzahl von Produkten pro Charge sowie Auslesen von Datensätzen über XMLReader. Dadurch kann der Importverlauf an die Serverressourcen angepasst werden; die Ausführungszeit hängt auch von den Bildern und der Datengröße ab.
- Fortschritt, Pause und Fortsetzen: Das Panel zeigt den Fortschritt und die Zähler der Vorgänge an. Mit Pause kann die laufende Charge abgeschlossen und anschließend die nächste angehalten werden; der gespeicherte Fortschritt ermöglicht das Fortsetzen der Arbeit.
- Überspringen unveränderter Datensätze: Der Importer vergleicht Prüfsummen der Produktdaten. Das Erzwingen einer Aktualisierung ermöglicht die erneute Verarbeitung von Datensätzen auch nach einer Änderung der Einstellungen, trotz unverändertem XML.
- Schnellaktualisierung: Ein separater Vorgang ruft Daten über den Adapter ab und aktualisiert Preise sowie Mengen der Basisprodukte, die bereits mit der jeweiligen Quelle verknüpft sind. Es werden keine neuen Produktkarten erstellt und keine Beschreibungen, Bilder oder Bestände einzelner Kombinationen aktualisiert.
- CRON: Aufrufadressen mit Zugriffsschlüssel ermöglichen das Starten von Vorgängen für die angegebene Quelle. Der Zeitplan muss auf dem Server oder in einem externen Dienst konfiguriert werden, unter Berücksichtigung des Datenabrufs und der Verarbeitung weiterer Chargen.
- Verlauf und Export von Logs: Speicherung von Sitzungen, Zusammenfassungen der Vorgänge, Warnungen und Fehlern, Filterung von Einträgen sowie Export des Protokolls nach CSV.
- Auswahl der Zielshops: Die Konfiguration ermöglicht die Auswahl der Shops in einer Multistore-Installation, in die Produkte übernommen werden sollen. Ein Teil der Produktdaten und Einstellungen bleibt entsprechend ihrem Geltungsbereich in PrestaShop und im Modul gemeinsam.
Vorteile für den Shop-Betrieb
- Weniger manuelles Übertragen: Katalogdaten, Bilder und Verfügbarkeit gelangen im Rahmen des konfigurierten Imports in die Produktkarten.
- Kontrolle über eigene Inhalte: Durch das Deaktivieren der Aktualisierung von Namen oder Beschreibungen können ausgewählte im Shop vorbereitete Materialien während eines vollständigen Imports beibehalten werden.
- Wiederholbare Preisregeln: Dieselbe Konfiguration zur Preisberechnung kann bei weiteren Aktualisierungen der Quelle verwendet werden.
- Einfachere Ursachenanalyse bei Problemen: Fortschritt, Zusammenfassungen und Logs helfen dabei, hinzugefügte, aktualisierte und übersprungene Datensätze zu unterscheiden und Importfehler zu prüfen.
Wie bereitet man einen XML-Import für PrestaShop vor?
- Bereiten Sie den Zugriff auf das XML vor und bestätigen Sie, dass seine Struktur sowie die benötigten Felder vom Adapter der Quelle unterstützt werden.
- Erstellen Sie eine Quelle, richten Sie die Verbindung ein und wählen Sie die Zielshops aus.
- Rufen Sie die Daten ab und bereiten Sie die Verknüpfungen von Kategorien, Herstellern, Lieferanten, Merkmalen und Attributen vor, die für den jeweiligen Katalog benötigt werden.
- Legen Sie Preisregeln, Filter und den Umfang der Datenüberschreibung fest und starten Sie anschließend den Produktimport.
- Prüfen Sie das Ergebnis in den Produktkarten und in den Logs und konfigurieren Sie danach zyklische Aufrufe der entsprechenden CRON-Vorgänge.
Funktionsumfang und Anforderungen
Die Struktur der Quelle erfordert eine Anpassung. Allein die XML-Erweiterung bedeutet nicht, dass die Datei mit dem Importer kompatibel ist. Eine andere Datenstruktur kann die Vorbereitung oder Änderung des Adapters erfordern; der Importumfang hängt von den Feldern ab, die tatsächlich von der Quelle bereitgestellt werden. Das Modul ist kein Importer für XLSX-Tabellen oder CSV-Dateien.
Vollständiger Import und Schnellaktualisierung haben einen unterschiedlichen Umfang. Die Schalter zum Überschreiben von Feldern betreffen den vollständigen Importpfad. Die Schnellaktualisierung über den Adapter speichert Preis und Menge des Basisprodukts unabhängig von diesen Schaltern. Die Unterstützung mehrerer Quellen bedeutet nicht die automatische Summierung ihrer Bestände oder die Auswahl des günstigsten Angebots.
Das Modul speist den Produktkatalog; es übermittelt keine Bestellungen an den Großhändler und reserviert keine Ware beim Lieferanten. Die Aktualität der Daten hängt von der Veröffentlichung des XML und der Häufigkeit der Ausführung des Imports ab. Beschreibungen und Meta-Felder werden anhand von Daten und Regeln verarbeitet, ohne Inhaltserstellung durch KI.
Link zur Modul-Demo:
Demo des Administrationspanels:
https://moduly-prestashop.eu/pdxmlimport/admin-dev
Demo des Frontends:
https://moduly-prestashop.eu/pdxmlimport