MAGENTO 2 · KATEGORIEN · CSV · STORE VIEW

Kowal Export Import Categories

Exportieren Sie Kategorieattribute in eine CSV-Datei, bereiten Sie Änderungen in einer Tabelle vor und importieren Sie sie in die richtige Store View. Kontrollieren Sie leere Werte, URLs, Bilder und den Bericht jedes Durchlaufs.

Update und Insert · Dry Run · Übersetzungen und benutzerdefinierte Attribute

SO FUNKTIONIERT ES IN DER PRAXIS

Kowal_ExportImportCategories ist ein Magento 2 Modul zum Export und Import von Kategorieattributen im CSV-Format unter Berücksichtigung der ausgewählten store view. Die Erweiterung wurde für Shops entwickelt, die mit mehreren Sprachversionen oder mehreren Store Views arbeiten oder Kategoriedaten gesammelt aktualisieren müssen, ohne jede Kategorie manuell im Admin-Panel zu bearbeiten.

Mit dem Modul können Kategorien in eine CSV-Datei exportiert, ausgewählte Attribute außerhalb von Magento geändert und anschließend im Modus zur Aktualisierung bestehender Kategorien oder zur Erstellung neuer Kategorien wieder importiert werden. Der Import erfolgt in der angegebenen store view, sodass Übersetzungen von Namen, Beschreibungen, Meta-Tags, URLs und anderen Kategorieattributen komfortabel vorbereitet werden können.

Das Modul ist vorgesehen für:

• Magento 2 Shops mit mehreren Sprachversionen,
• Content-Teams, die mit CSV-Tabellen arbeiten,
• Agenturen, die Kategoriekataloge zwischen Umgebungen übertragen,
• Administratoren, die Namen, Beschreibungen, Metadaten und Kategorie-URLs gesammelt aktualisieren müssen,
• Shops mit benutzerdefinierten Kategorieattributen, die diese gesammelt verwalten möchten,
• Projekte, in denen Kategoriedaten außerhalb von Magento vorbereitet werden, z. B. durch Übersetzer, die SEO-Abteilung oder ein PIM-System.

• Export von Kategorien in eine CSV-Datei für die ausgewählte store view.
• Import von Kategorien aus einer CSV-Datei für die ausgewählte store view.
• Modus zur Aktualisierung bestehender Kategorien: update.
• Modus zur Erstellung neuer Kategorien: insert.
• Auswahl der in die CSV-Datei zu exportierenden Attribute.
• Auswahl der aus der CSV-Datei zu importierenden Attribute.
• Automatische Systemspalten zur Identifikation von Kategorien.
• Validierung der CSV-Kopfzeilen vor dem Import.
• Validierung der Spaltennamen anhand der tatsächlichen Magento-Kategorieattribute.
• Unterstützung benutzerdefinierter, in Magento hinzugefügter Kategorieattribute.
• Unterstützung von Textwerten für alle Attribute.
• Unterstützung der Attribute select und multiselect anhand der Optionslabels.
• Arbeit mit den in der Store View sichtbaren Werten oder ausschließlich mit Store-View-Überschreibungen.
• dry-run-Modus für eine vollständige Importvalidierung ohne Datenspeicherung.
• Richtlinie für leere Werte.
• Strategien zur Verarbeitung von url_key.
• Optionale Erstellung eines permanent redirect bei Änderung der Kategorie-URL.
• Unterstützung von Pfaden zu Kategoriebildern.
• Batch processing für größere Dateien.
• Richtlinien zur Fehlerbehandlung.
• CSV-Importbericht.
• Importhistorie im Admin-Panel.

Mit dem Export kann eine CSV-Datei mit Kategorien für die ausgewählte store view erstellt werden. Der Administrator wählt die Store View und die Kategorieattribute aus, die in die Datei aufgenommen werden sollen. Das Modul fügt automatisch die Systemspalten hinzu, die zur Identifikation der Kategorien und zur Beibehaltung der Baumstruktur erforderlich sind.

Der Export kann verwendet werden für:

• die Vorbereitung von Kategorieübersetzungen,
• die Prüfung von Kategoriedaten,
• die gesammelte Korrektur von SEO-Metadaten,
• den Vergleich von Werten zwischen Store Views,
• die Vorbereitung einer Datei für den Import in derselben oder einer anderen Umgebung,
• die Archivierung der aktuellen Kategoriedaten vor Änderungen.

Der Export umfasst Kategorieattribute. Das Modul exportiert keine den Kategorien zugeordneten Produkte. Es führt außerdem keine Löschvorgänge für Kategorien aus.

