dfbulkcategory — Massen-Kategoriezuweisung
Installation, Nutzung der Massenaktionen, Multi-Shop-Verwaltung, PrestaShop-9-Kompatibilität und Fehlerbehebung des Moduls dfbulkcategory.
Ü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
- Laden Sie die ZIP-Datei des Moduls aus Ihrem DataFirefly-Konto herunter.
- Gehen Sie im PrestaShop-Back-Office zu Module → Modul-Manager → Modul hochladen.
- Ziehen Sie die Datei
dfbulkcategory.zipper Drag-and-drop hinein und bestätigen Sie. - 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
- Öffnen Sie Katalog → Produkte.
- Markieren Sie die zu ändernden Produkte (das Kopfzeilen-Kontrollkästchen wählt die ganze Seite aus).
- Öffnen Sie das Menü Massenaktionen und klicken Sie auf Zur Kategorie hinzufügen.
- 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