Documentation · Guide du Frontend
Calculateur de financement
Ce document traite du widget de calculateur de financement de l'extension ADP Car Market Hub WordPress : son emplacement, son fonctionnement pour les visiteurs, sa configuration et ses limites.
Quand utiliser ce document
Lisez ce document si vous activez le calculateur de financement pour la première fois, si vous ajustez ses valeurs par défaut ou si vous aidez un visiteur à comprendre ce que le calculateur affiche.
Aperçu
Le calculateur de financement est un widget interactif affiché sur les pages de détails individuelles des véhicules. Il permet aux visiteurs d'estimer une mensualité de prêt en fonction du prix du véhicule, d'un pourcentage d'apport personnel, d'une durée de prêt et d'un taux d'intérêt annuel.
Tous les champs sont ajustables par le visiteur. Le calculateur met à jour instantanément la mensualité estimée au fur et à mesure que les valeurs changent, sans rechargement de page ni requête serveur. Le calcul est effectué entièrement dans le navigateur à l'aide d'une formule d'annuité standard.
Le calculateur est uniquement destiné à des fins d'estimation. Le résultat est clairement étiqueté comme une estimation, et le widget inclut une clause de non-responsabilité rappelant aux visiteurs de consulter leur banque ou leur institution financière pour obtenir les conditions de financement réelles.
Configuration requise ou prérequis
- Le calculateur de financement doit être activé dans les réglages de l'extension (
FINANCING_ENABLED). Il est désactivé par défaut. - La page de détails du véhicule doit présenter un prix de véhicule supérieur à zéro. Le calculateur ne s'affiche pas si le prix du véhicule est nul ou manquant.
Instructions étape par étape
Activer le calculateur de financement
- Dans l'administration WordPress, ouvrez les réglages de l'extension.
- Accédez à la section de configuration Calculateur de financement.
- Activez le commutateur principal.
- Ajustez éventuellement le taux d'intérêt par défaut, la durée du prêt et le pourcentage d'apport personnel.
- Enregistrez les réglages.
Le calculateur apparaîtra sur toutes les pages de détails des véhicules pour lesquels un prix est renseigné.
Visiteur : utiliser le calculateur de financement
- Ouvrez une page de détails de véhicule.
- Faites défiler jusqu'à la section Calculateur de financement.
- Le calculateur affiche le prix du véhicule et des valeurs par défaut pré-remplies pour les trois champs ajustables.
- Déplacez le curseur Apport personnel pour ajuster le pourcentage du prix du véhicule payé au départ. L'étiquette au-dessus du curseur indique le pourcentage actuel.
- Sélectionnez la Durée du prêt dans le menu déroulant. Les options disponibles sont 12, 24, 36, 48, 60, 72 et 84 mois.
- Modifiez le champ Taux d'intérêt annuel. Il accepte des valeurs de 0 % à 30 % par incréments de 0,1 %.
- La Mensualité estimée se met à jour immédiatement dès qu'une valeur change.
- Un résumé sous la mensualité indique le montant du prêt, le coût total et le total des intérêts.
- La clause de non-responsabilité en bas rappelle au visiteur que le résultat n'est qu'une estimation.
Référence de configuration
Réglages du calculateur
| Réglage | Clé d'option | Par défaut | Description |
|---|---|---|---|
| Activer le calculateur | as24ci_financing_enabled | Désactivé (0) | Commutateur principal pour la fonctionnalité de calculateur de financement |
| Taux d'intérêt par défaut | as24ci_financing_default_rate | 3.9 | Taux d'intérêt annuel pré-rempli en pourcentage |
| Durée du prêt par défaut | as24ci_financing_default_months | 48 | Durée du prêt pré-sélectionnée en mois |
| Apport personnel par défaut | as24ci_financing_down_payment | 20 | Apport personnel pré-rempli en pourcentage du prix du véhicule |
Saisies ajustables par le visiteur
| Saisie | Type | Plage | Description |
|---|---|---|---|
| Apport personnel | Curseur de défilement | 0 % – 100 % | Pourcentage du prix du véhicule payé comme apport personnel |
| Durée du prêt | Menu déroulant | 12 / 24 / 36 / 48 / 60 / 72 / 84 mois | Durée du prêt |
| Taux d'intérêt | Saisie numérique | 0 % – 30 % | Taux d'intérêt annuel en pourcentage |
Sortie du calculateur
Le widget affiche :
| Sortie | Description |
|---|---|
| Mensualité estimée | Mensualité calculée à l'aide de la formule d'annuité |
| Montant du prêt | Prix du véhicule moins le montant de l'apport personnel |
| Coût total | Montant du prêt plus le total des intérêts payés sur la durée du prêt |
| Total des intérêts | Différence entre le coût total et le montant du prêt |
Toutes les valeurs monétaires sont formatées en utilisant la devise du véhicule et la locale du site.
Emplacement de la mise en page
L'emplacement du calculateur de financement sur la page de véhicule unique est contrôlé par le Référence du gestionnaire de mise en page. Lorsque la fonctionnalité est activée, le bloc du calculateur est disponible dans la barre latérale du véhicule unique et peut également être placé dans la zone de contenu principal ou la section inférieure via le Référence du gestionnaire de mise en page. Si le même bloc est placé dans plusieurs zones, seule la première instance applicable est affichée.
Notes opérationnelles
- Le calcul de l'annuité est effectué entièrement en JavaScript (
as24ci-financing.js). Le serveur fournit uniquement les données initiales (prix du véhicule, devise, réglages par défaut) via un objet de script localisé (as24ciFinancing). Aucune autre requête serveur n'est effectuée lorsque le visiteur ajuste le calculateur. - Le calculateur ne s'affiche que lorsque le prix du véhicule est supérieur à zéro. Si un véhicule n'a pas de prix, le widget est omis silencieusement même si la fonctionnalité est activée et que le bloc est présent dans le Référence du gestionnaire de mise en page.
- Les fichiers JavaScript et CSS pour le calculateur ne sont chargés que sur les pages de véhicule unique (
is_singular), pas sur les pages d'archive ou autres. - Le widget utilise les propriétés personnalisées CSS du système de design de l'extension (couleur principale, rayon de bordure, arrière-plan, couleurs de texte) afin d'hériter automatiquement des couleurs de thème configurées.
- Le texte de la clause de non-responsabilité (« This is an estimate only. Actual rates may vary. Please consult your bank or financial institution for exact terms. ») est codé en dur dans le modèle et n'est pas configurable depuis les réglages d'administration.
- Le calculateur de financement ne soumet aucune donnée au serveur, ne crée aucun lead et ne contacte aucun service de financement externe.
Dépannage
Le calculateur de financement n'apparaît pas sur une page de détails de véhicule.
- Confirmez que la fonctionnalité est activée dans les réglages de l'extension.
- Vérifiez que le véhicule a un prix supérieur à zéro.
- Confirmez que le bloc du calculateur de financement est actif dans le Référence du gestionnaire de mise en page pour la page de véhicule unique.
- Vérifiez la console du navigateur pour détecter d'éventuelles erreurs JavaScript.
La mensualité affiche un tiret (—) et ne se met pas à jour.
- Le calculateur nécessite JavaScript pour fonctionner. Vérifiez que JavaScript n'est pas bloqué dans le navigateur.
- Recherchez d'éventuels conflits de scripts provenant d'autres extensions qui pourraient interférer avec les écouteurs d'événements du calculateur.
Les valeurs du calculateur ne reflètent pas la devise ou la locale du site.
- La devise et la locale sont transmises au JavaScript lors du chargement de la page, sur la base de la devise enregistrée du véhicule et de la locale du site WordPress. La modification de ces réglages nécessite de vider le cache de la page.