# dfbulkcategory — Massen-Kategoriezuweisung

> Überblick dfbulkcategory fügt zwei Massenaktionen in die Produktliste des PrestaShop-Back-Office ein: Zur Kategorie hinzufügen und Aus Kategorie entfernen. Wählen Sie Ihre Produkte mit den nativen Kontrollkästchen aus, wählen Sie eine…

- Seite: <https://www.datafirefly.com/de/documentation/dfbulkcategory/>
- Sprache: de
- Aktualisiert am: 2026-07-02
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfbulkcategory/index.md), [en](https://www.datafirefly.com/en/documentation/dfbulkcategory/index.md), [es](https://www.datafirefly.com/es/documentation/dfbulkcategory/index.md), [it](https://www.datafirefly.com/it/documentation/dfbulkcategory/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfbulkcategory/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfbulkcategory/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfbulkcategory/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Überblick

dfbulkcategory fügt zwei Massenaktionen in die Produktliste des PrestaShop-Back-Office ein: **Zur Kategorie hinzufügen** und **Aus Kategorie entfernen**. Wählen Sie Ihre Produkte mit den nativen Kontrollkästchen aus, wählen Sie eine oder mehrere Kategorien in einem Modal mit durchsuchbarem Baum, bestätigen Sie — der Vorgang läuft per AJAX ohne Seitenneustart.

Das Modul unterstützt **PrestaShop 8.0.0 bis 9.99.99** und funktioniert im Multi-Shop-Modus. Es erstellt keine SQL-Tabelle und ändert keine Core-Datei.

## Installation

1. Laden Sie die ZIP-Datei des Moduls aus Ihrem DataFirefly-Konto herunter.
2. Gehen Sie im PrestaShop-Back-Office zu **Module → Modul-Manager → Modul hochladen**.
3. Ziehen Sie die Datei `dfbulkcategory.zip` per Drag-and-drop hinein und bestätigen Sie.
4. Das Modul ist sofort einsatzbereit: Es ist keine Konfiguration erforderlich.

Bei der Installation registriert das Modul ein verstecktes Admin-Tab, das von den Zugriffskontrollen von PrestaShop 9 benötigt wird. Ihrem Back-Office-Menü wird kein sichtbarer Eintrag hinzugefügt.

### Upgrade von Version 1.0.0

Ersetzen Sie das Modul einfach über **Modul hochladen** (oder die Schaltfläche Aktualisieren) durch die neue Version. Ein Upgrade-Skript läuft automatisch und installiert das von PrestaShop 9 benötigte Admin-Tab auf bestehenden Installationen. Es ist keine manuelle Aktion nötig.

## Verwendung

### Produkte zu Kategorien hinzufügen

1. Öffnen Sie **Katalog → Produkte**.
2. Markieren Sie die zu ändernden Produkte (das Kopfzeilen-Kontrollkästchen wählt die ganze Seite aus).
3. Öffnen Sie das Menü **Massenaktionen** und klicken Sie auf **Zur Kategorie hinzufügen**.
4. Markieren Sie im Modal eine oder mehrere Kategorien im Baum und klicken Sie auf **Anwenden**.

Die markierten Kategorien werden zu den bestehenden Kategorien jedes Produkts hinzugefügt — nichts wird überschrieben.

### Produkte aus Kategorien entfernen

Gleiches Prinzip mit dem Tab **Aus Kategorie entfernen** des Modals. Die markierten Kategorien werden von jedem ausgewählten Produkt entfernt.

Die Standard-Kategorie eines Produkts wird niemals entfernt: Gehört sie zu den zu entfernenden Kategorien, behält das Modul sie automatisch bei, damit das Produkt stets eine Hauptkategorie behält.

### Kombi-Modus (Hinzufügen und Entfernen in einem Vorgang)

Der Tab **Beide** zeigt zwei nebeneinanderliegende Bereiche: links die hinzuzufügenden Kategorien, rechts die zu entfernenden. Es ist der ideale Modus, um Produkte mit einer einzigen Bestätigung von einer Kategorie in eine andere zu verschieben.

### Suche und Navigation im Baum

Das Suchfeld filtert den Baum in Echtzeit und klappt Zweige mit Ergebnissen automatisch auf. Die Schaltflächen **Alle ausklappen** und **Alle einklappen** erleichtern die Navigation in großen Bäumen.

### Deaktivierte Kategorien

Standardmäßig werden nur aktive Kategorien angezeigt. Aktivieren Sie den Schalter **Deaktivierte Kategorien anzeigen** oben im Modal, um sie einzuschließen — nützlich während einer Katalog-Umstrukturierung. Deaktivierte Kategorien sind mit einem Badge gekennzeichnet.

## Multi-Shop

Jeder Vorgang läuft im Kontext des im Back-Office aktiven Shops:

- Der angezeigte Kategoriebaum ist der des aktuellen Shops.
- Das Modul überprüft vor jeder Änderung, dass jedes ausgewählte Produkt zu diesem Shop gehört.
- Kategorie-Zuordnungen anderer Shops bleiben unberührt.

Wählen Sie im Kontext „Alle Shops" zuerst einen bestimmten Shop im Multi-Shop-Selektor aus, um die Zuordnungen korrekt zu adressieren.

## PrestaShop-9-Kompatibilität

Seit Version 1.1.0 ist das Modul vollständig PrestaShop-9-kompatibel:

- Die AJAX-URLs werden serverseitig nach dem von PrestaShop 9 erwarteten Mechanismus generiert (inklusive Token).
- Ein verstecktes Admin-Tab wird registriert, um die verschärften Zugriffskontrollen zu erfüllen — auch Mitarbeiter ohne Superadmin-Rechte können das Modul nutzen, sofern sie Katalogzugriff haben.
- Das Verhalten auf PrestaShop 8.0, 8.1 und 8.2 bleibt unverändert.

## Fehlerbehebung

### Die Schaltflächen erscheinen nicht im Menü Massenaktionen

Leeren Sie den PrestaShop-Cache (**Erweiterte Einstellungen → Leistung → Cache leeren**) und laden Sie die Produktseite mit Strg+F5 neu. Prüfen Sie auch, dass das Modul im Modul-Manager installiert und aktiviert ist.

### Fehler „Zugriff verweigert" beim Anwenden

Auf PrestaShop 9 deutet dieser Fehler meist darauf hin, dass das Admin-Tab des Moduls fehlt (Installation vor 1.1.0). Installieren Sie das Modul neu oder führen Sie das Update aus: Das Upgrade-Skript erstellt das Tab automatisch neu.

### Ein Produkt wurde nicht geändert

Die Ergebnismeldung listet übersprungene Produkte auf. Übliche Ursachen: Das Produkt ist nicht dem aktiven Shop zugeordnet (Multi-Shop), oder es wurde zwischen Auswahl und Bestätigung gelöscht.

## Changelog

### 1.1.0 — 2. Juli 2026

- PrestaShop-9-Kompatibilität (unterstützter Bereich: 8.0.0 — 9.99.99)
- AJAX-URLs serverseitig generiert (PS9-konform)
- Verstecktes Admin-Tab bei der Installation registriert für die Zugriffskontrollen von PrestaShop 9
- Automatisches Upgrade-Skript für bestehende 1.0.0-Installationen
- Kategoriebezeichnungen jetzt immer pro Shop gefiltert
- Fehlermeldungen im Modal sicher gerendert

### 1.0.0 — 11. Februar 2026

- Erste öffentliche Version
- Massenaktionen Hinzufügen / Entfernen in der Produktliste
- Modal mit Kategoriebaum, Echtzeit-Suche, Kombi-Modus
- Option deaktivierte Kategorien, Multi-Shop-Verwaltung, Erhalt der Standard-Kategorie
