1. AAWP
  2. Dokumentation
  3. Funktionen
  4. Produkte filtern

Je nach Anwendungsfall ist es manchmal notwendig, eine Auflistung von Produkten nach Kriterien wie dem Titel oder Preis zu filtern. Dies erfordert die Übergabe der Shortcode-Attribute “filter” und “filterby”.

Beispiele und Optionen

Produkte nach Titel (Namen) filtern

In diesem Beispiel filtern wir eine Auflistung von Produkten nach dem Titel:

Nur Produkte mit ein bestimmtes Wort im Titel ausgeben

[amazon bestseller="smartphone" filterby="title" filter="iphone"]

Nur Produkte ohne ein bestimmtes Wort im Titel ausgeben

[amazon bestseller="smartphone" filterby="title" filter="iphone" filter_type="exclude"]

Standardmäßig ist das Attribut filter_type bereits auf include gesetzt.

Produkte nach Preis filtern

In diesem Beispiel filtern wir eine Auflistung von Produkten nach dem Preis:

Nur Produkte mit einem Preis unter 100 EUR ausgeben

[amazon bestseller="smartphone" filterby="price" filter="100" filter_compare="less"]

Nur Produkte mit einem Preis über 100 EUR ausgeben

[amazon bestseller="smartphone" filterby="price" filter="100" filter_compare="more"]

Nur Produkte mit einem Preis zwischen 100 und 200 EUR ausgeben

[amazon bestseller="smartphone" filterby="price" filter="100,200" filter_compare="range"]

Nur Produkte mit einem Preis von exakt 100 EUR ausgeben

[amazon bestseller="smartphone" filterby="price" filter="100" filter_compare="equal"]

Nur Produkte ausgeben, die aktuell reduziert sind

[amazon bestseller="smartphone" filterby="price" filter="offer"]

Nur Produkte ausgeben, die aktuell verfügbar sind

[amazon bestseller="smartphone" filterby="price" filter="available"]

Standardmäßig geht das Plugin davon aus, dass du nur diejenigen Produkte ausgeben willst, die die übergebenen Kriterien erfüllen. Für den umgekehrten Fall, dass du diese Produkte ausschließend willst, füge das Shortcode-Attribut filter_type hinzu und übergebe den Wert exclude.

Wann kann ich Produkte filtern?

Aktuell können mehrere Produktboxen, Bestseller (Listen) und Neuerscheinungen (Listen) gefiltert werden.


Übersicht aller Filter-Optionen

“filterby”

Wert Beschreibung
title Titel der Produkte
price Verkaufspreis der Produkte

“filter”

Wert Beschreibung
Beliebiger Text Kann in Kombination mit filterby="title" verwendet werden.
Beliebige Zahl Kann in Kombination mit filterby="price" verwendet werden. Bitte nur Ganzzahlen, ohne Nachkommastellen übergeben,
offer Kann in Kombination mit filterby="price" verwendet werden. Damit werden nur Produkte ausgegeben (oder eben nicht), die aktuell reduziert sind.
available Kann in Kombination mit filterby="price" verwendet werden. Damit werden nur Produkte ausgegeben (oder eben nicht), die aktuell verfügbar sind.

“filter_type”

Wert Beschreibung
include Es werden nur Produkte ausgegeben, die die entsprechenden Voraussetzungen erfüllen (Standard).
exclude Es werden nur Produkte ausgegeben, die die entsprechenden Voraussetzungen nicht erfüllen (Standard).

“filter_compare”

Wert Beschreibung
less Kann in Kombination mit filterby="price" verwendet werden, um eine Preisobergrenze festzulegen.
more Kann in Kombination mit filterby="price" verwendet werden, um eine Preisuntergrenze festzulegen.
range Kann in Kombination mit filterby="price" verwendet werden, um eine Preisspanne festzulegen.
equal Kann in Kombination mit filterby="price" verwendet werden, um einen exakten Preis vorzugeben.

Weiterführende Informationen

Erweiterung des “Suchradius” zum Filtern

Bei Bedarf kann eine größere Anzahl an Produkten zum Filtern herangezogen werden, wobei am Ende nur eine niedrige Anzahl ausgegeben wird. Daraus ergibt sich der Vorteil, dass du gegebenenfalls bessere Ergebnisse zurück bekommst.

Um den Suchradius zu erweitern, müssen die Shortcode-Attribute items und filter_items wie folgt angewandt werden:

[amazon bestseller="smartphone" filterby="title" filter="iphone" filter_items="20" items="10"]

In diesem Beispiel wird das Plugin 20 Produkte (anstatt 10) von der API abrufen und diese nach dem aktuellen Titel filtern. Bei der Ausgabe hingegen, werden nur 10 Produkte (statt 20) aufgelistet. Durch die Erweiterung des Suchradius beinhaltet deine Auflistung eventuell Produkte, die ohne filter_items nicht inbegriffen wären.

Bei Übergabe einer Browse Node ID (nur möglich bei Bestseller-Listen und Neuerscheinungen) gibt die API aktuell maximal 10 Produkte zurück. Dies trifft nicht nur auf items, sondern auch auf filter_items zu. Wenn du mehr als 10 Produkte darstellen bzw. filtern möchtest, musst du statt der Browse Node ID einen Suchbegriff übergeben.
Durch das Erhöhen des Suchradius muss das Plugin mehr Daten (als gewöhnlich) abrufen, speichern und aktualisieren. Daher empfehlen wir dir, den Suchradius nur dann zu erhöhen, wenn du wirklich unzufrieden mit dem bisherigen Ergebnis bist.

War dieser Artikel hilfreich?

Ähnliche Artikel