Dokumentation · Frontend-Handbuch
Finanzierungsrechner
Dieses Dokument behandelt das Finanzierungsrechner-Widget des ADP Car Market Hub WordPress Plugins: wo es erscheint, wie es für Besucher funktioniert, wie es konfiguriert wird und welche Einschränkungen es hat.
Wann dieses Dokument zu verwenden ist
Lesen Sie dieses Dokument, wenn Sie den Finanzierungsrechner zum ersten Mal aktivieren, seine Standardwerte anpassen oder einem Besucher helfen möchten zu verstehen, was der Rechner anzeigt.
Übersicht
Der Finanzierungsrechner ist ein interaktives Widget, das auf den einzelnen Fahrzeugdetailseiten angezeigt wird. Er ermöglicht es Besuchern, eine geschätzte monatliche Kreditrate basierend auf dem Fahrzeugpreis, einem prozentualen Anzahlungsbetrag, einer Kreditlaufzeit und einem jährlichen Zinssatz zu berechnen.
Alle Felder können vom Besucher angepasst werden. Der Rechner aktualisiert die geschätzte monatliche Rate sofort, wenn sich die Werte ändern, ohne dass die Seite neu geladen oder eine Serveranfrage gesendet werden muss. Die Berechnung wird vollständig im Browser mithilfe einer Standard-Annuitätenformel durchgeführt.
Der Rechner dient nur zu Schätzungszwecken. Das Ergebnis ist deutlich als Schätzung gekennzeichnet, und das Widget enthält einen Haftungsausschluss, der die Besucher daran erinnert, sich für tatsächliche Finanzierungskonditionen an ihre Bank oder ihr Finanzinstitut zu wenden.
Anforderungen oder Voraussetzungen
- Der Finanzierungsrechner muss in den Plugin-Einstellungen (
FINANCING_ENABLED) aktiviert sein. Er ist standardmäßig deaktiviert. - Die Fahrzeugdetailseite muss einen Fahrzeugpreis von über Null aufweisen. Der Rechner wird nicht gerendert, wenn der Fahrzeugpreis Null ist oder fehlt.
Schritt-für-Schritt-Anleitung
Finanzierungsrechner aktivieren
- Öffnen Sie im WordPress-Adminbereich die Plugin-Einstellungen.
- Navigieren Sie zum Konfigurationsabschnitt Finanzierungsrechner.
- Aktivieren Sie den Hauptschalter.
- Passen Sie optional den Standardzinssatz, die Kreditlaufzeit und den prozentualen Anzahlungsbetrag an.
- Speichern Sie die Einstellungen.
Der Rechner wird auf allen Fahrzeugdetailseiten angezeigt, auf denen das Fahrzeug einen Preis hat.
Besucher: Nutzung des Finanzierungsrechners
- Öffnen Sie eine Fahrzeugdetailseite.
- Scrollen Sie zum Abschnitt Finanzierungsrechner.
- Der Rechner zeigt den Fahrzeugpreis und vorausgefüllte Standardwerte für die drei anpassbaren Eingabefelder an.
- Bewegen Sie den Schieberegler Anzahlung, um den Prozentsatz des vorab gezahlten Fahrzeugpreises anzupassen. Die Beschriftung über dem Schieberegler zeigt den aktuellen Prozentsatz an.
- Wählen Sie die Laufzeit aus dem Dropdown-Menü. Die verfügbaren Optionen sind 12, 24, 36, 48, 60, 72 und 84 Monate.
- Bearbeiten Sie das Feld Jährlicher Zinssatz. Es akzeptiert Werte von 0 % bis 30 % in Schritten von 0,1 %.
- Die Geschätzte monatliche Rate wird sofort aktualisiert, sobald sich ein Wert ändert.
- Eine Zusammenfassung unter der Rate zeigt den Kreditbetrag, die Gesamtkosten und die Gesamtzinsen an.
- Der Haftungsausschluss am Ende erinnert den Besucher daran, dass das Ergebnis nur eine Schätzung ist.
Konfigurationsreferenz
Rechner-Einstellungen
| Einstellung | Optionsschlüssel | Standard | Beschreibung |
|---|---|---|---|
| Rechner aktivieren | as24ci_financing_enabled | Aus (0) | Hauptschalter für die Finanzierungsrechner-Funktion |
| Standardzinssatz | as24ci_financing_default_rate | 3.9 | Vorausgefüllter jährlicher Zinssatz in Prozent |
| Standardlaufzeit | as24ci_financing_default_months | 48 | Vorausgewählte Kreditlaufzeit in Monaten |
| Standardanzahlung | as24ci_financing_down_payment | 20 | Vorausgefüllte Anzahlung als Prozentsatz des Fahrzeugpreises |
Vom Besucher anpassbare Eingaben
| Eingabe | Typ | Bereich | Beschreibung |
|---|---|---|---|
| Anzahlung | Schieberegler | 0 % – 100 % | Prozentsatz des Fahrzeugpreises, der als Anzahlung geleistet wird |
| Laufzeit | Dropdown | 12 / 24 / 36 / 48 / 60 / 72 / 84 Monate | Dauer des Kredits |
| Zinssatz | Nummerneingabe | 0 % – 30 % | Jährlicher Zinssatz in Prozent |
Rechner-Ausgabe
Das Widget zeigt an:
| Ausgabe | Beschreibung |
|---|---|
| Geschätzte monatliche Rate | Monatliche Rate, berechnet mit der Annuitätenformel |
| Kreditbetrag | Fahrzeugpreis abzüglich Anzahlungsbetrag |
| Gesamtkosten | Kreditbetrag plus über die Laufzeit gezahlte Gesamtzinsen |
| Gesamtzinsen | Differenz zwischen Gesamtkosten und Kreditbetrag |
Alle Geldwerte werden im Format der Währung des Fahrzeugs und der Spracheinstellung der Website dargestellt.
Layout-Platzierung
Die Platzierung des Finanzierungsrechners auf der einzelnen Fahrzeugseite wird über den Layout-Manager gesteuert. Wenn die Funktion aktiviert ist, steht der Rechner-Block in der Seitenleiste der Fahrzeug-Einzelansicht zur Verfügung und kann über den Layout-Manager auch im Hauptinhaltsbereich oder im unteren Bereich platziert werden. Wenn derselbe Block in mehreren Zonen platziert wird, wird nur die erste zutreffende Instanz gerendert.
Betriebshinweise
- Die Annuitätenberechnung wird vollständig in JavaScript (
as24ci-financing.js) durchgeführt. Der Server liefert nur die Anfangsdaten (Fahrzeugpreis, Währung, Standardeinstellungen) über ein lokalisiertes Skript-Objekt (as24ciFinancing). Es werden keine weiteren Serveranfragen gestellt, wenn der Besucher den Rechner anpasst. - Der Rechner wird nur gerendert, wenn der Fahrzeugpreis größer als Null ist. Wenn ein Fahrzeug keinen Preis hat, wird das Widget stillschweigend weggelassen, selbst wenn die Funktion aktiviert ist und sich der Block im Layout-Manager befindet.
- Die JavaScript- und CSS-Assets für den Rechner werden nur auf Fahrzeugdetailseiten (
is_singular) geladen, nicht auf der Archivseite oder anderen Seiten. - Das Widget verwendet CSS-Custom-Properties aus dem Design-System des Plugins (Primärfarbe, Rahmenradius, Hintergrund, Textfarben), sodass es die konfigurierten Theme-Farben automatisch erbt.
- Der Text des Haftungsausschlusses („Dies ist nur eine Schätzung. Die tatsächlichen Zinssätze können abweichen. Bitte wenden Sie sich für genaue Konditionen an Ihre Bank oder Ihr Finanzinstitut.“) ist im Template fest codiert und kann nicht über die Admin-Einstellungen konfiguriert werden.
- Der Finanzierungsrechner übermittelt keine Daten an den Server, erstellt keine Leads und kontaktiert keinen externen Finanzierungsdienst.
Fehlerbehebung
Der Finanzierungsrechner erscheint nicht auf einer Fahrzeugdetailseite.
- Vergewissern Sie sich, dass die Funktion in den Plugin-Einstellungen aktiviert ist.
- Überprüfen Sie, ob das Fahrzeug einen Preis von über Null hat.
- Bestätigen Sie, dass der Finanzierungsrechner-Block im Layout-Manager für die Fahrzeugdetailseite aktiv ist.
- Suchen Sie in der Browser-Konsole nach JavaScript-Fehlern.
Die monatliche Rate zeigt einen Bindestrich (—) und wird nicht aktualisiert.
- Der Rechner benötigt JavaScript, um zu funktionieren. Stellen Sie sicher, dass JavaScript im Browser nicht blockiert ist.
- Suchen Sie nach Skriptkonflikten von anderen Plugins, die die Event-Listener des Rechners stören könnten.
Die Werte des Rechners spiegeln nicht die Währung oder das Gebietsschema der Website wider.
- Die Währung und das Gebietsschema werden beim Laden der Seite an das JavaScript übergeben, basierend auf der gespeicherten Währung des Fahrzeugs und dem WordPress-Gebietsschema der Website. Das Ändern dieser Einstellungen erfordert das Löschen des Seitencaches.