Webflow

WP-ImmoMakler peut transférer automatiquement les données immobilières dans une Webflow CMS Collection. Chaque bien nouveau ou mis à jour est directement transmis à Webflow. Lorsqu’un bien est supprimé dans WordPress, il est également supprimé dans Webflow.

Prérequis

• Un site Webflow avec une CMS Collection pour les biens immobiliers
• Un token API Webflow V2 avec les autorisations CMS: Read and write et Sites: Read-only

Configuration

1. Générer un token API

   Dans Webflow, rendez-vous dans : W-Logo > Site Settings > Apps & Intégrations > API access > Generate API token.

2. Configurer Webflow dans WP-ImmoMakler

   Dans le backend de votre site (wp-admin), sous WP-ImmoMakler → Intégrations → Webflow :

   1. Saisissez le token API et enregistrez.
   2. Sélectionnez votre site Webflow.
   3. Assignez la CMS Collection pour les biens immobiliers et enregistrez à nouveau.
   4. Assignez optionnellement d’autres collections pour les taxonomies et les personnes de contact.

3. Assigner les champs

   Les champs de la collection doivent être assignés aux clés post-meta WordPress. WP-ImmoMakler affiche sur la page de paramètres un modèle de code généré automatiquement. Copiez ce code PHP dans le fichier functions.php de votre thème :

   add_filter( 'immomakler_webflow_field_matches', function() {
       return [
           'name'                => 'objekttitel',
           'beschreibung'        => 'objektbeschreibung',
           'preis'               => 'kaufpreis',
           'flaeche'             => 'wohnflaeche',
           // autres champs ...
       ];
   } );

Champs spéciaux prédéfinis

Les mots-clés suivants peuvent être utilisés comme valeur dans l’assignation immomakler_webflow_field_matches et ont une fonction spéciale :

Clé	Type	Description
MAIN_IMAGE	Image	Image principale du bien
IMAGES	Multi-image	Toutes les images y compris les plans
IMAGES_NO_FLOORPLANS	Multi-image	Photos uniquement, sans les plans
FLOORPLANS	Multi-image	Plans uniquement
FIRST_VIDEO_URL	Video link	URL de la première vidéo intégrée
FIRST_VIRTUAL_TOUR_URL	Link	URL de la première visite virtuelle
FIRST_VIRTUAL_TOUR_IFRAME	Rich text	Première visite virtuelle en iFrame
CONTACT_FORM_IFRAME	Rich text	Formulaire de contact WordPress en iFrame

Champs booléens et valeurs brutes

// Champs à transmettre en tant que booléen (true/false)
add_filter( 'immomakler_webflow_boolean_post_meta_keys', function() {
    return [ 'provisionspflichtig' ];
} );

// Champs sans unité (par ex. valeur numérique pure sans "EUR" ou "m2")
add_filter( 'immomakler_webflow_raw_post_meta_keys', function() {
    return [ 'kaufpreis', 'kaltmiete', 'wohnflaeche' ];
} );

Statut de publication

Vous pouvez choisir si les biens sont directement publiés (Published) ou placés dans une file d’attente (Queued to publish) dans Webflow.

Note

En cas de modification de la structure de la collection dans Webflow, le site doit d’abord être republié avant que les transferts ne fonctionnent à nouveau.

Filtres PHP

// Personnaliser le slug du bien dans Webflow
add_filter( 'immomakler_webflow_property_slug', function( $slug, $post_id ) {
    return $slug;
}, 10, 2 );

// Modifier les données des champs avant l'envoi
add_filter( 'immomakler_webflow_field_data', function( $fields, $post_id ) {
    return $fields;
}, 10, 2 );

Aperçu des paramètres

Label	Type	Par défaut	Description
Transférer automatiquement les biens vers Webflow	Interrupteur	false	Active l’export automatique vers Webflow
Publish Status	Sélection	staged	live = Published, staged = Queued to publish
Webflow API (V2) Token	Texte	–	Token API Webflow
Site	Sélection	–	Votre site Webflow
Biens immobiliers	Sélection	–	Collection pour les biens immobiliers
Personnes de contact	Sélection	–	Collection pour les personnes de contact
Types de biens	Sélection	–	Collection pour les types de biens (MultiReference)
Types de commercialisation	Sélection	–	Collection pour vente/location (Reference)
Types d’utilisation	Sélection	–	Collection pour les types d’utilisation (Reference)
Équipements	Sélection	–	Collection pour les équipements (MultiReference)
Statut	Sélection	–	Collection pour les statuts (MultiReference)
Localité	Sélection	–	Collection pour les localités (MultiReference)
Pays	Sélection	–	Collection pour les pays (Reference)

Questions fréquentes

Pour quelles licences WP-ImmoMakler l’intégration Webflow est-elle disponible ?

L’intégration Webflow est disponible dans toutes les licences WP-ImmoMakler (Basic, Plus et Premium).

De quoi ai-je besoin pour configurer l’intégration Webflow ?

