> 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.