Der Administrator kann Folgendes auswählen:

• Store View,
• Startkategorie,
• zu exportierende Attribute,
• CSV-Trennzeichen,
• Store-View-Wertmodus.

Das Modul unterstützt zwei Modi für den Werteexport:

• resolved_value - exportiert wird der in der jeweiligen store view sichtbare Wert, also unter Berücksichtigung des Magento-Fallbacks auf den Standardwert.
• store_override_only - exportiert wird nur der direkt für die jeweilige store view überschriebene Wert; wird der Wert vererbt, bleibt die CSV-Zelle leer.

Der Modus resolved_value ist für die redaktionelle Arbeit praktisch, da er den tatsächlich im Shop sichtbaren Wert anzeigt. Der Modus store_override_only ist hilfreich, wenn ausschließlich Übersetzungen oder für eine bestimmte Store View spezifische Überschreibungen kontrolliert werden sollen.

Mit dem Import kann eine CSV-Datei eingelesen werden, um ausgewählte Kategorieattribute für die angegebene store view zu speichern. Die im Importformular ausgewählte Store View ist maßgeblich, während die Spalte store_view_code aus der CSV-Datei zur Validierung verwendet wird, ob die Datei mit der ausgewählten Store View übereinstimmt.

Der Import kann verwendet werden für:

• die Übersetzung von Kategorien,
• die Aktualisierung von Kategorienamen,
• die Aktualisierung von Kategoriebeschreibungen,
• die Aktualisierung von Meta-Tags,
• die Aktualisierung von url_key,
• die Erstellung neuer Kategorien,
• den Import benutzerdefinierter Kategorieattribute,
• die Aktualisierung von Menü- und Sichtbarkeitsattributen,
• den Import von Pfaden zu Kategoriebildern.

Der Modus update aktualisiert bestehende Kategorien. In diesem Modus erstellt das Modul keine neuen Kategorien.

Die Kategorie wird in erster Linie anhand von entity_id gesucht. Wenn entity_id nicht verfügbar ist, kann das Modul category_path verwenden, sofern der Pfad eindeutig auf eine Kategorie verweist.

Der Modus update wird empfohlen für:

• Kategorieübersetzungen zwischen Store Views,
• SEO-Korrekturen,
• die Aktualisierung von Beschreibungen,
• die Aktualisierung von Namen,
• die Änderung von Werten benutzerdefinierter Kategorieattribute.

Beispiel für einen Übersetzungsablauf:

1. Kategorien aus der Basis-Store-View exportieren.
2. store_view_code in der CSV-Datei in den Code der Ziel-Store-View ändern.
3. Dieselben entity_id beibehalten.
4. Übersetzungen in den Spalten name, description, meta_title, meta_description ergänzen.
5. Import im Modus update für die Ziel-Store-View ausführen.

In dieser Variante speichert das Modul die ausgewählten Attribute im Kontext der numerischen store_id, die im Importformular ausgewählt wurde.

Der Modus insert erstellt neue Kategorien. In diesem Modus ist entity_id nicht erforderlich, da Magento sie automatisch vergibt.

Für eine neue Kategorie muss das übergeordnete Element angegeben werden über:

• parent_entity_id,
• oder parent_path.

Der Modus insert wird empfohlen für:

• die Erstellung neuer Kategoriestrukturen,
• die Übertragung eines Kategoriebaums zwischen Umgebungen,
• die Vorbereitung von Kategorien in einer CSV-Tabelle,
• die Erstellung von Kategorien auf Grundlage externer Daten.

Wenn der Import sowohl übergeordnete als auch untergeordnete Kategorien enthält, sollten die Daten von den Kategorien der höheren Ebene zu den Kategorien der niedrigeren Ebene angeordnet sein.

Die erste Zeile der CSV-Datei muss die Spaltenüberschriften enthalten. Die Spalten werden unterteilt in:

• Systemspalten,
• Spalten mit Kategorieattributen.

Die Attributspalten müssen den Magento-Attributcodes entsprechen, z. B.:

• name,
• url_key,
• description,
• meta_title,
• meta_description,
• is_active,
• include_in_menu.

Das Modul verwendet die folgenden Systemspalten:

• store_view_code,
• entity_id,
• parent_entity_id,
• category_path,
• parent_path,
• level,
• position,
• attribute_set_id.

Systemspalten werden nicht als EAV-Attribute behandelt. Sie dienen zur Identifikation von Kategorien, zur Validierung der Store View und zur Wiederherstellung der Baumstruktur.

