WPForms

WP-ImmoMakler peut utiliser un formulaire WPForms existant comme formulaire de contact pour vos biens immobiliers. Les demandes entrantes sont automatiquement transmises à l’adresse e-mail de contact du bien concerné.

Avec WP-ImmoMakler PLUS, un fichier XML OpenImmo Feedback peut en outre être joint à autant de formulaires WPForms que vous le souhaitez, permettant à votre logiciel de gestion immobilière de traiter automatiquement les demandes entrantes.

Toujours avec WP-ImmoMakler PLUS, vous pouvez enrichir n’importe quel formulaire WPForms d’une inscription à la newsletter Propstack avec double opt-in — soit sous forme d’opt-in dans un formulaire existant, soit sous forme de formulaire de newsletter autonome.

Si vous n’utilisez actuellement qu’une licence WP-ImmoMakler BASIC, vous pouvez souscrire une mise à niveau à tout moment et ne payez que la différence — si vous êtes intéressé, veuillez contacter notre Support.

Prérequis

Le plugin WPForms (Lite ou Pro) doit être installé et activé.

Comparaison des licences

Fonctionnalité	BASIC	PLUS
Utiliser un formulaire WPForms comme formulaire de contact pour biens immobiliers	✓	✓
Définir automatiquement le destinataire sur la personne de contact du bien	✓	✓
Résumé structuré du bien dans l’e-mail de notification	✓	✓
Joindre un XML OpenImmo Feedback aux notifications	–	✓
Pièce jointe XML pour plusieurs formulaires simultanément (n’importe quel formulaire WPForms, pas seulement le formulaire de contact sélectionné ci-dessus)	–	✓
Inscription à la newsletter Propstack avec double opt-in dans le formulaire	–	✓

Configurer le formulaire de contact pour biens immobiliers

Dans le back-office de votre site web, vous pouvez définir quel formulaire WPForms doit être affiché sur les pages de détail de vos biens immobiliers à la place du formulaire de contact de WP-ImmoMakler. Vous pouvez sélectionner un formulaire qui s’affiche sur toutes les pages de détail.

Rendez-vous dans votre back-office WordPress (wp-admin) sous WP-ImmoMakler → Réglages → Intégrations → WPForms.

1. Activer l’intégration : activez le bouton.
2. Formulaire de contact pour biens immobiliers : sélectionnez le formulaire WPForms à afficher sur les pages de détail.
3. Enregistrer.

Tous les réglages supplémentaires (remplacement du destinataire, pièce jointe XML) sont configurés depuis la version 5.60 de WP-ImmoMakler par notification directement dans l’éditeur de formulaire WPForms — voir les sections suivantes.

Remplacer le destinataire par la personne de contact du bien

Souhaitez-vous qu’une notification du formulaire soit envoyée à la personne de contact du bien demandé — et non au destinataire défini de manière statique dans WPForms ? Configurez cela par notification dans l’éditeur de formulaire WPForms.

Ouvrez le formulaire souhaité dans l’éditeur de formulaire WPForms et passez à Réglages → Notifications. Dans chaque notification, vous trouverez le bouton WP-ImmoMakler : Remplacer le destinataire par la personne de contact du bien.

Lorsque le bouton est actif et que le formulaire est soumis depuis une page de détail d’un bien immobilier, WP-ImmoMakler remplace automatiquement le destinataire WPForms enregistré par le champ de données kontaktperson_email_feedback du bien demandé. Les autres notifications du formulaire (p. ex. un e-mail de confirmation à l’expéditeur de la demande) restent inchangées.

Astuce

Cette fonctionnalité s’applique non seulement au formulaire de contact sélectionné ci-dessus, mais à tout formulaire WPForms intégré sur une page de détail d’un bien immobilier. Vous pouvez ainsi configurer indépendamment, par exemple, des formulaires de demande directe ou de rappel téléphonique.

Pièce jointe XML OpenImmo Feedback PLUS

Depuis WP-ImmoMakler 5.60, la pièce jointe XML est configurée directement dans le formulaire WPForms concerné — et non plus dans l’onglet de réglages global. Cela vous permet d’activer la pièce jointe pour autant de formulaires que vous le souhaitez simultanément — y compris pour des formulaires indépendants du formulaire de contact sélectionné ci-dessus. Exemples :

• Un formulaire distinct pour les acheteurs et un autre pour les locataires, tous deux intégrés sur les pages de détail des biens immobiliers.
• Un formulaire de demande directe ou de rappel sur une page d’atterrissage dédiée à un projet immobilier spécifique — la mise en place est expliquée à l’Étape 3 ci-dessous.
• Un formulaire de visite affiché exclusivement pour les biens premium.

Le formulaire n’a pas besoin d’être un « formulaire WP-ImmoMakler » ni le formulaire de contact sélectionné ci-dessus. Ce n’est que si la demande doit être associée à un bien immobilier que le formulaire doit être soumis depuis une page de détail d’un bien — s’il est soumis depuis une autre page, l’élément <objekt> ne contiendra pas de champs du bien immobilier, mais uniquement les données de contact sous <interessent>.

