內容簡介
總結：
ImmoWP Estimation 是一個完整的 WordPress 外掛，提供專業多步驟表單，用於估計房地產價值。適用於房地產代理、房地產管理公司和獨立代理。
問題與答案：
1. 是否需要外部 API？
- 不需要！該外掛具有“備用模式”，即使沒有 API 也能運作。在此模式下，提交將被保存，您將收到一封電子郵件通知以聯絡用戶。
2. 是否可以自訂確認消息？
- 是的！進入“Estimations > 設定”，然後在“高級設置”部分，您可以自訂為用戶顯示的“備用模式消息”，當 API 未設置時。
3. 如何設置 reCAPTCHA？
- 獲取 reCAPTCHA v3 金鑰在 https://www.google.com/recaptcha/admin
- 在 WordPress 中，進入“Estimations > 設定”
- 在“Google reCAPTCHA v3”部分，勾選“啟用 reCAPTCHA v3 驗證”
- 輸入您的 Site Key 和 Secret Key
- 如果需要，調整分數閾值（默認為 0.5）
- 點擊“保存設置”
4. 是否可以匯出估算請求？
- 是的！進入 Estimations 頁面admin，點擊“匯出 CSV”。匯出將符合您當前的篩選條件。
5. 表單能在行動裝置上適用嗎？
- 是的！該表單完全響應式，在所有設備上均能完美運行。
6. 是否可以翻譯這個外掛？
- 是的！該外掛準備好進行翻譯，使用 immowp-estimation 文本域。使用 Loco Translate 或類似工具。
7. 在哪裡可以找到外掛的設定？
- 主選單“Estimations”將出現在 WordPress 管理員側邊欄中。
外掛標籤
開發者團隊
原文外掛簡介
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
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
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
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 ?
Obtenez vos cles reCAPTCHA v3 sur https://www.google.com/recaptcha/admin
Dans WordPress, allez dans Estimations > Reglages
Dans la section “Google reCAPTCHA v3”, cochez “Activer la verification reCAPTCHA v3”
Entrez votre Site Key et Secret Key
Ajustez le seuil de score si necessaire (defaut 0.5)
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 :
Installer et activer : Telechargez et activez le plugin
Verifier le menu : Le menu “Estimations” apparait dans la barre laterale admin
Creer une page de test :
Allez dans Pages > Ajouter
Titre : “Test Estimation”
Contenu : [immowp_estimation_form]
Publiez la page
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
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
Formulaire d’estimation moderne en 6 etapes avec barre de progression
Autocompletion d’adresse avec integration API francaise
Collecte des details du bien
Tableau de bord admin avec filtres et recherche
Page de reglages avec toutes les options de configuration
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
