=== ImmoWP Estimation ===
Contributors: immowp, meerimmo
Tags: immobilier, estimation, formulaire, api, real estate
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Formulaire professionnel d'estimation immobiliere avec assistant multi-etapes, autocompletion d'adresse, integration API et notifications.

== Description ==

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

== Installation ==

= Installation basique =

1. Telechargez les fichiers du plugin dans `/wp-content/plugins/immowp-estimation/`, ou installez via l'ecran Extensions de WordPress
2. Activez le plugin via l'ecran 'Extensions' de WordPress
3. Un nouveau menu "Estimations" apparait dans la barre laterale de l'administration WordPress

= Configuration et utilisation =

**Etape 1 : Creer une page pour le formulaire**

1. Allez dans Pages > Ajouter
2. Donnez un titre a votre page (ex: "Estimation gratuite")
3. Dans le contenu de la page, ajoutez le shortcode : `[immowp_estimation_form]`
4. Publiez la page
5. Visitez la page pour verifier que le formulaire s'affiche correctement

**Etape 2 : Configurer les reglages du plugin (optionnel mais recommande)**

1. Dans le menu WordPress, cliquez sur "Estimations"
2. Cliquez sur le sous-menu "Reglages"
3. Configurez les options selon vos besoins :
   - **URL de l'API** : Entrez l'URL de base de l'API d'estimation. Vous pouvez utiliser l'API ImmoWP : `https://estimation.immowp.com` (beta)
   - **reCAPTCHA** : Activez et configurez vos cles pour proteger le formulaire du spam
   - **Emails** : Configurez les destinataires des notifications
   - **Message fallback** : Personnalisez le message affiche quand l'API n'est pas configuree

**Etape 3 : Tester le formulaire**

1. Visitez la page contenant le shortcode `[immowp_estimation_form]`
2. Remplissez le formulaire en 6 etapes :
   - Saisissez une adresse (l'autocompletion propose des suggestions)
   - Selectionnez le type de bien (maison/appartement)
   - Entrez la surface et autres details
   - Renseignez vos coordonnees
3. Soumettez le formulaire
4. Verifiez dans Estimations > Toutes les estimations que la demande a ete enregistree

= Configuration minimale pour tester =

Le plugin fonctionne immediatement apres activation, **sans configuration obligatoire** :

1. Activez le plugin
2. Creez une page avec le shortcode `[immowp_estimation_form]`
3. Testez le formulaire - les demandes sont enregistrees et visibles dans l'admin

= A propos de l'API d'estimation (optionnelle) =

**L'API externe est entierement optionnelle.** Le plugin a deux modes de fonctionnement :

1. **Mode fallback (par defaut, sans API)** : Le formulaire enregistre toutes les demandes dans WordPress. Apres soumission, un message indique a l'utilisateur qu'un conseiller le rappellera. Ce mode est parfait pour les agences qui souhaitent collecter des leads et rappeler les prospects manuellement.

2. **Mode API (avec URL configuree)** : Si vous disposez d'une API d'estimation immobiliere, vous pouvez la connecter dans Estimations > Reglages. Le plugin enverra les donnees du bien a votre API et affichera le prix estime a l'utilisateur. Vous pouvez utiliser l'API ImmoWP disponible a l'adresse `https://estimation.immowp.com` (actuellement en beta). Cette API exploite les donnees DVF (Demandes de Valeurs Foncieres) pour fournir des estimations basees sur les transactions reelles.

Pour tester le plugin, aucune API n'est necessaire - le mode fallback permet de verifier toutes les fonctionnalites : formulaire multi-etapes, autocompletion d'adresse, enregistrement des demandes, notifications email, tableau de bord admin, export CSV, etc.

== 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. Cependant, si vous souhaitez afficher une estimation de prix automatique, vous pouvez utiliser l'API ImmoWP (`https://estimation.immowp.com`, beta) dans Estimations > Reglages.

= 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

== Changelog ==

= 1.0.0 =
* Version initiale
* Formulaire multi-pages en 6 etapes
* Autocompletion d'adresse (API francaise)
* Integration API externe
* Mode de secours sans API
* Support Google reCAPTCHA v3
* Limitation de requetes par IP
* Notifications email (utilisateur + admin)
* Fonctionnalites admin avancees (filtres, recherche, export CSV)
* Meta box avec details en lecture seule et notes admin
* Optimisations de performance (cache, index)
* Conformite accessibilite WCAG AA

== Upgrade Notice ==

= 1.0.0 =
Version initiale publique.

== 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