Documentatie · Frontend-handleiding
Financieringscalculator
Dit document behandelt de financieringscalculator-widget van de ADP Car Market Hub WordPress Plugin: waar deze verschijnt, hoe deze werkt voor bezoekers, hoe deze wordt geconfigureerd en wat de beperkingen ervan zijn.
Wanneer u dit document moet gebruiken
Lees dit document als u de financieringscalculator voor de eerste keer inschakelt, de standaardwaarden aanpast of een bezoeker helpt te begrijpen wat de calculator laat zien.
Overzicht
De financieringscalculator is een interactieve widget die wordt weergegeven op individuele voertuigdetailpagina's. Hiermee kunnen bezoekers een geschatte maandelijkse leningbetaling berekenen op basis van de voertuigprijs, een aanbetalingspercentage, een looptijd van de lening en een jaarlijkse rentevoet.
Alle velden zijn door de bezoeker aan te passen. De calculator werkt de geschatte maandelijkse betaling direct bij wanneer waarden veranderen, zonder dat de pagina opnieuw hoeft te worden geladen of er een serververzoek nodig is. De berekening wordt volledig in de browser uitgevoerd met behulp van een standaard annuïteitenformule.
De calculator is uitsluitend bedoeld voor schattingen. Het resultaat is duidelijk gelabeld als een schatting en de widget bevat een disclaimer die bezoekers eraan herinnert hun bank of financiële instelling te raadplegen voor de werkelijke financieringsvoorwaarden.
Systeemvereisten of randvoorwaarden
- De financieringscalculator moet zijn ingeschakeld in de plugin-instellingen (
FINANCING_ENABLED). Deze is standaard uitgeschakeld. - De voertuigdetailpagina moet een voertuigprijs hebben die groter is dan nul. De calculator wordt niet weergegeven als de voertuigprijs nul is of ontbreekt.
Stapsgewijze instructies
De financieringscalculator inschakelen
- Open de plugin-instellingen in de WordPress-beheeromgeving.
- Navigeer naar de configuratiesectie Financieringscalculator.
- Schakel de hoofdschakelaar in.
- Pas optioneel de standaardrentevoet, de looptijd van de lening en het aanbetalingspercentage aan.
- Sla de instellingen op.
De calculator verschijnt nu op alle voertuigdetailpagina's waar het voertuig een prijs heeft.
Bezoeker: de financieringscalculator gebruiken
- Open een voertuigdetailpagina.
- Scrol naar de sectie Financieringscalculator.
- De calculator toont de voertuigprijs en vooraf ingevulde standaardwaarden voor de drie aanpasbare invoervelden.
- Versleep de schuifregelaar Aanbetaling om het percentage van de vooraf te betalen voertuigprijs aan te passen. Het label boven de schuifregelaar toont het huidige percentage.
- Selecteer de Looptijd lening in het dropdownmenu. De beschikbare opties zijn 12, 24, 36, 48, 60, 72 en 84 maanden.
- Bewerk het veld Jaarlijkse rentevoet. Dit veld accepteert waarden van 0% tot 30% in stappen van 0,1%.
- De Geschatte maandelijkse betaling wordt onmiddellijk bijgewerkt zodra een waarde verandert.
- Een samenvatting onder de betaling toont het leenbedrag, de totale kosten en de totale rente.
- De disclaimer onderaan herinnert de bezoeker eraan dat het resultaat slechts een schatting is.
Configuratiereferentie
Calculatorinstellingen
| Instelling | Optiesleutel | Standaard | Beschrijving |
|---|---|---|---|
| Calculator inschakelen | as24ci_financing_enabled | Uit (0) | Hoofdschakelaar voor de financieringscalculator-functie |
| Standaardrentevoet | as24ci_financing_default_rate | 3.9 | Vooraf ingevulde jaarlijkse rentevoet in procenten |
| Standaard looptijd lening | as24ci_financing_default_months | 48 | Vooraf geselecteerde looptijd van de lening in maanden |
| Standaard aanbetaling | as24ci_financing_down_payment | 20 | Vooraf ingevulde aanbetaling als percentage van de voertuigprijs |
Door bezoeker aan te passen invoer
| Invoer | Type | Bereik | Beschrijving |
|---|---|---|---|
| Aanbetaling | Schuifregelaar | 0% – 100% | Percentage van de voertuigprijs dat als aanbetaling wordt betaald |
| Looptijd lening | Dropdown | 12 / 24 / 36 / 48 / 60 / 72 / 84 maanden | Duur van de lening |
| Rentevoet | Cijferinvoer | 0% – 30% | Jaarlijkse rentevoet in procenten |
Calculator-output
De widget toont:
| Output | Beschrijving |
|---|---|
| Geschatte maandelijkse betaling | Maandelijkse betaling berekend met de annuïteitenformule |
| Leenbedrag | Voertuigprijs minus aanbetalingsbedrag |
| Totale kosten | Leenbedrag plus totale betaalde rente over de looptijd van de lening |
| Totale rente | Verschil tussen totale kosten en leenbedrag |
Alle monetaire waarden worden opgemaakt met de valuta van het voertuig en de taalinstelling van de site.
Lay-outplaatsing
De plaatsing van de financieringscalculator op de pagina van een afzonderlijk voertuig wordt beheerd door de Layout Manager. Wanneer de functie is ingeschakeld, is het calculatorblok beschikbaar in de zijbalk van het afzonderlijke voertuig en kan het ook in het hoofdinhoudsgebied of de onderste sectie worden geplaatst via de Layout Manager. Als hetzelfde blok in meerdere zones wordt geplaatst, wordt alleen de eerste toepasselijke instantie weergegeven.
Operationele opmerkingen
- De annuïteitenberekening wordt volledig in JavaScript (
as24ci-financing.js) uitgevoerd. De server levert alleen de initiële gegevens (voertuigprijs, valuta, standaardinstellingen) via een gelokaliseerd scriptobject (as24ciFinancing). Er worden geen verdere serververzoeken gedaan wanneer de bezoeker de calculator aanpast. - De calculator wordt alleen weergegeven als de voertuigprijs groter is dan nul. Als een voertuig geen prijs heeft, wordt de widget stilletjes weggelaten, zelfs als de functie is ingeschakeld en het blok in de Layout Manager staat.
- De JavaScript- en CSS-bestanden voor de calculator worden alleen geladen op pagina's van afzonderlijke voertuigen (
is_singular), niet op de archief- of andere pagina's. - De widget maakt gebruik van CSS custom properties uit het ontwerpsysteem van de plugin (primaire kleur, randradius, achtergrond, tekstkleuren), zodat deze automatisch de geconfigureerde themakleuren overneemt.
- De disclaimertekst ("Dit is uitsluitend een schatting. De werkelijke tarieven kunnen variëren. Raadpleeg uw bank of financiële instelling voor de exacte voorwaarden.") is hardgecodeerd in de template en kan niet worden geconfigureerd via de beheerinstellingen.
- De financieringscalculator verzendt geen gegevens naar de server, maakt geen leads aan en neemt geen contact op met externe financieringsdiensten.
Problemen oplossen
De financieringscalculator verschijnt niet op een voertuigdetailpagina.
- Controleer of de functie is ingeschakeld in de plugin-instellingen.
- Controleer of het voertuig een prijs heeft die groter is dan nul.
- Controleer of het financieringscalculatorblok actief is in de Layout Manager voor de pagina van het afzonderlijke voertuig.
- Controleer de browserconsole op JavaScript-fouten.
De maandelijkse betaling toont een streepje (—) en wordt niet bijgewerkt.
- De calculator heeft JavaScript nodig om te functioneren. Controleer of JavaScript niet is geblokkeerd in de browser.
- Controleer op conflicterende scripts van andere plugins die de event listeners van de calculator kunnen verstoren.
De calculatorwaarden komen niet overeen met de valuta of taalinstelling van de site.
- De valuta en taalinstelling worden aan de JavaScript doorgegeven wanneer de pagina wordt geladen, op basis van de opgeslagen valuta van het voertuig en de WordPress-taalinstelling van de site. Het wijzigen van deze instellingen vereist het wissen van de paginacache.