WPForms

WP-ImmoMakler kann ein vorhandenes WPForms-Formular als Immobilien-Kontaktformular verwenden. Eingehende Anfragen werden automatisch an die jeweilige Kontakt-E-Mail-Adresse der angefragten Immobilie weitergeleitet.

Mit WP-ImmoMakler PLUS lässt sich zusätzlich an beliebig viele WPForms-Formulare eine OpenImmo-Feedback-XML-Datei anhängen, sodass Ihre Maklersoftware eingehende Anfragen automatisiert verarbeiten kann.

Sofern Sie aktuell nur eine WP-ImmoMakler BASIC Lizenz nutzen, können Sie jederzeit ein Upgrade buchen und zahlen lediglich den Differenzbetrag — bei Interesse bitte unseren Support kontaktieren.

Voraussetzungen

Das Plugin WPForms (Lite oder Pro) muss installiert und aktiviert sein.

Lizenzen im Vergleich

Funktion	BASIC	PLUS
Ein WPForms-Formular als Immobilien-Kontaktformular nutzen	✓	✓
Empfänger automatisch auf die Kontaktperson der Immobilie setzen	✓	✓
Strukturierte Immobilien-Zusammenfassung in der Benachrichtigungsmail	✓	✓
OpenImmo-Feedback-XML an Benachrichtigungen anhängen	–	✓
XML-Anhang für mehrere Formulare gleichzeitig (jedes WPForms-Formular, nicht nur das oben gewählte Immobilien-Kontaktformular)	–	✓

Immobilien-Kontaktformular einrichten

Im Backend Ihrer Website können Sie einstellen, welches WPForms-Formular auf den Detailseiten Ihrer Immobilien anstelle des WP-ImmoMakler Kontaktformulars angezeigt werden soll. Sie können ein Formular auswählen, das auf allen Detailseiten angezeigt wird.

Navigieren Sie im Backend Ihrer Website (wp-admin) zu WP-ImmoMakler → Einstellungen → Integrationen → WPForms.

1. Integration aktivieren: Schalter umlegen.
2. Immobilien-Kontaktformular: das WPForms-Formular auswählen, das auf den Detailseiten angezeigt werden soll.
3. Speichern.

Alle weiteren Einstellungen (Empfängerüberschreibung, XML-Anhang) erfolgen seit WP-ImmoMakler Version 5.60 pro Benachrichtigung direkt im WPForms-Formular-Editor — siehe die nächsten Abschnitte.

Empfänger durch Kontaktperson der Immobilie ersetzen

Soll eine Benachrichtigung des Formulars an die Kontaktperson der jeweils angefragten Immobilie gehen — und nicht an den in WPForms statisch hinterlegten Empfänger? Das richten Sie pro Benachrichtigung im WPForms-Formular-Editor ein.

Öffnen Sie das gewünschte Formular im WPForms-Formular-Editor und wechseln Sie zu Einstellungen → Benachrichtigungen. Innerhalb jeder Benachrichtigung finden Sie den Schalter WP-ImmoMakler: Empfänger durch Kontaktperson der Immobilie ersetzen.

Wenn der Schalter aktiv ist und das Formular auf einer Immobilien-Detailseite abgesendet wird, ersetzt WP-ImmoMakler den hinterlegten WPForms-Empfänger automatisch durch das Datenfeld kontaktperson_email_feedback der angefragten Immobilie. Andere Benachrichtigungen des Formulars (z.B. eine Bestätigungsmail an den Anfragenden) bleiben unverändert.

Tipp

Diese Funktion gilt nicht nur für das oben gewählte Immobilien-Kontaktformular, sondern für jedes WPForms-Formular, das auf einer Immobilien-Detailseite eingebunden ist. So können Sie z.B. Direktanfrage-Formulare oder Rückruf-Formulare unabhängig konfigurieren.

OpenImmo-Feedback-XML-Anhang PLUS

Seit WP-ImmoMakler 5.60 wird der XML-Anhang direkt im jeweiligen WPForms-Formular konfiguriert — nicht mehr im globalen Einstellungs-Tab. Dadurch können Sie den Anhang für beliebig viele Formulare gleichzeitig aktivieren — auch für Formulare, die unabhängig vom oben gewählten Immobilien-Kontaktformular existieren. Beispiele:

• Ein separates Käufer- und ein separates Mieter-Formular, beide auf den Immobilien-Detailseiten eingebunden.
• Ein Direktanfrage- oder Rückruf-Formular auf einer Landingpage zu einem bestimmten Immobilienprojekt — die Einrichtung dazu erklärt Schritt 3 unten.
• Ein Besichtigungstermin-Formular, das ausschließlich für Premium-Objekte angezeigt wird.

