> ## Documentation Index > Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt > Use this file to discover all available pages before exploring further. # Suchergebnisse > Wie WEBSALE V8s Suchergebnisse auf der Seite ws_search.htm anzeigt und wie Sie eine fertige Suche über einen Deep-Link mit vorbelegten Suchkriterien aufrufen. Die Suche führt zu einer eigenen Seite, auf der WEBSALE V8s die gefundenen Produkte auflistet. Zwei Wege führen dorthin: die Eingabe eines Suchbegriffs durch den Käufer und ein Link, in dem die Suchkriterien bereits stecken. Der zweite Weg ist der interessantere, denn damit lässt sich jede Stelle im Shop mit einer fertig vorbereiteten Produktauswahl verknüpfen, ohne dass dafür eine Kategorie existieren muss. ## Die Suchergebnisseite Die Ergebnisse erscheinen im Template `ws_search.htm` in Ihrem Template-Verzeichnis. Es ist wie eine Kategorieseite aufgebaut und lässt sich genauso frei gestalten. Damit gilt für die Suchergebnisse alles, was Sie von Produktlisten kennen: Blättern, Sortieren und die Ausgabe der einzelnen Produkte funktionieren nach demselben Muster. Wegweiser: [Blättern in Produktlisten](https://dokumentation.websale.de/v8s/anwendungsbeispiele/anwendungsbeispiele.md#blattern-in-produktlisten) ## Suchergebnisse über einen Link aufrufen Angenommen, Sie möchten auf Ihrer Startseite ein Banner für die Marke "adidas" platzieren. Ein Klick darauf soll alle Produkte dieser Marke zeigen. Sauberer wäre dafür eine eigene Kategorie, der Sie die Produkte zuweisen. Lässt sich eine solche Kategorie nicht anlegen, beispielsweise weil die Kategoriestruktur aus dem Warenwirtschaftssystem stammt, springt der Such-Link ein. Er liefert dasselbe Ergebnis, ohne dass Sie an der Struktur etwas ändern müssen. Der Such-Link ist die zweite Wahl. Eine Kategorie ist für Käufer wie für Suchmaschinen die bessere Lösung, weil sie eine eigene, stabile Adresse hat. Greifen Sie zum Such-Link, wenn die Kategorie nicht infrage kommt. ### Aufbau des Links Eingeleitet wird die Suche durch `act=search`. Alles Weitere hängen Sie als zusätzliche Parameter an. ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} act=search&search_input= [&search_cat_index=] [&product_item=] [&price_from=&price_until=] [&=] ``` | Parameter | Bedeutung | | - | - | | `search_input` | Suchbegriff, nach dem gesucht werden soll | | `search_cat_index` | optional, beschränkt die Suche auf die angegebene Kategorie | | `product_item` | optional, beschränkt die Suche auf bestimmte Produktfelder | | `price_from` | optional, findet nur Produkte ab diesem Preis | | `price_until` | optional, findet nur Produkte bis zu diesem Preis | | `` | optional, findet nur Produkte mit einem bestimmten Wert in einem freigeschalteten Produktdatenfeld | Für `product_item` sind drei Werte gebräuchlich: | Wert | Wirkung | | - | - | | `all` | alle Felder durchsuchen | | `name` | nur den Produktnamen durchsuchen | | `number` | nur die Produktnummer durchsuchen | Einen unbekannten Wert behandelt der Shop wie `all`. Ein Tippfehler im Parameter führt also nicht zu einer Fehlermeldung, sondern stillschweigend zu einer breiteren Trefferliste als beabsichtigt. ### Beispiele Alle Produkte, die den Text "Hose" enthalten: ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} https://www.ihre-domain.de/?act=search&search_input=hose ``` Alle Produkte, die "Hose" im Produktnamen tragen und zwischen 50 und 70 Euro kosten: ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} https://www.ihre-domain.de/?act=search&search_input=hose&product_item=name&price_from=50&price_until=70 ``` Liegt `price_until` unter `price_from`, verwirft der Shop die Obergrenze und sucht nur nach unten begrenzt. Eine vertauschte Preisspanne liefert also zu viele Treffer statt gar keiner. ### Nach eigenen Produktdatenfeldern suchen Der Parameter `&marke=adidas` funktioniert nicht deshalb, weil das Produktdatenfeld `marke` heißt. Er funktioniert, weil dieser Feldname zuvor als Suchfeld freigeschaltet wurde. > [!WARNING] > > Produktdatenfelder sind nicht automatisch über die URL durchsuchbar. Jedes Feld, das Sie so ansprechen wollen, muss in der `shop.config` als Suchfeld eingetragen sein. Höchstens 20 Felder lassen sich auf diese Weise freischalten. Nicht freigeschaltete Parameter werden ignoriert, ohne dass eine Meldung erscheint. Derselbe freigeschaltete Name lässt sich auch als Wert für `product_item` verwenden. Damit durchsuchen Sie den Suchbegriff aus `search_input` gezielt nur in diesem einen Feld, statt ihn über alle Felder laufen zu lassen. Referenz: [Abschnitt ProductItemSearch](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/produkte-katalog-und-suche.md#productitemsearch) ### Grenzen der Linklänge > [!WARNING] > > Der Shop merkt sich die übergebenen Suchkriterien in einem Feld von 240 Zeichen. Alles darüber wird abgeschnitten. Bei vielen Parametern oder langen Suchbegriffen können die zuletzt angehängten Kriterien deshalb wirkungslos bleiben. Halten Sie Such-Links kurz und prüfen Sie lange Links im Shop nach. ## Suchlinks im Template erzeugen Statt die Adresse von Hand zusammenzusetzen, können Sie den fertigen Link auch vom Shop ausgeben lassen. Das Tag `WS-SearchLink` übernimmt das. Referenz: [WS-SearchLink](https://dokumentation.websale.de/v8s/referenz/tags/ws/suche-listen-und-blaettern.md#die-tags-im-uberblick) ## Verwandte Themen * Wegweiser: [Blättern in Produktlisten](https://dokumentation.websale.de/v8s/anwendungsbeispiele/anwendungsbeispiele.md#blattern-in-produktlisten) * Wegweiser: [Sortieren von Produktlisten](https://dokumentation.websale.de/v8s/funktionen-fuer-produktlisten/produktlisten-sortieren.md) ## Related topics - [Ausgewählte Suchergebnisse anzeigen](https://dokumentation.websale.de/v8s/suche/ausgewaehlte-suchergebnisse-anzeigen.md) - [Suche & Suchergebnisseite](https://dokumentation.websale.de/ws-search/integration-in-die-templates-storefront/suche-suchergebnisseite.md) - [search - Sortierung und Filterung](https://dokumentation.websale.de/konfiguration/search-sortierung-und-filterung.md) - [ws-search](https://dokumentation.websale.de/ws-search/integration-in-die-templates-storefront/webcomponents/ui-komponenten/ws-search.md) - [Interne WEBSALE-Suche deaktivieren](https://dokumentation.websale.de/v8s/suche/interne-websale-suche-deaktivieren.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.