> For the complete documentation index, see [llms.txt](https://help.carpose.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.carpose.de/02_fahrzeuge/04_fahrzeugsuche-konfigurator.md). # Fahrzeugsuche-Konfigurator Der Fahrzeugsuche-Konfigurator ermöglicht es, die Fahrzeugsuche auf der Webseite mit voreingestellten Filtern zu starten. So können Besucher einer bestimmten Unterseite sofort nur die für sie relevanten Fahrzeuge sehen — ohne selbst erst filtern zu müssen. **Beispiele für typische Einsatzzwecke:** * Eine Unterseite „Gebrauchtwagen" öffnet die Suche direkt mit dem Filter „Zustand: Gebraucht" * Eine Unterseite „BMW" zeigt ausschließlich Fahrzeuge der Marke BMW * Eine Landingpage für ein Sonderangebot filtert automatisch auf eine bestimmte Preisspanne * Ein Banner verlinkt auf eine vorausgefüllte Suche nach Fahrzeugen unter 20.000 € ## Funktionsweise Die gewählten Filtereinstellungen werden in einem sogenannten **Hash** gespeichert — einer kurzen Zeichenkette, die alle Filterinformationen komprimiert enthält. Dieser Hash wird anschließend in den HTML-Code der Webseite eingebunden und beim Laden der Seite automatisch von der Fahrzeugsuche ausgelesen. Der Besucher sieht sofort die vorgefilterte Ergebnisliste — ohne dass irgendetwas manuell eingestellt werden muss. ## Erstellung #### 1. Konfigurator öffnen Den Konfigurator findet man im Adminbereich unter **Fahrzeuge → Fahrzeugsuche-Konfigurator** im Seitenmenü. #### 2. Filter auswählen Im Konfigurator können dieselben Filter gesetzt werden, die auch Besucher in der Fahrzeugsuche nutzen — zum Beispiel: * Marke und Modell * Zustand (Neu, Gebraucht, Vorführfahrzeug) * Preisspanne * Kraftstoffart, Getriebe, Antrieb * Baujahr, Kilometerstand Jede Auswahl wird sofort im generierten Hash abgebildet. #### 3. Hash kopieren Nachdem die gewünschten Filter gesetzt wurden, wird der fertige Hash automatisch angezeigt und kann mit einem Klick kopiert werden. #### 4. Hash in die Webseite einbinden Der kopierte Hash wird als Attribut in das HTML-Element der Fahrzeugsuche eingefügt. Wie das genau aussieht, hängt von der jeweiligen Integration ab — die genaue Anleitung dazu findet sich in der Carposé-Dokumentation unter [Zur Dokumentation](https://docs.carpose.de/vehicle-search-modules/vehicle-search-form). ## Bearbeitung Soll ein bereits erstellter Hash angepasst werden, kann er im Konfigurator wieder geladen werden. Dazu den vorhandenen Hash in das entsprechende Eingabefeld einfügen — der Konfigurator stellt die gespeicherten Filter automatisch wieder her. Anschließend können Änderungen vorgenommen und ein neuer Hash generiert werden. ## Hinweise * Ein Hash enthält nur die Voreinstellungen — Besucher können die Filter auf der Webseite jederzeit selbst verändern oder zurücksetzen. * Ändert sich das Fahrzeugangebot (z. B. eine Marke wird nicht mehr geführt), kann ein Hash auf eine leere Ergebnisliste führen. Es empfiehlt sich daher, genutzte Hashes gelegentlich zu überprüfen. * Für jede Unterseite mit anderen Voreinstellungen wird ein eigener Hash benötigt. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.carpose.de/02_fahrzeuge/04_fahrzeugsuche-konfigurator.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.