store_view_code,entity_id,category_path,name,url_key,is_active,include_in_menu,meta_titlepl,13,Default Category/Gear/Bags,Torby,torby,1,1,Torbypl,14,Default Category/Gear/Fitness Equipment,Sprzet fitness,sprzet-fitness,1,1,Sprzet fitness

store_view_code,parent_entity_id,parent_path,category_path,name,url_key,is_active,include_in_menudefault,12,Default Category/Gear,Default Category/Gear/Helmets,Helmets,helmets,1,1default,12,Default Category/Gear,Default Category/Gear/Gloves,Gloves,gloves,1,1

Das Modul speichert Werte in der CSV-Datei als Text. Dadurch kann die Datei in einer Tabellenkalkulation bearbeitet, an einen Übersetzer weitergegeben oder automatisch in einem externen System vorbereitet werden.

Bei Attributen vom Typ select und multiselect arbeitet das Modul mit Optionslabels und nicht mit technischen Options-IDs. Dadurch enthält die CSV-Datei verständliche Werte wie Products only, Position oder Price.

Bei multiselect werden mehrere Werte durch das Trennzeichen | getrennt.

Beispiel:

store_view_code,entity_id,category_path,display_mode,available_sort_by,default_sort_bydefault,13,Default Category/Gear/Bags,Products only,Position|Product Name|Price,Position

Wenn ein Optionslabel nicht vorhanden oder nicht eindeutig ist, meldet der Import einen Validierungsfehler.

Während des Imports wählt der Administrator aus, wie leere CSV-Zellen interpretiert werden:

• skip_empty - eine leere Zelle ändert den vorhandenen Wert nicht.
• clear_value - eine leere Zelle löscht den Attributwert für die ausgewählte Store View.
• use_default - eine leere Zelle entfernt die Store-View-Überschreibung und ermöglicht Magento die Verwendung des Standardwerts.

Für Aktualisierungen wird standardmäßig skip_empty empfohlen, da dadurch das Risiko einer versehentlichen Löschung von Daten verringert wird.

Mit dem Modul kann die Verarbeitungsstrategie für url_key konfiguriert werden:

• use_csv_value - verwendet den Wert aus der CSV-Datei.
• generate_from_name - generiert url_key auf Grundlage des Attributs name.
• keep_existing - behält im Modus update den aktuellen url_key bei.
• magento_default - überlässt die URL-Verarbeitung dem Standardmechanismus von Magento.

Der Administrator kann außerdem festlegen, ob bei einer Änderung von url_key permanent redirects erstellt werden sollen.

Diese Konfiguration ist bei Übersetzungen besonders wichtig, da verschiedene Shops unterschiedliche Strategien verwenden können:

• übersetzte URLs für jede Sprache,
• gemeinsame URLs für mehrere Sprachversionen,
• automatisch aus Kategorienamen generierte URLs,
• manuell verwaltete SEO-URLs.

Das Modul kann Attribute von Kategoriebildern importieren, wenn die entsprechenden Spalten für den Import ausgewählt wurden.

Standardmäßiges Quellverzeichnis:

pub/media/import/categories

In der CSV-Datei wird ein Textpfad relativ zu diesem Verzeichnis angegeben, z. B.:

gear/bags.jpg

Das Modul validiert das Vorhandensein der Datei und ihre Erweiterung. Unterstützt werden sichere Bildformate wie:

• jpg,
• jpeg,
• png,
• webp,
• gif.

Im Modus dry-run kann die Importvalidierung ausgeführt werden, ohne Daten in Magento zu speichern.

In diesem Modus führt das Modul folgende Schritte aus:

• liest die CSV-Datei ein,
• validiert die Kopfzeilen,
• validiert die Store View,
• prüft das Vorhandensein von Kategorien oder übergeordneten Kategorien,
• prüft Attribute,
• ordnet Werte für select und multiselect zu,
• prüft Bilder,
• erstellt einen Fehler- und Warnungsbericht,
• speichert keine Kategorien.

Dies ist der empfohlene erste Schritt vor jedem größeren Import.

Der Import erfolgt in Batches. Die Batch-Größe kann im Importformular konfiguriert werden.

Standardwert:

100 wierszy

Batch processing verringert bei größeren Dateien das Risiko von Timeouts und übermäßigem Speicherverbrauch.

Das Modul unterstützt drei Verhaltensvarianten bei Fehlern:

• skip_invalid_rows - fehlerhafte Zeilen werden übersprungen, korrekte Zeilen werden weiter importiert.
• stop_on_first_error - der Import wird beim ersten Fehler angehalten.
• all_or_nothing - wenn bei der Validierung einer beliebigen Zeile vor dem Speichern ein Fehler erkannt wird, beginnt der Import nicht mit der Speicherung.

