URL-Filterparameter und Query-Parameter der Suche

URL-Filterparameter und Query-Parameter steuern Filterauswahl, Sortierung und Pagination der Such- und Kategorieseiten teilbar und bookmarkfähig.

Das Such-Modul von WEBSALE | search unterstützt neben der klassischen filter_eq[]-Notation auch erweiterte Vergleichsoperatoren zur dynamischen Filterung über die URL. Diese Funktion eignet sich besonders für das Direktverlinken von gefilterten Listen, z. B. in Teasern, Landingpages oder Marketing-Kampagnen.

​

Allgemeine Syntax der URL-Parameter

Filter können über die URL direkt an das Suchmodul übergeben werden.

Struktur der Filter-Parameter

filter_<Operator>[<technischer Spaltenname aus dem Datenfeed>]=<Wert>

Beispiel für das Setzen eines Farbfilters

filter_eq[farbe]=beige

Parameter in einer vollständigen URL

https://www.ihr-shop.de/c/name-der-kategorie?filter_eq[farbe]=beige

Erweiterung der URL um Preisfilter

Zeigt alle Produkte mit einem Preis zwischen 10 € und 20 €.

https://www.ihr-shop.de/c/name-der-kategorie?filter_eq[farbe]=beige&filter_gte[price]=10&filter_lte[price]=20

​

Unterstützte Filteroperatoren

Parameter	Bedeutung	Beschreibung
filter_eq[field]	equal (=)	Exakte Übereinstimmung
filter_neq[field]	not equal (≠)	Schließt Werte aus
filter_gte[field]	greater than or equal (≥)	Filtert Werte größer oder gleich
filter_lte[field]	less than or equal (≤)	Filtert Werte kleiner oder gleich

Um im Chip visuell darauf hinzuweisen, dass es sich um einen negativen Filter handelt, kann das Attribut neq-label in <ws-filter-chip> verwendet werden.

Mehr dazu in der Dokumentation zu der Komponente ws-filter-chip.

​

Automatische Filter-Initialisierung beim Seitenaufruf

Beim Aufruf einer Seite werden Filter aus den URL-Parametern automatisch gesetzt und die Suche wird automatisch ausgeführt. Damit funktionieren Deep-Links zu gefilterten Suchergebnissen ohne zusätzliches Template-JavaScript.

Beispiel

https://test.shop.websale.net/kategorie/unterkategorie?filter_eq[brand]=nike&filter_eq[color]=red

Beim Aufruf dieser URL passiert automatisch Folgendes:

• Der Filter brand wird auf den Wert nike gesetzt, der Filter color auf red.
• Der URL-Pfad (/kategorie/unterkategorie) wird als Kategorie-Filter verwendet.
• Die Filter-UI wird automatisch vorbelegt: Bei eq-Filtern werden die entsprechenden Optionen angehakt (Checkbox-, Image- und Label-Filter, inklusive statischer Optionen); Range-Filter setzen Slider und Eingabefelder auf die übergebenen Werte.
• Die Suche wird automatisch mit den gesetzten Filtern ausgeführt.

Die automatische Filter-Initialisierung ist ab ws-search-component-1.9.1.js nativ in den WebComponents enthalten. In älteren Versionen musste dieses Verhalten über ein JavaScript im Template umgesetzt werden (siehe Filtern & Sortieren auf Kategorien).