Zum Inhalt

MassAssignCategory — Massenweise Kategoriezuordnung

Extension for Magento 2

Bedienungsanleitung


CopeX GmbH
Web: https://copex.io
Email: office@copex.io


Inhaltsverzeichnis

Abschnitt Seite
1 Voraussetzungen 2
2 Installation 2
3 Konfiguration 2
4 Verwendung 3
5 Fehlerbehandlung 5

1 Voraussetzungen

  • Magento 2.4 oder höher
  • PHP 8.1 oder höher
  • Admin-Zugriffsrechte auf den Produktkatalog

2 Installation

Via Composer

composer require copex/module-massassigncategory
php bin/magento module:enable CopeX_MassAssignCategory
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

3 Konfiguration

Die Konfiguration des Moduls finden Sie im Magento 2 Backend unter Shops > Konfiguration > Katalog > Katalog > Massenweise Kategorien zuweisen.

Konfiguration

3.1 Tiefenstufe des Kategoriebaums

  • Tiefenstufe — Legt die maximale Tiefe des angezeigten Kategoriebaums fest. Mit einem höheren Wert werden tiefere Kategorieebenen im Baum sichtbar. Standardwert: 3.

Beispiel: Bei einem Wert von 3 werden Kategorien bis zur dritten Ebene angezeigt: - Ebene 1: Bekleidung - Ebene 2: Herren, Damen, Kinder - Ebene 3: Hemden, Hosen, Jacken, ...


4 Verwendung

4.1 Produkte für die Massenzuordnung auswählen

  1. Navigieren Sie zu Katalog > Produkte.
  2. Setzen Sie ggf. Filter, um die gewünschten Produkte einzugrenzen.
  3. Wählen Sie die Produkte aus, deren Kategorien geändert werden sollen, indem Sie die Checkboxen in der ersten Spalte aktivieren.

  4. Klicken Sie im Dropdown Aktionen auf Attribute aktualisieren.

4.2 Kategorien hinzufügen

Auf der Seite "Attribute aktualisieren" finden Sie den Tab Kategorien.

Im Bereich Kategorien hinzufügen wird der Kategoriebaum als verschachtelte Checkbox-Liste angezeigt.

  1. Aktivieren Sie die Checkboxen der Kategorien, die den ausgewählten Produkten hinzugefügt werden sollen.
  2. Es können mehrere Kategorien gleichzeitig ausgewählt werden.
  3. Klicken Sie auf Speichern (oder scrollen Sie nach unten und klicken Sie auf die Schaltfläche am Ende der Seite).

Hinweis: Das Hinzufügen von Kategorien ist additiv. Bereits zugewiesene Kategorien der Produkte bleiben unverändert erhalten.

4.3 Kategorien entfernen

Im Bereich Kategorien entfernen wird ebenfalls der Kategoriebaum angezeigt.

  1. Aktivieren Sie die Checkboxen der Kategorien, die von den ausgewählten Produkten entfernt werden sollen.
  2. Klicken Sie auf Speichern.

Hinweis: Nur die ausgewählten Kategorien werden entfernt. Andere Kategoriezuordnungen der Produkte bleiben unverändert.

4.4 Gleichzeitiges Hinzufügen und Entfernen

Kategorien können in einem einzigen Speichervorgang gleichzeitig hinzugefügt und entfernt werden. Wählen Sie dazu im Bereich "Kategorien hinzufügen" die gewünschten Kategorien aus und im Bereich "Kategorien entfernen" die zu entfernenden Kategorien, und klicken Sie dann auf Speichern.

4.5 Rückmeldung nach dem Speichern

Nach erfolgreichem Speichern erscheint eine Erfolgsmeldung mit der Anzahl der aktualisierten Produkte. Bei Fehlern (z. B. ungültige Kategorie-IDs) wird eine entsprechende Fehlermeldung angezeigt.


5 Fehlerbehandlung

  • Kategorien-Tab erscheint nicht in der Attribut-Update-Seite — Stellen Sie sicher, dass das Modul aktiviert ist und der Cache geleert wurde. Überprüfen Sie auch, ob statische Dateien neu deployed wurden (php bin/magento setup:static-content:deploy).

  • Kategoriebaum ist leer — Das Modul lädt die Kategorien basierend auf den im Store konfigurierten Root-Kategorien. Stellen Sie sicher, dass mindestens eine Root-Kategorie und Unterkategorien im System vorhanden sind.

  • Zu viele Kategorieebenen machen das Formular unübersichtlich — Reduzieren Sie die Tiefenstufe in der Konfiguration (Shops > Konfiguration > Katalog > Katalog > Massenweise Kategorien zuweisen > Tiefenstufe).

  • Änderungen greifen nicht — Nach dem Speichern muss der Magento-Index neu aufgebaut werden. Führen Sie php bin/magento indexer:reindex aus oder navigieren Sie zu System > Index-Verwaltung und führen Sie die Reindexierung durch.

  • "Kategorie nicht gefunden" Fehlermeldung — Dies kann bei deaktivierten Flat-Kategorien auftreten. Stellen Sie sicher, dass die Magento-Konfiguration für flache Kategorien korrekt konfiguriert ist.


Lizenz

GPL-3.0 Open Source — CopeX GmbH.