Dokumentation · Frontend-Handbuch
Finanzierungsrechner
Dieses Dokument beschreibt das Finanzierungsrechner-Widget des ADP Car Market Hub WordPress Plugins: wo es angezeigt wird, wie es für Besucher funktioniert, wie es konfiguriert wird und welche Einschränkungen gelten.
Wann Sie dieses Dokument lesen sollten
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 Laufzeit und einem jährlichen Zinssatz zu berechnen.
Alle Felder können vom Besucher angepasst werden. Der Rechner aktualisiert die geschätzte monatliche Rate sofort bei jeder Änderung, ohne dass die Seite neu geladen oder eine Serveranfrage gesendet werden muss. Die Berechnung erfolgt vollständig im Browser mithilfe einer Standard-Annuitätenformel.
Der Rechner dient ausschliesslich 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 die tatsächlichen 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ässig deaktiviert. - Auf der Fahrzeugdetailseite muss ein Fahrzeugpreis von mehr als null angegeben sein. 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 Konfigurationsbereich Finanzierungsrechner.
- Aktivieren Sie den Hauptschalter.
- Passen Sie optional den Standardzinssatz, die Laufzeit und den prozentualen Anzahlungsbetrag an.
- Speichern Sie die Einstellungen.
Der Rechner wird nun auf allen Fahrzeugdetailseiten angezeigt, bei denen das Fahrzeug einen Preis hat.
Besucher: Nutzung des Finanzierungsrechners
- Öffnen Sie eine Fahrzeugdetailseite.
- Scrollen Sie zum Bereich Finanzierungsrechner.
- Der Rechner zeigt den Fahrzeugpreis und vorausgefüllte Standardwerte für die drei anpassbaren Eingabefelder an.
- Bewegen Sie den Schieberegler Anzahlung, um den prozentualen Anteil des Fahrzeugpreises anzupassen, der im Voraus bezahlt wird. Die Beschriftung über dem Regler 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 aktualisiert sich sofort, wenn sich ein Wert ändert.
- Eine Zusammenfassung unter der Rate zeigt den Kreditbetrag, die Gesamtkosten und die Gesamtzinsen an.
- Der Haftungsausschluss ganz unten erinnert den Besucher daran, dass das Ergebnis nur eine Schätzung ist.
Konfigurationsreferenz
Rechner-Einstellungen
| Einstellung | Option-Key | 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 Folgendes an:
| Ausgabe | Beschreibung |
|---|---|
| Geschätzte monatliche Rate | Monatliche Rate, berechnet mit der Annuitätenformel |
| Kreditbetrag | Fahrzeugpreis abzüglich Anzahlungsbetrag |
| Gesamtkosten | Kreditbetrag plus die über die Laufzeit gezahlten Gesamtzinsen |
| Gesamtzinsen | Differenz zwischen Gesamtkosten und Kreditbetrag |
Alle Geldbeträge werden gemäss der Währung des Fahrzeugs und dem Gebietsschema der Website formatiert.
Platzierung im Layout
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 Fahrzeugdetailseite 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össer als null ist. Wenn ein Fahrzeug keinen Preis hat, wird das Widget stillschweigend weggelassen, selbst wenn die Funktion aktiviert und der Block im Layout Manager vorhanden ist.
- Die JavaScript- und CSS-Assets für den Rechner werden nur auf einzelnen Fahrzeugseiten geladen (
is_singular), 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 übernimmt.
- Der Haftungsausschluss-Text („Dies ist nur eine Schätzung. Die tatsächlichen Zinssätze können abweichen. Bitte wenden Sie sich an Ihre Bank oder Ihr Finanzinstitut für genaue Konditionen.“) 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 mehr als null hat.
- Stellen Sie sicher, 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 aktualisiert sich nicht.
- Der Rechner benötigt JavaScript, um zu funktionieren. Stellen Sie sicher, dass JavaScript im Browser nicht blockiert ist.
- Suchen Sie nach Skript-Konflikten mit 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. Eine Änderung dieser Einstellungen erfordert das Löschen des Seitencaches.