ImmoWP Estimation

ImmoWP Estimation est un plugin WordPress complet qui fournit un formulaire professionnel multi-etapes pour l’estimation de biens immobiliers. Parfait pour les agences immobilieres, les societes de gestion immobiliere et les agents independants.

Fonctionnalites principales

• Formulaire interactif en 6 etapes – Assistant multi-pages convivial avec barre de progression
• Autocompletion d’adresse – Integration avec l’API gouvernementale francaise (api-adresse.data.gouv.fr)
• Support API externe – Connectez votre propre API d’estimation
• Mode de secours – Fonctionne meme sans configuration API
• Securite :
  • Integration Google reCAPTCHA v3
  • Limitation de requetes par IP
  • Verification de nonce
  • Validation et assainissement des entrees
• Notifications par email – Emails automatiques aux utilisateurs et administrateurs
• Administration :
  • Tableau de bord detaille des estimations
  • Filtres avances (statut, type de bien)
  • Recherche etendue
  • Export CSV
  • Meta box en lecture seule avec notes admin
• Performance optimisee :
  • Mise en cache de l’API d’adresses
  • Index de base de donnees
  • Chargement conditionnel des assets
• Accessibilite – Attributs ARIA et conformite WCAG AA

Fonctionnement

1. L’utilisateur remplit le formulaire en 6 etapes :

   • Selection de l’adresse avec autocompletion
   • Type de bien (maison/appartement)
   • Surface habitable et terrain
   • Nombre de pieces
   • Etat du bien
   • Coordonnees

2. La soumission declenche :

   • Appel API pour l’estimation (si configure)
   • OU message de secours pour rappel
   • Notifications email a l’utilisateur et l’admin
   • Stockage des donnees dans WordPress

3. Les administrateurs peuvent :

   • Voir toutes les demandes d’estimation
   • Filtrer et rechercher les soumissions
   • Exporter les donnees en CSV
   • Ajouter des notes internes

Shortcode

Ajoutez simplement [immowp_estimation_form] a n’importe quelle page ou article.

Integration API

Le plugin peut se connecter a n’importe quel point de terminaison API REST qui accepte les donnees du bien et retourne les valeurs d’estimation. Voir la documentation pour les specifications API.

Confidentialite & RGPD

• Les donnees utilisateur sont stockees localement dans votre base WordPress
• Aucune donnee n’est envoyee a des tiers (sauf votre API configuree)
• Les administrateurs peuvent supprimer les soumissions a tout moment

Foire Aux Questions

Ai-je besoin d’une API externe ?

Non ! Le plugin fonctionne en “mode de secours” sans API. Dans ce mode, les soumissions sont enregistrees et vous recevez une notification par email pour contacter l’utilisateur.

Puis-je personnaliser le message de confirmation ?

Oui ! Allez dans Estimations > Reglages, puis dans la section “Parametres avances”, vous pouvez personnaliser le “Message en mode fallback” affiche aux utilisateurs quand l’API n’est pas configuree.

Comment configurer reCAPTCHA ?

1. Obtenez vos cles reCAPTCHA v3 sur https://www.google.com/recaptcha/admin
2. Dans WordPress, allez dans Estimations > Reglages
3. Dans la section “Google reCAPTCHA v3”, cochez “Activer la verification reCAPTCHA v3”
4. Entrez votre Site Key et Secret Key
5. Ajustez le seuil de score si necessaire (defaut 0.5)
6. Cliquez sur “Enregistrer les parametres”

Puis-je exporter les demandes d’estimation ?

Oui ! Allez sur la page admin Estimations et cliquez sur “Exporter CSV”. L’export respecte vos filtres actuels.

Le formulaire est-il adapte au mobile ?

Oui ! Le formulaire est entierement responsive et fonctionne parfaitement sur tous les appareils.

Puis-je traduire le plugin ?

Oui ! Le plugin est pret pour la traduction avec le domaine de texte immowp-estimation. Utilisez Loco Translate ou des outils similaires.

Ou trouver les reglages du plugin ?

Le menu principal “Estimations” apparait dans la barre laterale de l’administration WordPress apres activation du plugin. Les reglages se trouvent dans : Estimations > Reglages.

Testing