Das Formular muss kein “WP-ImmoMakler-Formular” sein und muss nicht das oben gewählte Immobilien-Kontaktformular sein. Nur wenn die Kontaktaufnahme einer Immobilie zugeordnet werden soll, muss das Formular von einer Immobilien-Detailseite abgesendet werden — wird es von einer anderen Seite abgesendet, enthält das <objekt>-Element keine Immobilien-Felder, sondern nur die Kontaktdaten unter <interessent>. Die Konfiguration besteht aus folgenden Schritten pro Formular:

1. Jedes Formularfeld einem OpenImmo-XML-Knoten zuordnen.
2. Pro Benachrichtigung aktivieren, dass das XML angehängt wird.
3. Optional, nur für Landingpages mit konkretem Immobilienprojekt: Ein Projektauswahl-Feld anlegen und der Immobilie zuordnen.

Schritt 1: Felder OpenImmo-XML-Knoten zuordnen

Öffnen Sie das Formular im WPForms-Formular-Editor und klicken Sie auf das gewünschte Feld. Im Reiter Feldoptionen → Erweitert finden Sie die neue Auswahl OpenImmo XML-Feld (WP-ImmoMakler).

Ordnen Sie pro Feld einen der folgenden XML-Knoten zu.

Knoten zum Interessenten (landen im Element interessent):

anrede, vorname, nachname, firma, strasse, plz, ort, tel, email

Knoten zur Immobilie (landen im Element objekt):

bezeichnung (Objekt) — die Objektbezeichnung. Siehe den Abschnitt “Objektbezeichnung aus Formularfeldern” unten.

Hinweis

Jeder XML-Knoten kann pro Formular nur einmal zugeordnet werden. Sobald Sie z.B. ein Feld dem Knoten email zuweisen, wird die Option email in den Auswahlfeldern aller anderen Formularfelder ausgegraut.

Objektbezeichnung aus Formularfeldern

Der Knoten bezeichnung (Objekt) beschreibt nicht den Interessenten, sondern die Immobilie. Er eignet sich vor allem für allgemeine Anfrageformulare, in denen der Interessent selbst angibt, wonach er sucht.

• Mehrfachauswahl- und Checkbox-Felder werden kommagetrennt in den Knoten bezeichnung geschrieben (Beispiel: Reihenhaus, Doppelhaus, Villa).
• Auf einer Immobilien-Detailseite ist bezeichnung standardmäßig bereits mit dem Objekttitel belegt. Ist zusätzlich ein Formularfeld zugeordnet, wird dessen Wert mit einem Gedankenstrich an den Titel angehängt (Beispiel: Schöne Stadtwohnung — Reihenhaus, Doppelhaus).
• Ohne Immobilien-Detailseite (z.B. auf einer Landingpage) enthält bezeichnung ausschließlich den Wert des zugeordneten Formularfeldes.

Kombinierte “Name”-Felder (Vorname + Nachname)

Bei einem WPForms-Feld vom Typ Name mit dem Format Vorname Nachname (oder Vorname Zweiter Vorname Nachname) erscheinen im Reiter Erweitert zwei Auswahlfelder:

• OpenImmo XML-Feld für “Vorname”
• OpenImmo XML-Feld für “Nachname”

So können Sie Vor- und Nachname in zwei getrennte XML-Knoten schreiben (in der Regel vorname und nachname).

Tipp

OpenImmo Feedback hat keinen eigenen XML-Knoten für den zweiten Vornamen. Bei einem Name-Feld im Format Vorname Zweiter Vorname Nachname wird der zweite Vorname automatisch an den Vornamen angehängt (Beispiel: John Q.).

Felder ohne Zuordnung

Alle Felder ohne ausdrückliche Zuordnung werden gesammelt und im XML-Element interessent → anfrage als Freitext mitgesendet. Die Werte angekreuzter Checkbox-Felder erscheinen dort unter der Überschrift “Bestätigt:”. Sobald Sie ein Checkbox- oder Mehrfachauswahl-Feld jedoch ausdrücklich einem XML-Knoten (z.B. bezeichnung) zuordnen, wird sein Wert nur noch dort kommagetrennt übertragen und nicht mehr zusätzlich im Freitext aufgeführt.

Schritt 2: XML-Anhang pro Benachrichtigung aktivieren

Wechseln Sie im selben Formular zu Einstellungen → Benachrichtigungen. Innerhalb jeder Benachrichtigung finden Sie den Schalter WP-ImmoMakler: OpenImmo Feedback XML senden.

Schalten Sie den Schalter bei jeder Benachrichtigung an, an die das XML angehängt werden soll. Andere Benachrichtigungen des Formulars (z.B. eine Bestätigungsmail an den Anfragenden) bleiben unverändert.

Achtung

Wenn keine Benachrichtigung den Schalter aktiviert hat, wird kein XML angehängt — auch nicht, wenn Sie die Felder zugeordnet haben.

