Webflow

WP-ImmoMakler peut transferer automatiquement les donnees immobilieres dans une Webflow CMS Collection. Chaque bien nouveau ou mis a jour est directement transmis a Webflow. Lorsqu’un bien est supprime dans WordPress, il est egalement supprime dans Webflow.

Prerequis

• 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. Generer un token API

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

2. Configurer Webflow dans WP-ImmoMakler

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

1. Saisissez le token API et enregistrez.
2. Selectionnez votre site Webflow.
3. Assignez la CMS Collection pour les biens immobiliers et enregistrez a 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 etre assignes aux cles post-meta WordPress. WP-ImmoMakler affiche sur la page de parametres un modele de code genere automatiquement. Copiez ce code PHP dans le fichier functions.php de votre theme :

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

Champs speciaux predefinis

Les mots-cles suivants peuvent etre utilises comme valeur dans l’assignation immomakler_webflow_field_matches et ont une fonction speciale :

Cle	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 premiere video integree
FIRST_VIRTUAL_TOUR_URL	Link	URL de la premiere visite virtuelle
FIRST_VIRTUAL_TOUR_IFRAME	Rich text	Premiere visite virtuelle en iFrame
CONTACT_FORM_IFRAME	Rich text	Formulaire de contact WordPress en iFrame

Champs booleens et valeurs brutes

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

// Champs sans unite (par ex. valeur numerique 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 publies (Published) ou places 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 etre republie avant que les transferts ne fonctionnent a 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 donnees des champs avant l'envoi
add_filter( 'immomakler_webflow_field_data', function( $fields, $post_id ) {
    return $fields;
}, 10, 2 );

Apercu des parametres

Label	Type	Par defaut	Description
Transférer automatiquement les biens vers Webflow	Interrupteur	false	Active l’export automatique vers Webflow
Publish Status	Selection	staged	live = Published, staged = Queued to publish
Webflow API (V2) Token	Texte	–	Token API Webflow
Site	Selection	–	Votre site Webflow
Biens immobiliers	Selection	–	Collection pour les biens immobiliers
Personnes de contact	Selection	–	Collection pour les personnes de contact
Types de biens	Selection	–	Collection pour les types de biens (MultiReference)
Types de commercialisation	Selection	–	Collection pour vente/location (Reference)
Types d’utilisation	Selection	–	Collection pour les types d’utilisation (Reference)
Équipements	Selection	–	Collection pour les equipements (MultiReference)
Statut	Selection	–	Collection pour les statuts (MultiReference)
Localité	Selection	–	Collection pour les localites (MultiReference)
Pays	Selection	–	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 & Integrations → 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 → Paramètres → 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. Les valeurs multiples telles que le type de bien ou les équipements sont transférées sous forme de champ Webflow MultiReference, tandis que les valeurs uniques telles que le type de commercialisation sont transférées sous forme de champ Reference.

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