La configuration se compose des étapes suivantes par formulaire :

1. Attribuer chaque champ du formulaire à un nœud XML OpenImmo.
2. Activer par notification l’ajout de la pièce jointe XML.
3. Facultatif, uniquement pour les pages d’atterrissage avec un projet immobilier précis : Créer un champ de sélection de projet et l’attribuer au bien.

Étape 1 : Attribuer les champs aux nœuds XML OpenImmo

Ouvrez le formulaire dans l’éditeur de formulaire WPForms et cliquez sur le champ souhaité. Dans l’onglet Options du champ → Avancé, vous trouverez le nouveau sélecteur Champ XML OpenImmo (WP-ImmoMakler).

Attribuez un des nœuds XML suivants par champ.

Nœuds pour le demandeur (placés dans l’élément interessent) :

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

Nœuds pour le bien immobilier (placés dans l’élément objekt) :

bezeichnung (Objekt) — la désignation du bien. Voir la section « Désignation du bien à partir des champs du formulaire » ci-dessous.

Note

Chaque nœud XML ne peut être attribué qu’une seule fois par formulaire. Dès que vous attribuez un champ au nœud email, par exemple, l’option email dans les sélecteurs de tous les autres champs du formulaire est grisée.

Désignation du bien à partir des champs du formulaire

Le nœud bezeichnung (Objekt) ne décrit pas le demandeur, mais le bien immobilier. Il est particulièrement adapté aux formulaires de demande généraux dans lesquels le demandeur indique lui-même ce qu’il recherche.

• Les champs à choix multiples et cases à cocher sont écrits dans le nœud bezeichnung séparés par des virgules (exemple : Maison mitoyenne, Maison jumelée, Villa).
• Sur une page de détail d’un bien, bezeichnung est déjà renseigné par défaut avec le titre du bien. Si un champ du formulaire est en plus attribué, sa valeur est ajoutée au titre avec un tiret cadratin (exemple : Bel appartement en ville — Maison mitoyenne, Maison jumelée).
• Sans page de détail d’un bien (p. ex. sur une page d’atterrissage), bezeichnung contient exclusivement la valeur du champ du formulaire attribué.

Champs « Nom » combinés (prénom + nom)

Pour un champ WPForms de type Nom avec le format Prénom Nom (ou Prénom Deuxième prénom Nom), deux sélecteurs apparaissent dans l’onglet Avancé :

• Champ XML OpenImmo pour « Prénom »
• Champ XML OpenImmo pour « Nom »

Cela vous permet d’écrire le prénom et le nom dans deux nœuds XML séparés (généralement vorname et nachname).

Astuce

OpenImmo Feedback ne dispose pas de nœud XML dédié pour le deuxième prénom. Pour un champ Nom avec le format Prénom Deuxième prénom Nom, le deuxième prénom est automatiquement ajouté au prénom (exemple : John Q.).

Champs sans attribution

Tous les champs sans attribution explicite sont regroupés et envoyés dans l’élément XML interessent → anfrage sous forme de texte libre. Les valeurs des cases à cocher cochées y apparaissent sous l’intitulé « Confirmé : ». Dès que vous attribuez explicitement un champ de case à cocher ou à choix multiples à un nœud XML (p. ex. bezeichnung), sa valeur n’est transmise qu’à cet endroit, séparée par des virgules, et n’est plus également répertoriée dans le texte libre.

Étape 2 : Activer la pièce jointe XML par notification

Passez à Réglages → Notifications dans le même formulaire. Dans chaque notification, vous trouverez le bouton WP-ImmoMakler : Envoyer le XML OpenImmo Feedback.

Activez le bouton pour chaque notification à laquelle le XML doit être joint. Les autres notifications du formulaire (p. ex. un e-mail de confirmation à l’expéditeur de la demande) restent inchangées.

Attention

Si aucune notification n’a le bouton activé, aucun XML ne sera joint — même si vous avez attribué les champs.

Étape 3 : Renseigner / attribuer l’ID du projet

Si le formulaire est intégré sur une page d’atterrissage dédiée à un projet immobilier précis, vous pouvez créer un champ de liste déroulante avec vos projets et l’attribuer au nœud XML OpenImmo bezeichnung (Objekt). La demande arrivera alors dans votre logiciel de gestion immobilière avec le projet sélectionné comme désignation du bien.

Voici comment renseigner et attribuer l’ID du projet :

Commencez par créer un champ Liste déroulante (p. ex. « Sélection du projet ») dans l’onglet Général et saisissez vos projets comme choix :

Passez ensuite dans l’onglet Avancé et attribuez le champ au nœud bezeichnung (Objekt) sous Champ XML OpenImmo (WP-ImmoMakler) :

Dès qu’un demandeur soumet le formulaire, le nom du projet sélectionné est écrit dans l’élément XML objekt → bezeichnung et automatiquement associé au projet correspondant dans votre logiciel de gestion immobilière.

Migration depuis les versions antérieures

