Aller au contenu

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.

  • 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
  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 ...
    ];
    } );

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 à 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' ];
} );

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

// 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 );
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)
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).