Plugin Immo-Synchro

1Introduction & architecture

Le plugin Immo-Synchro connecte un site WordPress à l'écosystème Weeb Immo composé d'un backend Node.js et de l'API Whise. Il remplit trois missions principales :

Schéma d'architecture

┌─────────────────┐     Sync biens/agents       ┌────────────────────┐
│  WordPress      │ ←─────────────────────────── │  api.weeb.be/api   │
│  Plugin Immo    │                              │  (Backend Node.js) │
│                 │ ──── POST /formulaire ──────→ │                    │
└─────────────────┘     (contact visiteur)       └──────────┬─────────┘
        │                                                    │
        │ CPT : biens, wa_agent, wa_projets                  │ Whise API
        │ Tags & Widgets Elementor                           ↓
        ↓                                        ┌────────────────────┐
┌─────────────────┐                              │  api.whise.eu      │
│  Visiteur       │                              │  (CRM)             │
└─────────────────┘                              └────────────────────┘

2Configuration initiale

2.1 Installation

2.2 Page d'administration

La page d'administration est accessible via le menu latéral Synchronisation dans le tableau de bord WordPress.

2.3 Options disponibles

3Synchronisation des données

3.1 Biens immobiliers

La synchronisation des biens se fait en deux étapes pour éviter les timeouts HTTP :

Données importées par bien

Toutes les clés retournées par l'API sont sauvegardées comme métadonnées WordPress (préfixe wai_). Les taxonomies sont créées automatiquement :

3.2 Agents

Les agents sont extraits automatiquement depuis les données de biens (wai_representatives). Chaque agent est créé en CPT wa_agent avec sa photo importée dans la médiathèque WordPress.

L'import manuel est disponible via Agents → Importer dans le tableau de bord.

3.3 Projets

Les projets sont importés depuis GET https://api.weeb.be/api/projets/sync en CPT wa_projets. L'import manuel est disponible via Projets → Importer.

3.4 Automatisation (CRON externe)

Le plugin génère une URL secrète pour déclencher la synchronisation via un CRON externe (serveur, cPanel, etc.) :

# URL affichée dans l'admin si "Activer le cron" est coché
https://votre-site.com/wp-admin/admin-ajax.php?action=wa_cron_sync&secret=VOTRE_SECRET

# Exemple de cron Linux (tous les jours à 2h du matin)
0 2 * * * curl -s "https://votre-site.com/wp-admin/admin-ajax.php?action=wa_cron_sync&secret=XXXXX"

4Formulaires Elementor

Le plugin enregistre une action personnalisée "Envoyer au backend Immo" dans Elementor Pro Forms. Quand un visiteur soumet le formulaire, les données sont envoyées à https://api.weeb.be/api/formulaire qui les transmet ensuite à Whise CRM.

4.1 Activer l'action dans Elementor

4.2 Types de formulaires

4.3 Champs disponibles par type

Champs communs aux 3 types requis : firstname, lastname, email

Champs supplémentaires — estateForm

Champs supplémentaires — searchForm

Payload envoyé au backend

{
  "data": {
    "firstname": "Jean",
    "lastname":  "Dupont",
    "email":     "[email protected]",
    "phone":     "0470123456",
    "comment":   "Je suis intéressé par ce bien",
    "estateId":  "12345"           // estateForm uniquement
  },
  "meta": {
    "formType":    "estateForm",
    "Message":     "Demande de visite",
    "source":      "https://votre-site.com",
    "submittedAt": "2026-04-22T10:00:00+02:00"
  }
}

5Tags dynamiques Elementor

Le plugin enregistre plusieurs tags dynamiques utilisables dans n'importe quel widget Elementor qui accepte des données dynamiques.

Tags — Champs d'un bien (biens)

Groupe : Champ Meta personnalisé. Utiliser le tag Custom Meta et saisir la clé de métadonnée (ex: wai_prix, wai_surface, etc.).

Tags — Données d'un agent (wa_agent)

Groupe : Agent dans le panneau des tags dynamiques.

Shortcode multilingue

Pour afficher une métadonnée dans la langue courante du visiteur :

[wa_meta wai_description]

Fonctionne avec WPML, Polylang et le locale WordPress natif. Utilisable dans JetEngine via le filtre jet-engine/listings/allowed-shortcodes.

6Custom Post Types & Taxonomies

7Référence des clés wai_ — Biens immobiliers

Chaque bien synchronisé est stocké en WordPress avec ces métadonnées (post meta). Elles sont accessibles via le tag dynamique Custom Meta Elementor, le shortcode [wa_meta clé] ou directement en PHP avec get_post_meta($post_id, 'wai_xxx', true).

7.1 Identité & localisation

7.2 Descriptions multilingues

7.3 Surfaces

7.4 Informations générales

7.5 Proximité

7.6 Énergie & administratif

7.7 Médias & documents

7.8 Agents représentants

La méta wai_representatives contient un tableau JSON des agents assignés au bien. La méta wai_id_agent contient l'ID du premier agent (pour les queries simples).

8Débogage & logs

Fichier de log personnalisé

Le plugin écrit ses logs dans wp-content/custom-debug.log :

# Consulter les logs en temps réel (SSH)
tail -f /var/www/html/wp-content/custom-debug.log | grep "ImmoAction"

Préfixes des entrées de log

Erreurs fréquentes

9FAQ

Comment trouver le Custom ID d'un champ Elementor ?

Dans l'éditeur Elementor, cliquer sur le champ du formulaire → onglet Avancé → champ ID. C'est cet identifiant qui doit être saisi dans les options de mapping.

Peut-on utiliser plusieurs formulaires du même type sur le site ?

Oui. Chaque formulaire configure son propre mapping indépendamment. Deux formulaires de type estateForm peuvent avoir des configurations de mapping différentes.

Comment obtenir la clé API ?

La clé API est générée dans le dashboard d'administration backend (api.weeb.be). Il existe deux types de clés :

• FORM_KEY — Clé globale partagée entre toutes les agences
• api_key agence — Clé spécifique à une agence (les contacts sont automatiquement associés à cette agence dans Whise)

La synchronisation prend-elle en compte les biens supprimés de Whise ?

Non actuellement. Le plugin importe et met à jour les biens, mais ne supprime pas les biens qui ont été retirés de Whise. Pour supprimer tous les biens WordPress, utiliser le bouton "Supprimer tous les biens" puis relancer une synchronisation complète.

Que se passe-t-il si le backend est indisponible lors d'une soumission de formulaire ?

Le plugin retourne une erreur et log le message dans custom-debug.log. Elementor affiche le message d'erreur personnalisé au visiteur. Aucune donnée n'est perdue côté WordPress.

Comment tester que la clé API est correcte ?

# Test CURL depuis terminal
curl -X POST https://api.weeb.be/api/formulaire \
  -H "Content-Type: application/json" \
  -H "x-api-key: VOTRE_CLE" \
  -d '{"data":{"firstname":"Test","lastname":"Test","email":"[email protected]"},"meta":{"formType":"contactForm"}}'