Mittels der Tags WS-ManualSearch und Cat-AdvData können Sie eine individuell konfigurierbare Suche auslösen, deren Ergebnisse an beliebiger Stelle auf einem Template (z. B. der Startseite des Shops) angezeigt werden können:

Die Anzeige der Ergebnisse wird dynamisch aktualisiert, wenn sich der Warenbestand ändert (und die technischen Produktfelder entsprechend aktualisiert wurden).

WS-ManualSearch löst die Suche aus, Cat-AdvData zeigt ihre Ergebnisse an.
Suchbegriffe werden als Werte des Parameters search_input in die Klammern von WS-ManualSearch eingetragen. Der Parameter limit= ist dabei Pflicht, alle anderen Parameter sind optional. Alle Parameter werden kommasepariert hintereinander in die Klammer eingetragen. Sinnvoll ist, bei einem beabsichtigten Suchergebnis von z. B. 5 Treffern als limit für WS-ManualSearch "5" einzutragen und diesen Wert als zweiten Parameter für Cat-AdvData zu übernehmen (vgl. Codebeispiel unten).

Beide Tags (Cat-AdvData und WS-ManualSearch) unterstützen Tag-in-Tag.

Die beiden Tags werden zum Auslösen einer konfigurierbaren, manuellen Suche immer in der Reihenfolge WS-ManualSearch(), Cat-AdvData($ManualSearch,999) gesetzt. Pro Template kann man nur einmal eine Suchergebnistreffer-Anzeige über Cat-AdvData($ManualSearch,999) aktivieren; die Tags dürfen in dieser Kombination nicht mehrmals gesetzt werden.

Referenz: CAT-AdvData()

Referenz: WS-ManualSearch()

Beispiel: Integration auf der Produktübersichtsseite (ws_category.htm)

Angezeigt (gesucht) werden sollen 5 "rote Hose(n)" ab 17.00 Euro in der aktuell gewählten Kategorie.

Diese Suchergebnisliste mithilfe von WS-ManualSerach() ist immer dynamisch, d. h. kommen neue "rote Hose(n)" im Shop hinzu, so wird die Anzeige automatisch aktualisiert und die neuen Produkte werden als Ergebnis mit angezeigt.

~WS-ManualSearch(search_input=rote Hose,top_cat_index=$CAT-Index$,price_from=17.00,limit=5)~
{Cat-AdvData($ManualSearch,5)}
    Unsere TopSeller (~WS-ManualSearchResults~ Produkte)
    {@PR-DATA}
        ~PR-Name~
    {/@PR-DATA}
{/Cat-AdvData($ManualSearch,5)}

Über das Tag WS-ManualSearch() können für die Suche mehrere Parameter-Wert-Paare angegeben werden. Diese werden "und"-verknüpft, das heißt nur die Produkte, bei denen alle Eigenschaften zutreffen, werden als Ergebnis angezeigt.

Zusätzlich zu den Standard-Produktdatenfeldern, z. B. Name, Preis etc., kann auch nach freien Produktdatenfeldern gesucht werden, z. B. Material, Länge etc.
Für diese freien Produktdatenfelder kann definiert werden, ob diese "und"- oder "oder"-verknüpft werden sollen.

Referenz: Abschnitt ProductItemSearch

Referenz: PR-"technischer Name"

Beispiel "Und"-Verknüpfung

Angezeigt (gesucht) werden sollen "Sommerhose(n)", die aus Baumwolle sind UND eine kurze Länge haben:

~WS-ManualSearch(search_input=Sommerhose,material=baumwolle,laenge=kurz)~

Beispiel "Oder"-Verknüpfung

Angezeigt (gesucht) werden sollen "Sommerhose(n)", die aus Baumwolle ODER kurz sind.

Die "Oder"-Verknüpfung der freien Produktdatenfelder material und laenge wird durch den Parameter or_search_active=yes erzeugt.

~WS-ManualSearch(search_input=Sommerhose,material=baumwolle,laenge=kurz,or_search_active=yes)~