Filters

Filteroberfläche #

Filter können für jeden Content verwendet werden, um die Ergebnisse basierend auf deinen Produktattributen einzugrenzen.

Du findest diese Option in jedem Content, den du für Recommendations, Search oder Email erstellst, unter Content type > Product filters.

Jeder Teil des Filters besteht aus Folgendem:

• Einem Attribut, nach dem gefiltert wird
• Einem Vergleich, der bestimmt, wie das Attribut mit dem Wert verglichen wird
• Einem Wert, mit dem das Attribut verglichen werden soll

Du kannst Filter basierend auf beliebigen Produktattributen erstellen, die du an Clerk sendest. Die verfügbaren Vergleichsoperatoren hängen vom Typ des gefilterten Attributs ab.

Beispiel: price enthält eine Zahl, was bedeutet, dass du sowohl größer als, kleiner als und andere numerische Vergleiche verwenden kannst, während Text/String-Attribute wie name nur boolesche Vergleiche wie ist oder ist nicht zulassen.

Beim Erstellen von Filtern zeigt dir die Oberfläche wie viele Produkte dem Filter entsprechen und die generierte filter string.

Einfache Filter #

Diese enthalten nur ein einzelnes Attribut und einen Vergleich. Ein Beispiel ist, nur Produkte unter 400 € anzuzeigen:

Filtersets #

Diese ermöglichen es dir, die Produktauswahl durch das Hinzufügen mehrerer Filter innerhalb desselben Sets weiter einzugrenzen. Du kannst dies tun, indem du auf das "+"-Symbol in einem bestehenden Filter klickst und einen neuen hinzufügst.

Innerhalb eines Sets kannst du zwischen zwei Filterlogiken wählen:

• AND zeigt nur Produkte, die alle Filter im Set erfüllen.
• OR zeigt Produkte, die mindestens einen der Filter im Set erfüllen.

Beispiel: Du möchtest nur Produkte anzeigen, die unter 400 € liegen und auch im Angebot sind.

Kombinieren von Sets #

Du kannst Filtersets kombinieren, sodass sie zusammen unter verschiedenen Bedingungen arbeiten. Anstatt Filter innerhalb eines bestehenden Sets hinzuzufügen, klickst du auf "+ Add filter" um ein neues Set zu beginnen.

Jedes Filterset arbeitet unabhängig und du kannst festlegen, wie sie zusammenwirken:

• AND zeigt nur Produkte, die alle Sets erfüllen.
• OR zeigt Produkte, die mindestens eines der Sets erfüllen.

Beispiel: Du möchtest Produkte anzeigen, die unter 400 € UND im Angebot sind, aber auch entweder von Anbieter A ODER einer bestimmten Kategorie stammen.

• Das erste Set stellt sicher, dass die Produkte Preis- und Angebotsbedingungen erfüllen.
• Das zweite Set sorgt für Flexibilität, indem Produkte aus entweder einem bestimmten Anbieter oder einer bestimmten Kategorie eingeschlossen werden.

Filter string #

Die Filteroberfläche erstellt die korrekte Syntax automatisch basierend auf den in deinen Attributen verfügbaren Daten. Wenn zum Beispiel deine SKUs als Strings wie “GT-1234” formatiert sind, werden Anführungszeichen automatisch zum Filter string hinzugefügt.

sku = "GT-1234"

Wenn ein Attribut eine Zahl ist, wird es ohne Anführungszeichen hinzugefügt.

price < 300

Wenn du Probleme beim Filtern hast, überprüfe den Filter-string, um sicherzustellen, dass die richtige Syntax verwendet wird, und passe ihn gegebenenfalls an.

Wenn du unsicher bist, kannst du sehen, welchen Datentyp ein bestimmtes Attribut hat (string, number, list, boolean), indem du zu Data > Products gehst und ein beliebiges Produkt ansiehst.

Du kannst den Filter string jederzeit manuell anpassen, indem du auf das Stift-Symbol neben Filter expression. klickst.

Dynamisches Filtern #

Filters können direkt zu Einbettungscodes mithilfe des data-filter Attributs hinzugefügt werden. Dies ermöglicht es, Filter dynamisch zu gestalten, indem du die Werte anhand von Frontend-Logik änderst.

Im Folgenden findest du einige gängige Beispiele, wie du dynamisches Filtern einsetzen kannst.

Versandkostenfreie Grenze #

Definiere eine Variable, z. B. $free_shipping_limit, die den verbleibenden Betrag enthält, den der Kunde noch erreichen muss, um die Versandkostenfreie Grenze zu erreichen. Verwende dies als dynamischen Filter, um nur Produkte über diesem Preispunkt anzuzeigen:

<span class="clerk"
      data-template="@complementary-to-basket"
      data-filter="price > $free_shipping_limit">
</span>

Passendes Geschlecht #

Wenn deine Produkte ein Attribut wie gender enthalten, mit Werten wie female, male, kids, unisex usw., kannst du Clerk-Elemente zwingen, Produkte für das gleiche Geschlecht anzuzeigen.

Definiere eine Variable, z. B. $product_gender, die das Geschlecht des aktuell angesehenen Produkts enthält, und verwende diese, um Produkte für das gleiche Geschlecht anzuzeigen:

<span class="clerk"
      data-template="@Bestsellers"
      data-filter="gender = $product_gender">
</span>

Spezifische Kategorie #

In diesem Fall benötigst du eine Liste in deinem Shop, die die Produktkategorien enthält, z. B. definiert als $available_categories = [1,2,3,4,5]. Verwende dies, um Slider nur Produkte aus diesen Kategorien anzeigen zu lassen:

<span class="clerk"
      data-template="@type-slider"
      data-filter="categories in $available_categories">
</span>