Si votre installation utilisait déjà la fonctionnalité XML OpenImmo Feedback avant la mise à jour vers la version 5.60, WP-ImmoMakler migre automatiquement la configuration précédente vers le formulaire sélectionné lors du premier accès au wp-admin après la mise à jour : l’ancienne activation XML active le bouton Envoyer correspondant dans la notification précédemment sélectionnée, et les anciennes attributions de champs sont écrites dans les champs du formulaire correspondants. Aucune intervention manuelle n’est nécessaire.

Si aucune pièce jointe XML n’était active avant la mise à jour, tout reste silencieux après la mise à jour — aucun formulaire ne commencera inopinément à envoyer du XML.

Informations sur le bien dans l’e-mail de notification

Indépendamment de la pièce jointe XML, WP-ImmoMakler ajoute à chaque notification du formulaire de contact pour biens immobiliers (voir « Configurer le formulaire de contact pour biens immobiliers » ci-dessus) un résumé structuré du bien demandé : image principale, titre, numéro de référence, adresse, nombre de pièces, surface, prix et mention de commission.

Inscription à la newsletter Propstack PLUS

Si vous utilisez Propstack comme logiciel de gestion immobilière, n’importe quel formulaire WPForms peut en outre déclencher une inscription à la newsletter avec double opt-in. Lorsque l’expéditeur coche la case de consentement que vous avez choisie, WP-ImmoMakler crée le contact dans Propstack et laisse Propstack envoyer l’e-mail de confirmation.

Cela fonctionne selon deux variantes :

• Opt-in dans un formulaire existant — votre formulaire de contact ou de demande reste inchangé et reçoit simplement une case à cocher supplémentaire.
• Formulaire de newsletter autonome — un formulaire qui déclenche exclusivement l’e-mail de confirmation et n’envoie aucune notification.

La fonctionnalité se configure par formulaire dans l’éditeur de formulaire WPForms sous Réglages → Général → Avancé, dans la section WP-ImmoMakler : Propstack Newsletter. Cela nécessite une connexion Propstack active avec un expéditeur et un modèle d’e-mail, que vous configurez dans le back-office de votre site (wp-admin) sous WP-ImmoMakler → Réglages → Logiciels/Portails → Propstack.

Note

Le guide complet — incluant l’attribution des champs, le formulaire de newsletter autonome et les autres modes d’intégration (shortcode, constructeur de pages, formulaire de contact) — se trouve sous Inscription à la Newsletter Propstack.

Filtres PHP

// Remplacer l'adresse e-mail du destinataire à des fins de test (BASIC + PLUS).
add_filter( 'immomakler_mail_force_recipient_email', function ( $email ) {
  return 'test@example.com';
} );

// Remplacer le nom de l'expéditeur dans le XML OpenImmo Feedback (PLUS).
add_filter( 'immomakler_openimmofeedback_sender_name', function ( $name ) {
  return 'Mon agence immobilière';
} );

// Quel champ personnalisé du bien est écrit dans l'élément XML <oobj_id> ? (PLUS)
// Valeur par défaut : 'objektnr_extern'.
add_filter( 'immomakler_openimmofeedback_key_for_oobj_id', function ( $key, $post_id ) {
  return 'mon_id_bien';
}, 10, 2 );

Aperçu des réglages

Global (WP-ImmoMakler → Réglages → Intégrations → WPForms)

Libellé	Type	Par défaut	Description
Activer l’intégration	Bouton	false	Active WPForms comme formulaire de contact pour biens immobiliers
Formulaire de contact pour biens immobiliers	Sélection	–	Formulaire WPForms pour les pages de détail

Par notification WPForms (Réglages → Notifications)

Libellé	Type	Description
WP-ImmoMakler : Remplacer le destinataire par la personne de contact du bien	Bouton	Remplace le destinataire WPForms par kontaktperson_email_feedback
WP-ImmoMakler : Envoyer le XML OpenImmo Feedback PLUS	Bouton	Joint le XML à cette notification spécifique

Par formulaire WPForms (Réglages → Général → Avancé) PLUS

Libellé	Type	Description
Activer l’inscription à la newsletter Propstack	Bouton	Active l’inscription à la newsletter pour ce formulaire
Case de consentement	Sélection	L’option de case à cocher dont l’activation déclenche l’e-mail de confirmation
Champ e-mail	Sélection	Le champ du formulaire contenant l’adresse e-mail
Champ prénom / Champ nom	Sélection	Facultatif — champ texte ou champ Nom WPForms

Par champ de formulaire WPForms (Options du champ → Avancé) PLUS

Libellé	Type	Description
Champ XML OpenImmo (WP-ImmoMakler)	Sélection	Attribue le champ du formulaire à un nœud XML — Demandeur : anrede, vorname, nachname, firma, strasse, plz, ort, tel, email ; Bien : bezeichnung (Objekt) (les valeurs des champs à choix multiples et cases à cocher sont écrites séparées par des virgules)
Champ XML OpenImmo pour « Prénom » / « Nom »	Sélection	Par sous-champ d’un champ Nom combiné

Cela pourrait aussi vous intéresser

• Inscription à la Newsletter Propstack
• Formulaire de contact
• Hooks du formulaire de contact
• Protection anti-spam