Vous avez besoin d’un site Webflow avec une CMS Collection pour les biens immobiliers, ainsi que d’un token API V2 Webflow avec les autorisations CMS: Read and write et Sites: Read-only. Vous générez le token dans Webflow sous W-Logo → Site Settings → Apps & Intégrations → API access → Generate API token. Vous trouverez les détails de la configuration ci-dessus sous Configuration.

Dois-je assigner les champs manuellement, ou WP-ImmoMakler les reconnaît-il automatiquement ?

L’assignation s’effectue via le filtre PHP immomakler_webflow_field_matches dans le fichier functions.php de votre thème. WP-ImmoMakler génère automatiquement à cet effet, sur la page de paramètres (WP-ImmoMakler → Intégrations → Webflow), un modèle de code adapté avec toutes les clés post-meta disponibles, qu’il vous suffit de copier et d’assigner aux noms de champs Webflow.

Les images, les plans et les visites virtuelles sont-ils également transférés ?

Oui. Outre les champs de texte et numériques, l’intégration prend en charge des champs spéciaux prédéfinis : MAIN_IMAGE (image principale), IMAGES (toutes les images y compris les plans), IMAGES_NO_FLOORPLANS (photos uniquement), FLOORPLANS (plans uniquement), FIRST_VIDEO_URL, FIRST_VIRTUAL_TOUR_URL / FIRST_VIRTUAL_TOUR_IFRAME, ainsi que CONTACT_FORM_IFRAME pour le formulaire de contact WordPress intégré.

Que se passe-t-il avec les prix, les surfaces et les cases à cocher (par ex. « soumis à commission ») ?

Par défaut, les champs numériques sont transférés avec leur unité (par ex. « 350 000 EUR »). Le filtre immomakler_webflow_raw_post_meta_keys vous permet de définir quels champs doivent être transférés sous forme de valeur numérique pure sans unité (par ex. pour les filtres de prix ou de surface dans Webflow). Le filtre immomakler_webflow_boolean_post_meta_keys vous permet de déterminer quels champs doivent arriver sous forme de véritable valeur booléenne (true/false) plutôt que sous forme de texte.

Les types de biens, les équipements ou les localités sont-ils également transférés en tant qu’entrées liées ?

Oui. Outre la collection principale pour les biens immobiliers, vous pouvez assigner d’autres collections Webflow pour les personnes de contact, les types de biens, les types de commercialisation, les types d’utilisation, les équipements, le statut, la localité et le pays. C’est dans Webflow que vous décidez si un champ de votre collection de biens immobiliers est de type Reference ou MultiReference : WP-ImmoMakler transfère toutes les entrées d’un bien dans un champ MultiReference et exactement une dans un champ Reference. Si un bien a plusieurs entrées pour un champ Reference, par exemple les types de bien « Appartement » et « Appartement en étage » ou une localité et son quartier, le champ reçoit l’entrée la plus précise, c’est-à-dire « Appartement en étage » ou le quartier. Les indications entre parenthèses dans le tableau ci-dessus correspondent au choix habituel.

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

Il est également automatiquement supprimé de la collection Webflow assignée, à condition que l’export automatique soit actif et que le bien ait été préalablement transféré avec succès vers Webflow (reconnaissable à un ID d’élément Webflow enregistré).

Les modifications apportées à un bien sont-elles mises à jour automatiquement ?

Oui. Chaque publication ou mise à jour d’un bien dans WordPress déclenche automatiquement un transfert des données actuelles vers Webflow ; aucune action manuelle n’est nécessaire.

Puis-je contrôler si les nouveaux biens sont publiés directement ou vérifiés au préalable ?

Oui, via le paramètre Publish Status. Avec live, les biens sont immédiatement publiés dans Webflow (Published) ; avec staged, ils sont d’abord placés dans une file d’attente (Queued to publish) et doivent être validés manuellement dans Webflow.

J’ai modifié la structure de la collection dans Webflow — plus aucune donnée n’arrive maintenant. Pourquoi ?

Après une modification de la structure de la CMS Collection, le site Webflow doit d’abord être republié avant que les transferts depuis WP-ImmoMakler ne fonctionnent à nouveau. Il s’agit d’une particularité de l’API Webflow, et non d’une limitation de WP-ImmoMakler.

Où trouver les messages d’erreur en cas d’échec d’un transfert ?

WP-ImmoMakler consigne les transferts et suppressions échoués dans le journal du plugin (entre autres avec l’ID d’élément Webflow correspondant). Vérifiez-y d’abord s’il s’agit d’une erreur d’autorisation API (token/scopes), d’une structure de collection obsolète ou d’un mappage de champs manquant.

Puis-je encore personnaliser le comportement du transfert par code ?

Oui, en plus des paramètres, il existe les filtres PHP immomakler_webflow_property_slug (pour personnaliser le slug du bien dans Webflow) et immomakler_webflow_field_data (pour modifier les données des champs juste avant l’envoi).

---

Cela pourrait aussi vous intéresser

• Paramètres d’importation
• Hooks de filtres PHP
• Intégration Wohnungshelden
• Formulaire de contact