Plugin WordPress JustImmo : import automatique des biens immobiliers

WP-ImmoMakler est le plugin WordPress pour JustImmo : il transfère automatiquement vos biens immobiliers de JustImmo vers votre site WordPress via l’interface OpenImmo.

Prérequis

Un accès JustImmo avec un export OpenImmo activable (interface de portail)
Les identifiants FTP ou SFTP de votre serveur web — vous les obtenez auprès de votre hébergeur
Un site WordPress avec WP-ImmoMakler installé ; le plugin crée automatiquement le répertoire de transfert /openimmo/

Configurer l’export OpenImmo dans JustImmo

La connexion entre JustImmo et WP-ImmoMakler s’effectue via l’export OpenImmo. Créez dans JustImmo une nouvelle interface de portail et saisissez les identifiants FTP ou SFTP de votre serveur web.

Renseignez les champs suivants :

Nom du portail : un nom explicite, par exemple “Site web”, “Homepage” ou “WP-ImmoMakler”
Numéro de fournisseur : un chiffre quelconque — généralement “1” si vous êtes le seul fournisseur
Dossier FTP : par défaut /openimmo/ dans le répertoire racine de WordPress. Si WordPress est installé dans un sous-répertoire, indiquez le chemin complet depuis la racine FTP, par exemple /clickandbuilds/app/wordpress_1/openimmo/
Port FTP : port 21 pour FTP, FTPS ou FTP/TLS ; port 22 pour SFTP/SSH
Noms de fichiers : le paramètre de substitution %date1% permet d’insérer un horodatage dans les noms de fichiers. Exemple : openimmo_%date1%.zip
Vidéos : option à activer si vous souhaitez inclure des vidéos dans le transfert

L’exemple suivant illustre la configuration d’une connexion SFTP dans JustImmo :

Paramètres d'export OpenImmo JustImmo avec la configuration de connexion SFTP

Biens de référence

Pour afficher des biens de référence sur votre site, consultez l’article “Afficher les biens de référence”.

Pour toute question relative à la configuration, n’hésitez pas à contacter le support.

Comment fonctionne l’import automatique

Une fois la configuration terminée, JustImmo transfère à chaque export un fichier OpenImmo dans le répertoire /openimmo/ de votre site. WP-ImmoMakler prend ensuite le relais : le plugin traite automatiquement les fichiers entrants, crée les nouveaux biens, met à jour les biens modifiés et supprime les biens qui ont été supprimés dans JustImmo. Pour un rythme fiable, une tâche planifiée (Cron) sur le serveur est recommandée.

Les photos, plans et documents de l’export sont automatiquement importés dans la médiathèque WordPress. Vous définissez dans les paramètres d’import si les fichiers traités sont ensuite supprimés et si vous souhaitez être informé par e-mail des imports réussis.

Importer des projets immobiliers via l’API JustImmo PLUS

L’export OpenImmo ne transfère que les unités individuelles d’un projet immobilier, pas le projet lui-même. Pour que la page du projet, avec sa description, ses images et ses plans, n’ait pas à être entretenue manuellement, WP-ImmoMakler récupère les projets immobiliers directement via l’API JustImmo.

Les deux s’articulent ensemble : les unités continuent d’arriver via l’export OpenImmo, tandis que le projet immobilier provient de l’API. WP-ImmoMakler relie automatiquement les deux, de sorte que les unités apparaissent dans le tableau des unités de la page du projet.

Identifiants API JustImmo

Les identifiants API ne sont pas vos identifiants de connexion JustImmo. Ils sont générés séparément dans JustImmo :

Ouvrez dans JustImmo plus → Exports → Mes exports.
Activez l’API à cet endroit. JustImmo génère alors un nom d’utilisateur et un mot de passe.
Intégrez vos projets immobiliers et les biens correspondants dans l’export API — exactement comme pour tout autre export JustImmo. Les biens qui ne sont pas intégrés ne peuvent pas être vus par l’interface.

Pour les étapes 1 et 2, vous avez besoin des droits d’administrateur dans JustImmo.

Configuration dans WordPress

Saisissez les identifiants dans le backend de votre site (wp-admin) sous WP-ImmoMakler → Logiciel/Portails → JustImmo et activez l’option Importer automatiquement les projets immobiliers.

Les paramètres suivants sont disponibles :

Intervalle d’import en heures : Fréquence à laquelle les projets immobiliers sont synchronisés. Les projets immobiliers changent rarement, une fois par jour suffit généralement.
Taille d’image : Taille à laquelle les images du projet sont récupérées. Sans indication, JustImmo fournit des images relativement petites.
Langue : Code de langue dans lequel les données du projet sont récupérées.

Le point de couleur à côté de l’onglet « JustImmo » ainsi que le message de statut dans l’onglet lui-même indiquent si la connexion est active.

Que se passe-t-il en cas d’erreur ?

Deux causes se ressemblent de l’extérieur mais nécessitent des démarches différentes — WP-ImmoMakler les distingue donc dans le message :

Identifiants rejetés : En général, les identifiants de connexion JustImmo ont été saisis à la place des identifiants API. Générez les identifiants comme décrit ci-dessus.
Aucun projet immobilier accessible : Les identifiants sont corrects, mais rien n’a été intégré dans l’export API. Intégrez vos projets dans l’export API dans JustImmo.

Questions fréquentes sur JustImmo et WordPress

Comment WP-ImmoMakler gère-t-il les statuts des biens JustImmo ?

Les biens ayant le statut “vendu” ou “loué” sont reconnus comme commercialisés et — si l’option de référence est activée — automatiquement marqués comme références. Les biens au statut “brouillon” ne sont pas publiés automatiquement, mais enregistrés également comme brouillons dans WordPress.

Les images, plans et documents sont-ils repris ?

Oui. Toutes les pièces jointes de l’export OpenImmo — photos, plans, documents PDF — sont automatiquement importées dans la médiathèque WordPress. La qualité d’image peut être ajustée sous Paramètres : Import ; à partir de WP-ImmoMakler PLUS, les images peuvent en outre être converties automatiquement au format AVIF, peu gourmand en espace.

Que se passe-t-il si je supprime un bien dans JustImmo ?

Si JustImmo transmet une commande de suppression ou une synchronisation complète sans le bien, celui-ci est également supprimé de votre site. Vous pouvez en exclure les biens de référence — avec l’option “Ignorer les commandes de suppression pour les biens de référence” sous Paramètres : Import.

Dois-je encore faire quelque chose après la configuration ?

Non. Lancez une seule fois un export complet dans JustImmo afin que l’ensemble du portefeuille soit transféré — ensuite, la synchronisation s’exécute automatiquement. Vous n’avez pas besoin de vous connecter à WordPress pour cela.

Pourquoi mes projets immobiliers n’apparaissent-ils pas sur le site ?

Vérifiez d’abord si les projets sont intégrés dans l’export API dans JustImmo, sous plus → Exports → Mes exports — sans cette intégration, ils ne sont pas visibles pour l’interface. Si la connexion est active, l’onglet « JustImmo » affiche un message de statut avec le nombre de projets transférés.

Les unités d’un projet n’apparaissent dans le tableau des unités qu’une fois importées via l’export OpenImmo. Le projet immobilier et ses unités proviennent de deux sources différentes et se rencontrent sur la page du projet.