Die Immobiliensuche ist eine zentrale Komponente des Kickstart-Plugins. Das Formular besteht aus einer beliebigen Kombination von Eingabe- und Auswahlelementen, wobei diese in einen primären (direkt sichtbaren) und einen erweiterten Abschnitt (aufklappbar) unterteilt sind. In der Standardkonfiguration enthält der erweiterte Abschnitt die Umkreissuche sowie eine Filtermöglichkeit nach Ausstattungsmerkmalen.
Standard-Suchformular (ohne Anpassungen)
Shortcode
[inx-search-form]
Attribute
| Name |
|---|
cid |
elements |
exclude |
dynamic-update |
| all oder 1 : alle Listen- und Kartenkomponenten der Seite (inkl. Seitennavigation und Auswahl der Sortierreihenfolge) |
inx-property-map, inx-property-list (Beispiel): kommagetrennte Liste von HTML-DOM-IDs der zu aktualisierenden Komponenten (eigene IDs können per Attribut cid festgelegt werden) |
results-page-id |
references |
top-level-only |
force-location |
force-type-of-use |
force-property-type |
force-marketing-type |
force-feature |
autocomplete-countries |
autocomplete-osm-place-tags |
template |
Elemente
Die folgenden Schlüssel können als Werte der Attribute elements und excludeübernommen werden.
Primär (direkt sichtbar)
| Key |
|---|
description (1) |
type-of-use |
property-type (2) |
marketing-type (3) |
locality (4) |
project* | Dropdown-Einzelauswahl eines Projekts (Objektgruppe, Term der Taxonomie inx_project) |
min-rooms (5) |
min-area (6) |
price-range (7) |
submit (8) |
reset (9) |
toggle-extended (10) |
* Die Projektauswahl ist standardmäßig ausgeblendet und muss über das Attribut elements oder den Filter-Hook inx_search_form_elements explizit eingeblendet werden.
Erweitert (aufklappbar)
| Key |
|---|
distance-search-location (11) |
distance-search-radius (12) |
features (13) |
labels |
Umfang/Aufteilung
Soll das Formular eine individuelle Auswahl an Elementen enthalten, wird diese mit dem Shortcode-Attribut elements in Form einer kommagetrennten Liste definiert:
[inx-search-form elements="ELEMENT1, ELEMENT2, ELEMENT3..."]
Beispiel: nur Objekt- und Vermarktungsart + Absenden-Button[inx-search-form elements="property-type, marketing-type, submit"]
Mit dem Attribut exclude können alternativ auch bestimmte Elemente der Standardauswahl explizit von der Ausgabe ausgenommen werden:
[inx-search-form exclude="ELEMENT1, ELEMENT2..."]
Beispiel: Objekt- und Vermarktungsart fix vorgeben (keine Auswahlmöglichkeit)[inx-search-form exclude="property-type, marketing-type" property-type="haeuser" marketing-type="zu-verkaufen"]
Erweiterte Suche
Um den Abschnitt für die erweiterten Suchelemente verfügbar zu machen, muss das Element toggle-extended in der Elementliste enthalten sein:[inx-search-form elements="description, property-type, marketing-type, submit, toggle-extended, distance-search-location, distance-search-radius, features"]
Formular mit Abschnitt für erweiterte Suchelemente
Wird ein + an den Namen eines Elements angehangen, wird dieses (unabhängig von dessen Standard-Konfiguration) der erweiterten Suche zugeordnet. Umgekehrt kann mit einem – ein normalerweise erweitertes Element dem Abschnitt der primären, direkt sichtbaren Suchelemente zugeordnet werden.
Beispiel: Ausstattungsliste (features) und Vermarktungs-/Nutzungsarten-Auswahl (marketing-type und type-of-use) in den jeweils anderen Abschnitt verschieben[inx-search-form elements="property-type, features-, submit, toggle-extended, distance-search-location, distance-search-radius, marketing-type+, type-of-use+"]
Formular mit Ausstattungsmerkmalen im primären und Vermarktungs-/Nutzungsarten im erweiterten Abschnitt
Dynamische Listen & Karten
Bei Änderungen der Suchkriterien wird die Anzahl der Ergebnisse auf dem Absenden-Button (8) entsprechendend aktualisiert. Analog dazu ist es ab Kickstart Version 1.6.0 optional möglich, auch die Inhalte der Immobilienlisten und/oder Standortkarten, die sich auf der gleichen Seite befinden, dynamisch (ohne Neuladen) zu aktualisieren. Diese Funktion kann global, d. h. für alle Komponenten auf allen Seiten, in den Plugin-Optionen unter immonex → Einstellungen → Immobiliensuche aktiviert werden:
Alternativ kann die dynamische Aktualisierung mit dem Shortcode-Attribut dynamic-update aber auch auf einzelne Seiten oder spezifische Komponenten beschränkt werden. Als Attributwert werden hierbei entweder die HTML-DOM-IDs der betr. Container-Elemente (einzeln bzw. als kommagetrennte Liste) oder all respektive 1 für alle Kickstart-Komponenten der gleichen Seite angegeben. (IDs zusätzlicher Elemente für die Seitennavigation oder die Filterung/Sortierung der Immobilienlisten müssen hier nicht aufgeführt werden, da diese automatisch mit aktualisiert werden.)
Beispiel: Listenansicht (DOM-ID inx-property-list) und Immobilienkarte (inx-property-map) dynamisch aktualisieren[inx-search-form dynamic-update="inx-property-list, inx-property-map"]
Bei paralleler Aktivierung der globalen Option hat die per Shortcode-Attribut definierte Angabe eine höhere Priorität. Im Beispiel sind die standardmäßig vergebenen DOM-IDs der Elemente für Listen- und Kartenansichten genannt, wobei hier bei einer Mehrfacheinbindung noch eine laufende Nummer angehangen wird: Bei zwei Listen in einer Seite erhalten diese bspw. die IDs inx-property-list und inx-property-list-2. Sollen stattdessen individuelle IDs vergeben werden, ist dies mit dem Attribut cid möglich:
Beispiel: Suchformular und Instanz einer Listenansicht mit der DOM-ID immo-liste einfügen, die bei Änderung der Suchkriterien aktualisiert wird[inx-search-form dynamic-update="immo-liste"] [inx-property-list cid="immo-liste"]