Hier können die das Produktfilter-Plugin bestellen.

Screenshots

Produktfilter Sidebar

Produktfilter Drawer

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

OptionBeschreibungStandardwert
Für Mandant aktivierenAktiviert das Plugin für den Shoptrue
Anzeige-ModusSidebar, Box über dem Listing, Drawer (seitlich einfahrend) oder PopupSidebar
DesignAutomatisch (passend zum Template), xt_responsive, ew_evelations, Minimal oder Eigener StyleAutomatisch
Produkte per AJAX nachladenDie Produkte werden ohne Neuladen der Seite aktualisierttrue
Filter anwendenAutomatisch (Sidebar/Box sofort, Drawer/Popup per Button), sofort bei jeder Änderung oder per Button „Artikel anzeigen“Automatisch
Trefferzahlen je Option anzeigenZeigt hinter jeder Option, wie viele Artikel zu finden sindtrue
Optionen ohne Treffer ausblendenBlendet Optionen ohne Treffer aus, statt sie abgeblendet anzuzeigenfalse
Auf Kategorieseiten anzeigenZeigt den Filter auf Kategorieseitentrue
Auf Suchergebnisseiten anzeigenZeigt den Filter auf der Suchergebnisseitetrue
Filter erst ab dieser Anzahl Artikel anzeigenKategorie- und Suchseiten mit weniger Artikeln zeigen keinen Filter (0 = immer anzeigen)0
Sidebar/Box auf kleinen Bildschirmen als DrawerAuf dem Smartphone erscheint ein „Filter“-Button, der Filter öffnet sich seitlichtrue
Gefilterte Seiten mit noindex auszeichnenGefilterte Seiten werden nicht von Suchmaschinen indexiert (empfohlen)true
Nach dem Filtern zum Listing scrollenSpringt nach dem Filtern zum Beginn der Produktetrue
Debug-LogSchreibt Laufzeiten der Abfragen nach xtLogs/tfm_products_filter.log (nur zur Fehlersuche aktivieren)false

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

Produktfilter Übersicht
Unter „Shop“ → „4TFM Produktfilter“ legen Sie die Filter an. Je Filter stehen folgende Felder zur Verfügung:
FeldBeschreibung
NameÜberschrift des Filters im Shop (je Sprache)
AktivFilter im Shop anzeigen
DatenquellePreis, Hersteller, Verfügbarkeit, Sonderangebote, Neuheiten, Bewertungen (xt_reviews), Variantenoption (Master/Slave), Produktfeld aus xt_products oder ein 4TFM Produktmerkmal (Plugin tfm_attributes)
DarstellungCheckboxen, Radiobuttons, Buttons/Chips, Swatches (Farbe/Bild), Dropdown, Dropdown mit Mehrfachauswahl, Range-Slider, Eingabefelder von/bis oder Schalter. Slider und von/bis gibt es für Preis, Zahlenfelder und Produktmerkmale, deren Werte Zahlen sind (z.B. „800 W“, „1.200 W“)
URL-SchlüsselName des Filters in der URL (leer = automatisch)
Kategorie-IDsIn welchen Kategorien der Filter erscheint („all“ = alle, inkl. Unterkategorien)
Shop-IDsIn welchen Shops der Filter erscheint („all“ = alle Shops)
Eingeklappt startenFilter ist beim Aufruf zugeklappt
Trefferzahlen anzeigenTrefferzahlen für diesen Filter ein-/ausschalten
Sichtbare Optionen vor „Mehr anzeigen“Anzahl der Optionen, bevor „Mehr anzeigen“ erscheint (0 = Standard)
Einheitz.B. „kg“ beim Gewicht (leer = Währung beim Preis)
ParameterNeuheiten: Anzahl Tage, Slider: Schrittweite
Sortierung der OptionenReihenfolge der Quelle, alphabetisch oder nach Trefferzahl
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.
Produktfilter Werte-Übersicht

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
}
WertBeschreibungStandardwert
mobile_breakpointBreite in px, bis zu der „kleine Bildschirme“ gelten767
drawer_positionSeite, aus der der Drawer kommt: „left“ oder „right“left
options_limitSichtbare Optionen, bevor „Mehr anzeigen“ erscheint (0 = alle)8
hide_manufacturer_dropdowntrue = Standard-Herstellerauswahl („Alle Hersteller“) im Listing ausblendenfalse
listing_selectorCSS-Selektor des Produktlistings, das per AJAX ausgetauscht wird.product-listing .products
scroll_offsetAbstand nach oben beim Scrollen in px, z.B. Höhe eines Sticky-Headers (null = automatisch)null
scroll_offset_mobileWie scroll_offset, für kleine Bildschirmenull
cache_ttlZwischenspeicher der Trefferzahlen in Sekunden (0 = aus)300
custom_styleAkzentfarbe (accent), Überschrift (head_bg, head_color) und Eckenradius (radius) für das Design „Eigener Style“-
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.