Das Formulars, mit dem Interessenten Immobilien-Suchaufträge über das Website-Frontend anlegen können, kann per Widget oder Shortcode eingebunden werden. Der Umfang ist variabel, wobei folgende Pflichtelemente immer enthalten sind:
- E-Mail-Adresse
- Objektart (Immobilientyp)
- Vermarktungsart (Kauf/Miete)
Optionale Elemente:
- Anrede
- Vor- und Nachname
- Fläche *
- Zimmeranzahl *
- Preisrahmen *
- Immobilienstandort
- Radius (Umkreissuche)
* Die Min/Max-Werte der Slider für die Vorgabe von Fläche, Zimmeranzahl und Preisrahmen sind abhängig von der ausgewählten Objekt- und Vermarktungsart.

Suchauftragsformular mit vollem Umfang
Info-/Hinweistexte und Meldungen des Formulars sowie die Bezeichnung des Absenden-Buttons können im Tab Formular der Plugin-Optionen angepasst werden.
Widget
Für die Einbindung des Formulars als Widget in eine beliebige Seitenleiste (Sidebar) gibt es mehrere Möglichkeiten:
WP-Backend
Bei der ersten Variante wird zunächst die Seite Design → Widgets im WordPress-Backend aufgerufen. Anschließend wird die gewünschte Sidebar ausgewählt und hier per Klick auf das + (Block hinzufügen) und eine anschließende Suche das Widget "immonex Notify: Suchauftragsformular" ergänzt.
Anstatt der Suche kann das Widget auch in der Liste ausgewählt werden, die nach dem Klick auf Legacy-Widget angezeigt wird.

Neben der Eingabe eines Titels können in den Optionen der Widget-Instanz¹ auch die optionalen Elemente ausgewählt werden, die im Formular enthalten sein sollen.
!> Nach dem Einfügen/Bearbeiten: Aktualisieren (7) nicht vergessen!

Vorschau des Frontend-Formulars per Klick außerhalb des Optionsformulars
Customizer
Die zweite Variante der Einbindung per Customizer ist hinsichtlich der Vorgehensweise fast identisch:
- beliebige Seite im Frontend aufrufen, die die gewünschte Sidebar enthält und Customizer im Admin-Menübalken am ober Seitenrand anklicken oder im WP-Backend Design → Customizer wählen
- Widgets und anschließend die Sidebar auswählen, in die das Formular eingefügt werden soll
- Widget "immonex Notify: Suchauftragsformular" per Klick auf einen der + Buttons und nachfolgender Suche oder via Legacy-Widget ergänzen
- optional: Titel und (erweiterte) Formularelemente festlegen
- Veröffentlichen wählen und Customizer verlassen

Shortcode
Das Formular kann auch per Shortcode in beliebige Seiten, Beiträge, Theme-Templates etc. eingebunden werden:
[immonex-notify-form]
In PHP-Templates erfolgt die Einbindung mit do_shortcode():
echo do_shortcode( '[immonex-lead-generator]' );Der Formularumfang kann per Attribut elements festgelegt werden:
[immonex-notify-form elements="…"]
Als Attributwert kann entweder eine kommagetrennte Liste der folgenden Elementschlüssel (Key) oder all (alle Elemente) bzw. compact * (Standardvorgabe: E-Mail-Adresse, Objektart, Vermarktungsart, Standort, Umkreisradius) übergeben werden.
| Key | 
|---|
| salutation | 
| first_name | 
| last_name | 
| email* | 
| property_type* | 
| marketing_type* | 
| location | 
| distance_radius | 
| area | 
| rooms | 
| price | 
* Die Plichtfelder sind immer enthalten und müssen nicht explizit angegeben werden. Gleiches gilt für die Angabe compact, die als Standardvorgabe auch bei fehlendem Attribut elements automatisch übernommen wird.
Beispiele
Formular mit Auwahlelementen und Feldern für Anrede, Vor-/Nachname und Zimmeranzahl (+ Pflichtfelder):[immonex-notify-form elements="salutation, first_name, last_name, rooms"]
Formular mit allen Elementen:[immonex-notify-form elements="all"]
Siehe auch
- Filter immonex_notify_request_form_elements (Formularelemente)
- Filter immonex_notify_render_request_form (Formular-HTML-Code)
¹ Die mehrfache Einbindung des Suchauftragsformulars – bspw. in unterschiedlichen Sidebars – ist möglich.