Rotozoom Product Filter — Handbuch

Blitzschnelle AJAX-Produktfilterung für WooCommerce. Mit Product Filter können Ihre Kunden Ihren Katalog nach Kategorie, Preis, Attributen, Lagerbestand und Bewertung eingrenzen — die Ergebnisse werden sofort aktualisiert, ohne die Seite neu zu laden.

• Kostenlose Version: vollständige AJAX-Filterung für jedes Produktattribut (ohne Limit), Preis-Schieberegler, Lager-/Sonderangebots-/Neu-/Bewertungsfilter, Kategoriekontext und funktioniert mit Classic-, Block- und XStore-Themes.
• Pro-Version: Übereinstimmung mit allen ausgewählten Werten eines Attributs (UND-Logik), eigene Auswahlmöglichkeiten für Produkte pro Seite, eine exakte Farbe für jeden Farbwert und ein Ergebniscache für schnelleres erneutes Filtern. Pro benötigt die von rotozoom.com heruntergeladene Edition, die Rotozoom Connect automatisch installiert — dort melden Sie sich mit Ihrem Rotozoom-Konto an.
• Pro-Preis: 47 € / Jahr pro Website, inkl. MwSt.

---

Für Einsteiger: was dieses Plugin macht

Wenn ein Shop mehr als eine Handvoll Produkte hat, brauchen die Kunden eine Möglichkeit, schnell zu finden, was sie suchen. Ein Filter ist das Panel — meist links auf der Shop-Seite — mit Kontrollkästchen und Schiebereglern wie Preis, Farbe oder Marke. Während der Kunde Kästchen anhakt, grenzt sich das Produktraster ein.

Product Filter fügt dieses Panel zu Ihrem Shop hinzu und macht es sofortig: Das Raster aktualisiert sich in dem Moment, in dem ein Kästchen angehakt wird, ohne Neuladen der Seite. Außerdem werden die gewählten Filter in der Webadresse (der URL) gespeichert, sodass ein Kunde eine gefilterte Ansicht als Lesezeichen speichern oder teilen kann.

Einrichtung

1. Bereiten Sie Ihre Daten vor

Filter sind nur so gut wie Ihre Produktdaten, stellen Sie also zuerst sicher, dass Ihre Produkte Folgendes haben:

• Kategorien zugewiesen (unter jedem Produkt oder unter Produkte → Kategorien).
• Attribute wie Farbe, Größe, Wattzahl, Sockel (eingerichtet unter Produkte → Attribute, dann den Produkten zugewiesen).

Tipp: Halten Sie Attribut-Slugs in einfachen ASCII-Buchstaben (zum Beispiel socket, wattage). Nicht-lateinische Slugs können in der URL falsch codiert werden.

2. Platzieren Sie den Filter

Der Filter erscheint automatisch auf Ihren Shop-, Kategorie-, Schlagwort- und Suchseiten. Um ihn woanders zu platzieren — auf einer beliebigen Seite oder einem Beitrag — verwenden Sie den Shortcode [rotozoom_filter] (Optionen: category, per_page, columns, orderby, sidebar="0", bar="0"); [rotozoom_filter_bar] gibt die Sortier-/Produkte-pro-Seite-Leiste separat aus. Der Filter respektiert automatisch die Seite, auf der er sich befindet — auf einer Kategorieseite filtert er innerhalb dieser Kategorie.

3. Wählen Sie, welche Filter angezeigt werden

In den Plugin-Einstellungen (Rotozoom → Product Filter) wählen Sie, welche Steuerelemente erscheinen — Kategorien, Preisbereich, einzelne Attribute, Lagerstatus und Bewertung — und in welcher Reihenfolge sie erscheinen.

Funktionsreferenz

AJAX-Filterung mit URL-Synchronisierung

Jede Änderung an einem Filter löst eine AJAX-Anfrage aus — einen Hintergrundaufruf an den Server, der nur die passenden Produkte zurückgibt und sie in das Raster einsetzt, ohne vollständiges Neuladen der Seite. Die aktiven Filter werden in die URL geschrieben, sodass:

• Die Zurück-Taste des Browsers wie erwartet funktioniert.
• Eine gefilterte Ansicht als Lesezeichen gespeichert oder geteilt werden kann.
• Das direkte Aufrufen einer gefilterten URL die korrekten, vorgefilterten Ergebnisse anzeigt.

Preisbereich-Schieberegler

