Smart Categories – Kategorien automatisch befüllen: Installation und Einrichtung

Installationsanleitung, Dokumentation und FAQs zum Shopware Plugin

Kein neues Feature verpassen

Plugin-News, Updates und Shopware-Tipps aus der Praxis. Einmal im Monat.

Jetzt anmelden

Was Smart Categories macht

Smart Categories befüllt deine Kategorien automatisch. Du legst Regeln an, die eine dynamische Produktgruppe mit einer Zielkategorie verbinden. Beim Ausführen wertet die Erweiterung die Produktgruppe aus und schreibt die passenden Produkte als echte Kategoriezuordnungen, genau wie eine manuelle Zuordnung. Weil es echte Zuordnungen sind, wirken sie überall: Sortierung, Produktexporte und Feeds, SEO URLs, Breadcrumbs und Kategorielistings.

  1. Regeln verbinden eine dynamische Produktgruppe mit einer Zielkategorie
  2. Zwei Modi je Regel: Nur hinzufügen oder Synchronisieren
  3. Vorschau vor jedem Lauf mit Trefferzahlen und Beispielprodukten
  4. Manuelle Zuordnungen bleiben durch ein Zuordnungs-Ledger geschützt
  5. Automatische Aktualisierung bei Produktänderungen und täglicher Abgleich
  6. Prioritäten und wählbare Konfliktstrategie bei mehreren Regeln

Voraussetzungen

  • Shopware 6.7
  • Ein laufender Message Queue Worker. Die gesamte Auswertung und das Schreiben der Zuordnungen laufen asynchron über die Message Queue. Ohne laufenden Worker werden Läufe zwar eingeplant, aber nicht ausgeführt.

Kompatibilität

  • Shopware 6.7
  • Nutzt Shopware-Bordmittel: dynamische Produktgruppen (Produktstreams) und echte Kategoriezuordnungen. Keine Drittanbieter-Dienste und keine externen Aufrufe, Version 1.x arbeitet vollständig lokal.
  • Gedacht für Kategorien mit manueller Produktzuweisung. Kategorien, die selbst eine dynamische Produktgruppe als Produktzuweisung nutzen, ignorieren materialisierte Zuordnungen. Die Erweiterung warnt dich, wenn du eine solche Kategorie als Ziel wählst.

Installation

  1. Erweiterung im Shopware Store erwerben und über Erweiterungen > Meine Erweiterungen installieren.
  2. Erweiterung aktivieren.
  3. Das Adminmenü mit F5 neu laden, damit der Menüpunkt erscheint.
  4. Die Erweiterung findest du danach unter Kataloge > Smart Categories.

Einrichtung

Die Grundeinstellungen sind bereits sinnvoll vorbelegt, du kannst sie aber anpassen. Du findest sie in der Konfiguration der Erweiterung unter Einstellungen > System > Plugins, Erweiterung Smart Categories.

  • Bei Produktänderungen automatisch aktualisieren (Standard: an): Betroffene Regeln werden automatisch neu ausgewertet, sobald sich Produkte ändern.
  • Täglicher vollständiger Abgleich (Standard: an): Einmal täglich werden alle aktiven Regeln vollständig ausgewertet.
  • Konfliktstrategie bei mehreren Treffer-Regeln (Standard: Alle Treffer zuweisen): Legt fest, was passiert, wenn mehrere Regeln dasselbe Produkt treffen.
  • Varianten-Treffer dem Hauptprodukt zuordnen (Standard: aus): Trifft eine Variante, wird stattdessen das Hauptprodukt zugeordnet.
  • Batch-Größe pro Verarbeitungsschritt (Standard: 500): Anzahl der Produkte je Message-Queue-Schritt. Auf schwächeren Systemen kleiner wählen.

1 · Regel anlegen

Öffne Kataloge > Smart Categories und klick auf Regel anlegen. In den Stammdaten vergibst du einen Namen, setzt die Regel auf Aktiv und legst eine Priorität fest. Unter Zuordnungsmodus wählst du Nur hinzufügen oder Synchronisieren.

Unter Bedingungsquelle wählst du die Produktgruppe, die bestimmt, welche Produkte der Regel entsprechen. Über Produktgruppe im Editor öffnen springst du direkt in den Produktgruppen-Editor. Unter Zielkategorie suchst du die Kategorie, in die die Treffer geschrieben werden. Danach speicherst du die Regel.

2 · Zuordnungsmodi

Jede Regel arbeitet in einem von zwei Modi:

  • Nur hinzufügen: Passende Produkte werden der Kategorie hinzugefügt. Die Regel entfernt nie etwas, egal wie sich die Produktgruppe später ändert.
  • Synchronisieren: Die Regel verwaltet ihre eigenen Zuordnungen vollständig und entfernt Produkte wieder, die nicht mehr passen. Entfernt werden ausschließlich Zuordnungen, die diese Regel selbst angelegt hat.