Schritt 3: Projekt-ID hinterlegen / zuordnen

Bindet das Formular auf einer Landingpage zu einem bestimmten Immobilienprojekt ein, können Sie ein Auswahlfeld mit Ihren Projekten anlegen und es dem OpenImmo-XML-Knoten bezeichnung (Objekt) zuordnen. Die Anfrage landet dann in Ihrer Maklersoftware mit dem gewählten Projekt als Objektbezeichnung.

Anbei sehen Sie, wie Sie die Projekt-ID hinterlegen und zuordnen:

Legen Sie zunächst im Reiter Allgemein ein Dropdown-Feld (z.B. „Projektauswahl”) an und tragen Sie Ihre Projekte als Wahlmöglichkeiten ein:

Wechseln Sie dann in den Reiter Erweitert und ordnen Sie das Feld unter OpenImmo XML-Feld (WP-ImmoMakler) dem Knoten bezeichnung (Objekt) zu:

Sobald ein Interessent das Formular absendet, wird der ausgewählte Projektname in das XML-Element objekt → bezeichnung geschrieben und in Ihrer Maklersoftware automatisch dem entsprechenden Projekt zugeordnet.

Migration aus älteren Versionen

Hat Ihre Installation vor dem Update auf 5.60 die OpenImmo-Feedback-XML-Funktion bereits genutzt, übernimmt WP-ImmoMakler beim ersten Aufruf des wp-admin nach dem Update automatisch die bisherige Konfiguration in das ausgewählte Formular: die alte XML-Aktivierung schaltet den passenden Senden-Schalter in der zuvor gewählten Benachrichtigung an, und die alte Feldzuordnung wird in die jeweiligen Formularfelder geschrieben. Sie müssen nichts manuell nachpflegen.

War vor dem Update kein XML-Anhang aktiv, bleibt nach dem Update alles still — kein Formular fängt überraschend an, XML zu senden.

Immobilien-Angaben in der Benachrichtigungsmail

Unabhängig vom XML-Anhang fügt WP-ImmoMakler an jede Benachrichtigung des Immobilien-Kontaktformulars (siehe oben “Immobilien-Kontaktformular einrichten”) eine strukturierte Zusammenfassung der angefragten Immobilie an: Titelbild, Titel, Objektnummer, Adresse, Zimmeranzahl, Fläche, Preis und Provisionshinweis.

PHP-Filter

// Empfänger-E-Mail für Testzwecke überschreiben (BASIC + PLUS).
add_filter( 'immomakler_mail_force_recipient_email', function ( $email ) {
  return 'test@example.com';
} );

// Absender-Name im OpenImmo-Feedback-XML überschreiben (PLUS).
add_filter( 'immomakler_openimmofeedback_sender_name', function ( $name ) {
  return 'Mein Maklerbüro';
} );

// Welches Custom-Field der Immobilie wird in das XML-Element <oobj_id> geschrieben? (PLUS)
// Standard: 'objektnr_extern'.
add_filter( 'immomakler_openimmofeedback_key_for_oobj_id', function ( $key, $post_id ) {
  return 'meine_objekt_id';
}, 10, 2 );

Einstellungsübersicht

Global (WP-ImmoMakler → Einstellungen → Integrationen → WPForms)

Label	Typ	Standard	Beschreibung
Integration aktivieren	Schalter	false	Aktiviert WPForms als Immobilien-Kontaktformular
Immobilien-Kontaktformular	Auswahl	–	WPForms-Formular für die Detailseiten

Pro WPForms-Benachrichtigung (Einstellungen → Benachrichtigungen)

Label	Typ	Beschreibung
WP-ImmoMakler: Empfänger durch Kontaktperson der Immobilie ersetzen	Schalter	Ersetzt den WPForms-Empfänger durch kontaktperson_email_feedback
WP-ImmoMakler: OpenImmo Feedback XML senden PLUS	Schalter	Hängt das XML an genau diese Benachrichtigung an

Pro WPForms-Formularfeld (Feldoptionen → Erweitert) PLUS

Label	Typ	Beschreibung
OpenImmo XML-Feld (WP-ImmoMakler)	Auswahl	Ordnet das Formularfeld einem XML-Knoten zu — Interessent: anrede, vorname, nachname, firma, strasse, plz, ort, tel, email; Objekt: bezeichnung (Objekt) (Mehrfachauswahl- und Checkbox-Werte werden kommagetrennt geschrieben)
OpenImmo XML-Feld für “Vorname” / “Nachname”	Auswahl	Pro Sub-Feld eines kombinierten Name-Feldes

Das könnte Sie auch interessieren

• Kontaktformular konfigurieren
• Kontaktformular-Hooks
• Spam-Schutz