Ein ziehbarer Schieberegler mit zwei Griffen lässt Kunden einen Mindest- und Höchstpreis festlegen. Der Bereich erstreckt sich über die Preise der gesamten aktuellen Kategorie (einschließlich ihrer Unterkategorien) oder des gesamten Shops auf Shop- und Suchseiten; er wird nicht kleiner, wenn andere Filter ausgewählt werden.

Attributfilter

Jedes WooCommerce-Attribut kann zu einer Filtergruppe (Kontrollkästchen) werden. Kunden können mehrere kombinieren — zum Beispiel Sockel: E27 und Farbtemperatur: Warmweiß — um Ergebnisse präzise einzugrenzen.

• Free: Jedes Attribut kann als Filter dienen — es gibt kein Limit. Produkte stimmen überein, wenn sie mindestens einen der ausgewählten Werte eines Attributs aufweisen (ODER).
• Pro: Pro Attribut können Sie Alle (UND) in Abschnitten wählen, sodass Produkte jeden ausgewählten Wert aufweisen müssen — ideal für technische Kataloge mit vielen Eigenschaften.

Lager-, Bewertungs- und Sonderfilter

Integrierte Filter über Attribute hinaus:

• Auf Lager — nicht vorrätige Artikel ausblenden.
• Bewertung — nur Produkte ab einer Sternebewertung anzeigen (standardmäßig deaktiviert; aktivieren Sie diese unter Abschnitte → Sichtbarkeit von Abschnitten).
• Im Angebot — Aktionen hervorheben.
• Neu — kürzlich hinzugefügte Produkte anzeigen.

Kategorieseiten-Kontext

Wenn der Filter auf einem Kategorie-Archiv sitzt, beschränkt er die Ergebnisse automatisch auf diese Kategorie, sodass Kunden innerhalb des durchsuchten Bereichs verfeinern statt über den ganzen Shop hinweg.

Pro-Extras

• UND-Verknüpfung — erfordert alle ausgewählten Werte eines Attributs.
• Produkte pro Seite — bieten Sie Kunden Ihre eigenen Optionen pro Seite an.
• Exakte Farbmuster — legen Sie die genaue Farbe fest, die für jeden Farbwert angezeigt wird.
• Ergebniscache — wiederholte Filterergebnisse für abgemeldete Besucher werden aus einem Cache auf Ihrer eigenen Website bereitgestellt, der aktualisiert wird, wenn sich Produkte oder Lagerbestände ändern.

Free vs. Pro auf einen Blick

Funktion	Free	Pro
AJAX-Filterung mit URL-Synchronisierung	✓	✓
Preisbereich-Schieberegler	✓	✓
Lager-, Sonderangebots-, Neu- & Bewertungsfilter	✓	✓
Kategorieseiten-Kontext	✓	✓
Alle Produktattributfilter (ohne Limit)	✓	✓
Classic-, Block- & XStore-Themes	✓	✓
UND-Verknüpfung pro Attribut	—	✓
Benutzerdefinierte Optionen für Produkte pro Seite	—	✓
Exakte Farbe pro Farbmusterwert	—	✓
Ergebniscache	—	✓

Erweiterte Hinweise

• XStore-Kompatibilität (Free und Pro): XStore rendert Shop-Seiten mit eigenem Markup; das Plugin enthält eine spezifische Integration, damit der Filter korrekt in das Produktraster und AJAX von XStore eingreift. Bei Standard-/generischen Themes funktioniert der Filter ohne diese.
• URL-gesteuerte Abfragen: Filter ändern die Haupt-Produktabfrage, sodass die Ergebnisse echte WooCommerce-Abfragen sind (korrekte Paginierung, Sortierung und Anzahl) statt eines clientseitigen Ein-/Ausblenden-Tricks.
• Performance: Die Filterung nutzt den Kategoriekontext, um Abfragen auch bei großen Katalogen eingegrenzt und schnell zu halten.

Fehlerbehebung

• Ein Attribut wird nicht als Filter angeboten — bestätigen Sie, dass es ein globales Attribut ist (unter Produkte → Attribute) und Produkten zugewiesen ist.
• Gefilterte URLs sehen kaputt oder doppelt codiert aus — prüfen Sie, ob die Attribut-Slugs einfaches ASCII sind.
• Filter sieht in XStore ungestylt aus — stellen Sie sicher, dass sich der Filter auf einer WooCommerce-Shop- oder -Kategorieseite befindet, und leeren Sie eventuelle Seiten-Caches.

Um Pro zu aktivieren (von rotozoom.com herunterladen und über Rotozoom Connect anmelden), siehe Plugins installieren und aktualisieren.