Für große Importe wird skip_invalid_rows empfohlen, da damit korrekte Daten verarbeitet und für die übrigen Zeilen ein Problembericht erstellt werden kann.

Nach dem Import erstellt das Modul einen CSV-Bericht mit folgenden Angaben:

• Zeilennummer,
• Kategorie-ID,
• Status,
• Meldung,
• Liste der geänderten Attribute.

Die Importhistorie ist im Admin-Panel verfügbar. Der Administrator kann Folgendes prüfen:

• Importdatum,
• Admin-Benutzer,
• Store View,
• Importmodus,
• Dateiname,
• Anzahl der Zeilen,
• Anzahl erfolgreicher Vorgänge,
• Anzahl der Fehler,
• Information, ob der Import als dry-run ausgeführt wurde,
• Importbericht herunterladen.

Das Modul verwendet die Magento ACL und fügt separate Berechtigungen für Export, Import und Importhistorie hinzu.

Der Import wird geschützt durch:

• Validierung der Kopfzeilen,
• Validierung der Attributcodes,
• Validierung der Store View,
• Validierung erforderlicher Spalten,
• Validierung der Werttypen,
• Validierung der Optionslabels,
• Validierung der Bilddateien,
• zeilenweise Fehlerberichte.

Das Modul löscht keine Kategorien und importiert keine den Kategorien zugeordneten Produkte.

Sie exportieren die Kategorien aus der Basis-Store-View, ergänzen die Übersetzungen in der CSV-Datei, ändern store_view_code in den Code der Ziel-Store-View und importieren die Daten im Modus update.

Sie exportieren die Attribute meta_title, meta_description, url_key, bearbeiten sie in der CSV-Datei und importieren nur die ausgewählten Spalten.

Sie bereiten eine CSV-Datei mit category_path, parent_path, name und anderen erforderlichen Attributen vor und importieren sie anschließend im Modus insert.

Wenn der Shop über benutzerdefinierte Kategorieattribute verfügt, lädt das Modul diese dynamisch aus EAV und ermöglicht ihre Auswahl beim Export und Import.

Nach der Installation ist das Modul hier verfügbar:

System > Data Transfer > Export/Import Categories

Verfügbare Ansichten:

• Export Categories,
• Import Categories,
• Import History.

System → Data Transfer → Export/Import Categories bietet Export, Import und Historie. Die im Formular ausgewählte Store View bestimmt den Speicherkontext; store_view_code in der Datei dient zur Prüfung der Übereinstimmung.

Prüfen Sie bei der Übertragung von Daten zwischen Instanzen die IDs der übergeordneten Kategorien und die Kategoriepfade. Der reine Export von Attributen überträgt weder Produkte noch deren Kategoriezuordnungen.

Der Modus all_or_nothing validiert alle Zeilen vor Beginn der Speicherung. Ein Fehler bei dieser Validierung hält den Import an.

Der aktuelle Prozess speichert die Kategorien anschließend einzeln und umfasst nicht die gesamte Datei in einer Transaktion. Ein Speicherfehler führt nicht automatisch dazu, dass bereits gespeicherte Kategorien zurückgesetzt werden. Analysieren Sie den Bericht und bewahren Sie vor Änderungen einen Export auf.

Paket kowal/module-export-import-categories, Modul Kowal_ExportImportCategories. Installieren Sie nach der Konfiguration des Zugriffs auf das Kowal-Repository das Paket, aktivieren Sie das Modul, aktualisieren Sie Magento und leeren Sie den Cache. Berücksichtigen Sie in der Produktionsumgebung die Kompilierung und Bereitstellung statischer Inhalte entsprechend dem Prozess des Shops.

1. Ausgewählte Daten exportieren
Sie wählen die Store View, den Kategoriebereich und die Attribute aus.

2. CSV vorbereiten und prüfen
Sie bearbeiten die Werte und starten die Validierung ohne Speicherung.

3. Mit Ergebniskontrolle importieren
Sie wählen die Speicherrichtlinien und analysieren den Zeilenbericht.

Sie exportieren Namen, Beschreibungen und Metadaten. Sie behalten die Kategorie-IDs bei, ändern den Store-View-Code in der CSV-Datei und bereiten die Übersetzungen vor.

Nach dem Dry Run importieren Sie die ausgewählten Spalten im Update-Modus in die Ziel-Store-View. Leere Zellen werden gemäß der ausgewählten Importrichtlinie interpretiert.