Hier können die das Produktfilter-Plugin bestellen.
Screenshots
Installation & Konfiguration
Führen Sie die generelle Installationsanleitung für 4tfm-Plugins aus.
Nachdem das Plugin installiert und aktiviert ist, laden Sie den Administrationsbereich mit der F5-Taste neu.
Bei der Installation werden Beispielfilter angelegt (Preis, Hersteller, Varianten-Optionen wie Farbe und Größe, Verfügbarkeit, Sonderangebote). Die Filter finden Sie im Backend unter „Shop“ → „4TFM Produktfilter“.
Damit der Filter im Shop erscheint, muss er einmalig im Template eingebunden werden (siehe „Einbindung im Template“). Leeren Sie danach einmal den kompletten Cache.
Plugin-Optionen
Funktionsweise
Die Filter werden im Backend festgelegt und im Shop auf Kategorie- und Suchseiten angezeigt. Kunden können mehrere Filter kombinieren: Mehrere Optionen innerhalb eines Filters werden mit ODER verknüpft (z.B. rot oder blau), verschiedene Filter mit UND (z.B. rot und Größe M). Die Trefferzahlen berücksichtigen dabei immer die übrigen gewählten Filter.
Sidebar und Box über dem Listing: Jede Änderung wird sofort angewendet, die Produkte werden ohne Neuladen der Seite aktualisiert.
Drawer und Popup (sowie Sidebar/Box auf dem Smartphone): Der Filter öffnet sich über den Button „Filter“. Die Trefferzahl wird beim Auswählen laufend aktualisiert, angewendet wird mit dem Button „n Artikel anzeigen“.
Gewählte Filter erscheinen oben unter „Aktive Filter“ und lassen sich dort einzeln (×) oder über „Alle Filter zurücksetzen“ entfernen. Filter ohne passende Optionen werden automatisch ausgeblendet. Die Auswahl steht in der URL, dadurch funktionieren Zurück-Button, Lesezeichen, Seitennavigation und Sortierung mit aktiven Filtern.
Filter anlegen
Unter „Shop“ → „4TFM Produktfilter“ legen Sie die Filter an. Je Filter stehen folgende Felder zur Verfügung:
Weitere Funktionen in der Übersicht:
- Werte: Farbe, Bild und Bezeichnung je Sprache für jede Option, mit Vorschau (Screenshot 8). So werden z.B. Farben als Swatches angezeigt.
- Kopieren und Reihenfolge per Pfeilen ändern.
- Die Spalte Hinweis meldet z.B. eine nicht verfügbare Datenquelle oder einen doppelten URL-Schlüssel.
- Über den Menüpunkt „4TFM Produktfilter Export/Import“ lassen sich alle Filter als JSON exportieren und in einen anderen Shop importieren.
Bewertungen (xt_reviews)
Mit der Datenquelle „Bewertungen“ filtern Kunden nach der Durchschnittsbewertung: „ab 4 Sternen“, „ab 3 Sternen“, „ab 2 Sternen“ und „ab 1 Stern“, jeweils mit Sternen und Trefferzahl. Berücksichtigt werden nur Artikel mit freigeschalteten Bewertungen. Als Darstellung eignen sich Radiobuttons (Standard), Checkboxen, Buttons oder ein Dropdown.
Die Datenquelle steht nur zur Verfügung, wenn das Plugin xt_reviews aktiv ist. Bei einer Neuinstallation wird ein Filter „Bewertung“ angelegt; in bestehenden Shops legen Sie ihn unter „Shop“ → „4TFM Produktfilter“ mit der Datenquelle „Bewertungen“ an.
Tipp für Artikel mit Varianten: Stellen Sie in den Einstellungen von xt_reviews die Option „Anzeige bei Variantenartikel und Artikelvarianten“ auf „master_all“. Dann zeigt auch das Listing die Sterne aus den Bewertungen der Varianten, passend zum Filter. Mit „default“ erscheinen dort nur die Bewertungen des Hauptartikels.
Varianten (Master/Slave)
Im Listing erscheinen wie gewohnt nur Hauptartikel und einfache Artikel. Filter auf Variantenoptionen prüfen die Varianten des Hauptartikels: Werden mehrere Optionen gewählt (z.B. Farbe rot und Größe M), wird ein Artikel nur gefunden, wenn es genau diese Variante gibt. Beim Preisfilter zählen die Preise der Varianten.
Einbindung im Template
Sidebar (Anzeige-Modus „Sidebar“): In der Datei templates/<Ihr Template>/index.html an oberster Stelle der Sidebar einfügen:
{hook key=tfm_products_filter_sidebar}Box, Drawer und Popup: In der Datei templates/<Ihr Template>/includes/product_listing_base.html oberhalb von {if $product_listing} einfügen:
{hook key=tfm_products_filter_listing}Beide Hooks dürfen gleichzeitig im Template stehen, ausgegeben wird nur der zum Anzeige-Modus passende. Der Hook im Listing muss außerhalb von {if $product_listing} stehen, damit der Filter auch bei 0 Treffern sichtbar bleibt.
Wir empfehlen, die Änderungen in einem eigenen Template (Kopie des Standard-Templates) vorzunehmen. Leeren Sie danach den Template-Cache.
Technische Einstellungen (config.json)
Theme-abhängige Einstellungen stehen nicht im Backend, sondern in einer JSON-Datei. Die Standardwerte liegen in plugins/tfm_products_filter/config/config.json und sollten dort nicht geändert werden, da die Datei bei Plugin-Updates ersetzt wird.
Für eigene Werte legen Sie die Datei templates/<Ihr Template>/plugins/tfm_products_filter/config.json an (nicht in einem Unterordner config/). Dort genügen die abweichenden Werte, z.B.:
{
"scroll_offset": 100,
"hide_manufacturer_dropdown": true
}Ungültige Werte werden ignoriert, dann gilt der Standardwert. Schlüssel, die mit _ beginnen (z.B. „_info_scroll_offset“), sind nur Erläuterungen.
Eigenes Design
Wählen Sie in den Plugin-Optionen das Design „Eigener Style“. Die Farben passen Sie über custom_style in der config.json an. Für weitergehende Anpassungen kopieren Sie die Vorlage plugins/tfm_products_filter/css/custom.example.css nach templates/<Ihr Template>/plugins/tfm_products_filter/css/custom.css. Diese Datei wird bei Plugin-Updates nicht überschrieben.
Das Filter-Template selbst kann ebenfalls im Theme überschrieben werden: templates/<Ihr Template>/plugins/tfm_products_filter/tfm_products_filter.html
Hinweise
- Der Filter gilt für Kategorie-, Such- und Herstellerseiten, sowie XT-Pluginseiten wie Neuheiten (xt_new_products) oder Bestseller (xt_bestseller_products)
- Der Preisfilter berücksichtigt Sonderpreise, Steuern der Kundengruppe und die aktuelle Währung, aber keine Staffelpreise oder Kundenrabatte.
- Die Trefferzahlen werden für kurze Zeit zwischengespeichert. Änderungen an Artikeln, Kategorien, Herstellern und Filtern leeren den Zwischenspeicher automatisch.
- Gefilterte Seiten verweisen per canonical auf die Kategorie.
- Bei Artikeln mit Varianten zählen die Bewertungen des Hauptartikels und aller Varianten zusammen. Neu freigeschaltete Bewertungen erscheinen in den Trefferzahlen nach spätestens 5 Minuten (cache_ttl).
- Zusammen mit dem Plugin „4TFM Produktmerkmale“ (tfm_attributes) lassen sich eigene Merkmale wie „Material“ oder „Passform“ als Filter verwenden.