3 · Vorschau vor jedem Lauf

Über Vorschau siehst du das Ergebnis, bevor etwas geschrieben wird. Die Vorschau zeigt dir die Kennzahlen Treffer gesamt, Würden hinzugefügt, Würden entfernt und Manuell bleibt erhalten, dazu eine Liste mit Beispielprodukten.

4 · Regeln ausführen und automatische Trigger

Eine einzelne Regel führst du über Jetzt ausführen aus, alle aktiven Regeln über Alle Regeln ausführen in der Regelliste. Läufe werden über die Message Queue eingeplant und asynchron verarbeitet.

Zusätzlich läuft die Automatik: Bei Produktänderungen und Änderungen an Produktgruppen werden betroffene Regeln automatisch neu ausgewertet, und einmal täglich gibt es einen vollständigen Abgleich. Beides lässt sich in der Konfiguration abschalten.

5 · Prioritäten und Konfliktstrategie

Jede Regel hat eine Priorität. Treffen mehrere Regeln dasselbe Produkt, entscheidet die Konfliktstrategie:

  • Alle Treffer zuweisen (Standard): Das Produkt wird jeder passenden Zielkategorie zugeordnet.
  • Nur höchste Priorität: Das Produkt wird nur von der Regel mit der höchsten Priorität zugeordnet.

6 · Schutz manueller Zuordnungen

Die Erweiterung führt ein Zuordnungs-Ledger und protokolliert darin jede Zuordnung, die sie selbst erstellt. Im Modus Synchronisieren wird ausschließlich anhand dieses Ledgers entfernt. Manuelle Zuordnungen stehen nie im Ledger und werden dadurch technisch nie angetastet. So kannst du die Automatik auch im Live-Shop bedenkenlos einsetzen.

7 · Regeln direkt an der Kategorie

Auf der Kategorie-Detailseite findest du im Produkte-Bereich die Karte Smart-Categories-Regeln. Dort siehst du alle Regeln, die auf diese Kategorie zielen, kannst über Regel anlegen eine neue Regel anlegen und eine bestehende Regel direkt über Jetzt ausführen starten.

8 · Regel löschen

Beim Löschen einer Regel entscheidest du, was mit ihren Zuordnungen passiert:

  • Zuordnungen behalten: Die von der Regel erstellten Kategorie-Zuordnungen bleiben bestehen.
  • Zuordnungen entfernen: Die von der Regel erstellten Kategorie-Zuordnungen werden gelöscht.

Beim Deinstallieren der Erweiterung bleiben materialisierte Zuordnungen erhalten, da es sich um reguläre Shop-Daten handelt. Willst du die Zuordnungen einer Regel loswerden, lösche die Regel vorher mit der Option Zuordnungen entfernen.

FAQs

Es fehlt vermutlich ein laufender Message Queue Worker. Die gesamte Verarbeitung läuft asynchron über die Message Queue, ohne laufenden Worker werden Läufe zwar eingeplant, aber nicht ausgeführt. Für Live-Shops empfehlen wir einen echten Hintergrund-Worker über systemd, supervisor oder Cron.

Nein. Manuelle Zuordnungen stehen nie im Zuordnungs-Ledger und werden dadurch technisch nie angetastet. Im Modus Synchronisieren entfernt eine Regel ausschließlich Zuordnungen, die sie selbst angelegt hat.

Eine dynamische Produktgruppe als Produktzuweisung erzeugt nur eine virtuelle Liste und ignoriert echte Kategoriezuordnungen. Smart Categories schreibt echte Zuordnungen, die für Sortierung, manuelle Produktreihenfolge, Exporte, Feeds, SEO URLs und Breadcrumbs wirken. Deshalb ist die Erweiterung für Kategorien mit manueller Produktzuweisung gedacht.

Die materialisierten Kategoriezuordnungen bleiben erhalten, sie sind reguläre Shop-Daten. Entfernt werden nur die eigenen Tabellen und die Konfiguration der Erweiterung. Sollen die Zuordnungen einer Regel weg, lösche die Regel vorher mit der Option Zuordnungen entfernen.

Ja. Bei Produktänderungen werden betroffene Regeln automatisch neu ausgewertet, zusätzlich läuft täglich ein vollständiger Abgleich. Ein neues Produkt, das zur Produktgruppe einer Regel passt, landet damit automatisch in der Zielkategorie.

Support

Bei Fragen oder Problemen stehen wir zur Verfügung: