Documentazione · Guida del frontend
Calcolatore di finanziamento
Questo documento copre il widget del calcolatore di finanziamento del plugin ADP Car Market Hub WordPress: dove appare, come funziona per i visitatori, come viene configurato e quali sono i suoi limiti.
Quando utilizzare questo documento
Leggi questo documento se stai abilitando il calcolatore di finanziamento per la prima volta, se stai modificando i suoi valori predefiniti o se stai aiutando un visitatore a capire cosa mostra il calcolatore.
Panoramica
Il calcolatore di finanziamento è un widget interattivo visualizzato sulle singole pagine di dettaglio del veicolo. Consente ai visitatori di stimare una rata mensile del prestito in base al prezzo del veicolo, a una percentuale di acconto, alla durata del prestito e a un tasso di interesse annuo.
Tutti i campi sono regolabili dal visitatore. Il calcolatore aggiorna istantaneamente la rata mensile stimata al variare dei valori, senza ricaricare la pagina o effettuare richieste al server. Il calcolo viene eseguito interamente nel browser utilizzando una formula di ammortamento standard (ammortamento alla francese).
Il calcolatore ha solo uno scopo di stima. Il risultato è chiaramente etichettato come stima e il widget include una clausola di esclusione della responsabilità (disclaimer) che ricorda ai visitatori di consultare la propria banca o istituto finanziario per i termini di finanziamento effettivi.
Requisiti o prerequisiti
- Il calcolatore di finanziamento deve essere abilitato nelle impostazioni del plugin (
FINANCING_ENABLED). È disabilitato per impostazione predefinita. - La pagina di dettaglio del veicolo deve avere un prezzo del veicolo superiore a zero. Il calcolatore non viene visualizzato se il prezzo del veicolo è pari a zero o mancante.
Istruzioni passo-passo
Abilitare il calcolatore di finanziamento
- Nell'amministrazione di WordPress, apri le impostazioni del plugin.
- Naviga fino alla sezione di configurazione Calcolatore di finanziamento.
- Abilita l'interruttore principale.
- Facoltativamente, regola il tasso di interesse predefinito, la durata del prestito e la percentuale di acconto.
- Salva le impostazioni.
Il calcolatore apparirà su tutte le pagine di dettaglio del veicolo in cui il veicolo ha un prezzo.
Visitatore: utilizzare il calcolatore di finanziamento
- Apri una pagina di dettaglio del veicolo.
- Scorri fino alla sezione Calcolatore di finanziamento.
- Il calcolatore mostra il prezzo del veicolo e i valori predefiniti precompilati per i tre campi regolabili.
- Sposta lo slider dell'Acconto per regolare la percentuale del prezzo del veicolo pagata in anticipo. L'etichetta sopra lo slider mostra la percentuale corrente.
- Seleziona la Durata del prestito dal menu a discesa. Le opzioni disponibili sono 12, 24, 36, 48, 60, 72 e 84 mesi.
- Modifica il campo Tasso di interesse annuo. Accetta valori da 0% a 30% con incrementi dello 0,1%.
- La Rata mensile stimata si aggiorna immediatamente al variare di qualsiasi valore.
- Un riepilogo sotto la rata mostra l'importo del prestito, il costo totale e gli interessi totali.
- Il disclaimer in fondo ricorda al visitatore che il risultato è solo una stima.
Riferimento di configurazione
Impostazioni del calcolatore
| Impostazione | Chiave opzione | Predefinito | Descrizione |
|---|---|---|---|
| Abilita calcolatore | as24ci_financing_enabled | Disattivato (0) | Interruttore principale per la funzionalità del calcolatore di finanziamento |
| Tasso di interesse predefinito | as24ci_financing_default_rate | 3.9 | Tasso di interesse annuo precompilato in percentuale |
| Durata del prestito predefinita | as24ci_financing_default_months | 48 | Durata del prestito preselezionata in mesi |
| Acconto predefinito | as24ci_financing_down_payment | 20 | Acconto precompilato come percentuale del prezzo del veicolo |
Input regolabili dal visitatore
| Input | Tipo | Intervallo | Descrizione |
|---|---|---|---|
| Acconto | Slider di intervallo | 0% – 100% | Percentuale del prezzo del veicolo pagata come acconto |
| Durata del prestito | Menu a discesa | 12 / 24 / 36 / 48 / 60 / 72 / 84 mesi | Durata del prestito |
| Tasso di interesse | Input numerico | 0% – 30% | Tasso di interesse annuo in percentuale |
Output del calcolatore
Il widget mostra:
| Output | Descrizione |
|---|---|
| Rata mensile stimata | Rata mensile calcolata utilizzando la formula di ammortamento |
| Importo del prestito | Prezzo del veicolo meno l'importo dell'acconto |
| Costo totale | Importo del prestito più gli interessi totali pagati durante la durata del prestito |
| Interessi totali | Differenza tra il costo totale e l'importo del prestito |
Tutti i valori monetari sono formattati utilizzando la valuta del veicolo e la localizzazione del sito.
Posizionamento del layout
Il posizionamento del calcolatore di finanziamento nella pagina del singolo veicolo è controllato dal Layout Manager. Quando la funzionalità è abilitata, il blocco del calcolatore è disponibile nella barra laterale del singolo veicolo e può anche essere posizionato nell'area del contenuto principale o nella sezione inferiore tramite il Layout Manager. Se lo stesso blocco viene posizionato in più zone, viene visualizzata solo la prima istanza applicabile.
Note operative
- Il calcolo dell'ammortamento viene eseguito interamente in JavaScript (
as24ci-financing.js). Il server fornisce solo i dati iniziali (prezzo del veicolo, valuta, impostazioni predefinite) tramite un oggetto script localizzato (as24ciFinancing). Non vengono effettuate ulteriori richieste al server quando il visitatore regola il calcolatore. - Il calcolatore viene visualizzato solo quando il prezzo del veicolo è superiore a zero. Se un veicolo non ha un prezzo, il widget viene omesso silenziosamente anche se la funzionalità è abilitata e il blocco è presente nel Layout Manager.
- Le risorse JavaScript e CSS per il calcolatore vengono accodate solo sulle pagine dei singoli veicoli (
is_singular), non sull'archivio o su altre pagine. - Il widget utilizza proprietà CSS personalizzate provenienti dal design system del plugin (colore primario, raggio del bordo, sfondo, colori del testo), in modo da ereditare automaticamente i colori del tema configurati.
- Il testo del disclaimer ("This is an estimate only. Actual rates may vary. Please consult your bank or financial institution for exact terms.") è hardcoded nel template e non è configurabile dalle impostazioni di amministrazione.
- Il calcolatore di finanziamento non invia alcun dato al server, non crea lead e non contatta alcun servizio di finanziamento esterno.
Risoluzione dei problemi
Il calcolatore di finanziamento non appare nella pagina di dettaglio del veicolo.
- Conferma che la funzionalità sia abilitata nelle impostazioni del plugin.
- Verifica che il veicolo abbia un prezzo superiore a zero.
- Conferma che il blocco del calcolatore di finanziamento sia attivo nel Layout Manager per la pagina del singolo veicolo.
- Controlla la console del browser per eventuali errori JavaScript.
La rata mensile mostra un trattino (—) e non si aggiorna.
- Il calcolatore richiede JavaScript per funzionare. Verifica che JavaScript non sia bloccato nel browser.
- Verifica la presenza di script in conflitto provenienti da altri plugin che potrebbero interferire con gli event listener del calcolatore.
I valori del calcolatore non riflettono la valuta o la localizzazione del sito.
- La valuta e la localizzazione vengono passate a JavaScript al caricamento della pagina, in base alla valuta memorizzata del veicolo e alla localizzazione del sito WordPress. La modifica di queste impostazioni richiede la cancellazione della cache della pagina.