Test rapide du plugin

Pour tester rapidement le plugin sur une installation WordPress fraiche :

1. Installer et activer : Telechargez et activez le plugin
2. Verifier le menu : Le menu “Estimations” apparait dans la barre laterale admin
3. Creer une page de test :
   • Allez dans Pages > Ajouter
   • Titre : “Test Estimation”
   • Contenu : [immowp_estimation_form]
   • Publiez la page
4. Tester le formulaire :
   • Visitez la page publiee
   • Le formulaire d’estimation en 6 etapes s’affiche
   • Etape 1 : Tapez “Paris” dans le champ adresse – des suggestions apparaissent
   • Selectionnez une adresse dans la liste
   • Continuez a travers les 6 etapes (type, surface, pieces, etat, contact)
   • Soumettez le formulaire
5. Verifier l’enregistrement :
   • Allez dans Estimations > Toutes les estimations
   • La demande soumise apparait dans la liste
   • Cliquez dessus pour voir les details complets

Fonctionnalites a tester

• Autocompletion d’adresse : Tapez au moins 3 caracteres pour voir les suggestions
• Navigation multi-etapes : Utilisez les boutons Precedent/Suivant
• Validation des champs : Essayez de soumettre avec des champs vides
• Responsive : Testez sur mobile et desktop
• Admin : Filtrez par statut, recherchez par email, exportez en CSV
• Mode fallback : Sans API configuree, un message de rappel s’affiche

Captures d’ecran

1. Formulaire d’estimation moderne en 6 etapes avec barre de progression
2. Autocompletion d’adresse avec integration API francaise
3. Collecte des details du bien
4. Tableau de bord admin avec filtres et recherche
5. Page de reglages avec toutes les options de configuration
6. Meta box des details d’estimation avec informations en lecture seule

Documentation API

Format de requete

Votre API doit accepter des requetes POST a {base_url}/api/estimate avec la structure JSON suivante :

{
  "codeCommune": "75001",
  "surfaceHabitable": 75,
  "typeLocal": "appartement",
  "codePostal": "75001",
  "surfaceTerrain": 0,
  "voie": "Rue de Rivoli",
  "numeroVoie": "10"
}

Reponse attendue

{
  "estimatedPrice": 450000,
  "estimatedPriceMin": 420000,
  "estimatedPriceMax": 480000,
  "confidence": "high",
  "status": "success"
}

Voir la documentation complete sur https://immowp.com/docs/api

Support

Pour le support, les demandes de fonctionnalites ou les rapports de bugs, veuillez utiliser les forums de support WordPress.org.

External Services

This plugin connects to external third-party services to provide its functionality. Below is detailed information about each service:

French National Address API (Base Adresse Nationale)

This plugin uses the French government’s address API to provide address autocomplete functionality in the estimation form.

• What it does: Provides address suggestions when users type in the address field
• Data sent: The text entered by the user in the address search field
• When data is sent: Each time the user types at least 3 characters in the address field
• Service provider: French government (Etalab/DINUM)
• Service URL: https://api-adresse.data.gouv.fr/search/
• Terms of service: https://adresse.data.gouv.fr/cgu
• Privacy policy: https://adresse.data.gouv.fr/donnees-personnelles

Google reCAPTCHA v3 (Optional)

If enabled in the plugin settings, this plugin uses Google reCAPTCHA v3 to protect the form against spam and automated submissions.

• What it does: Validates that form submissions come from real users, not bots
• Data sent: User’s IP address, reCAPTCHA token, and browser information
• When data is sent: When the user submits the estimation form (if reCAPTCHA is enabled)
• Service provider: Google LLC
• Service URL: https://www.google.com/recaptcha/api/siteverify
• Terms of service: https://policies.google.com/terms
• Privacy policy: https://policies.google.com/privacy

Your Configured Estimation API (Optional)

If you configure an external estimation API in the plugin settings, the plugin will send property data to calculate real estate valuations.

• What it does: Calculates property estimation based on submitted data
• Data sent: Property details (address, type, surface area, number of rooms, condition)
• When data is sent: When the user submits a complete estimation form
• Service provider: Configured by you in plugin settings
• Terms and privacy: Depends on your configured API provider