Frontend-Nutzungs-Workflow

Dieses Dokument beschreibt, wie Besucher mit dem Fahrzeugbestand auf der öffentlich zugänglichen Seite (Frontend) einer WordPress-Website interagieren, die mit dem ADP Car Market Hub-Plugin betrieben wird. Es umfasst die Fahrzeug-Archivseite, Detailseiten, Filtersteuerungen, Favoriten, den Vergleich, Kontakt- und Probefahrtformulare, den Finanzierungsrechner, Social Sharing, das PDF-Datenblatt und Suchaufträge.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie:

• Verstehen möchten, was Besucher im Frontend sehen und welche Aktionen sie ausführen können.
• Frontend-Funktionen konfigurieren oder testen (Filter, Favoriten, Vergleich, Formulare usw.).
• Überprüfen müssen, ob das Frontend den Fahrzeugbestand nach einem Import korrekt anzeigt.
• Shortcodes in WordPress-Seiten integrieren.

Informationen zur Konfiguration dieser Funktionen durch den Administrator finden Sie im Administrator-Handbuch.

---

Übersicht

Das Plugin stellt den Fahrzeugbestand im WordPress-Frontend mithilfe eines speziellen Custom Post Type (as24ci_car) und einer Reihe integrierter Templates dar. Die wichtigsten Frontend-Bereiche sind:

• Fahrzeug-Archivseite — ein paginiertes Raster aller veröffentlichten Fahrzeugkarten.
• Fahrzeug-Detailseite — die vollständigen Informationen zu einem einzelnen Fahrzeug.
• Vergleichsseite — direkter Vergleich ausgewählter Fahrzeuge nebeneinander.
• Favoritenseite — eine Liste der vom Besucher gespeicherten Fahrzeuge.

Diese Seiten können über die WordPress-CPT-Archiv-URL, native Taxonomie-Archiv-URLs oder WordPress-Seiten, die Plugin-Shortcodes enthalten, bereitgestellt werden.

---

Anforderungen oder Voraussetzungen

• Mindestens ein Fahrzeug muss importiert und veröffentlicht sein (Beitragsstatus: publish), bevor etwas im Frontend angezeigt wird.
• Die Fahrzeug-Archiv- und Vergleichs-/Favoritenseiten müssen veröffentlichte WordPress-Seiten sein, die die entsprechenden Shortcodes enthalten, oder das WordPress-CPT-Archiv muss über Ihre Permalink-Struktur zugänglich sein.
• Funktionen wie Favoriten, Vergleich, Finanzierungsrechner, Probefahrt, Social Sharing und Suchaufträge müssen aktiviert sein, bevor sie im Frontend erscheinen. Die Schalter für Favoriten und Vergleich befinden sich auf dem Reiter Einstellungen (und im Einrichtungsassistenten); Social Sharing wird unter Design & Styles konfiguriert; Suchaufträge werden auf dem speziellen Reiter Suchaufträge verwaltet; die Probefahrtbuchung und der Finanzierungsrechner werden im Reiter Leads bzw. im Bereich für Finanzierungseinstellungen konfiguriert. Überprüfen Sie die aktuelle Platzierung in der installierten Plugin-Version, da sich das Admin-Layout zwischen den Versionen weiterentwickeln kann.
• Für die Probefahrt-Funktion müssen die verfügbaren Wochentage, das Zeitfenster, die Slot-Dauer und (optional) Ausschlusstermine im Reiter Leads konfiguriert sein.

---

Fahrzeug-Archivseite

Anzeige

Die Archivseite zeigt veröffentlichte Fahrzeuge als kartenbasiertes Raster an. Jede Karte zeigt:

• Fahrzeugbild (Vorschaubild).
• Zustands-Badge (Neu, Gebraucht, Angebot oder Top-Angebot — konfigurierbar in Design & Styles).
• Fahrzeugtitel (Marke, Modell, Variante).
• Wichtigste technische Daten (Jahr, Kilometerstand, Kraftstoffart, Leistung).
• Preis.
• Favoriten-Herz-Button (wenn die Favoriten-Funktion aktiviert ist).
• Vergleichs-Button (wenn die Vergleichs-Funktion aktiviert ist).
• Link zur Fahrzeug-Detailseite.

Die Anzahl der Fahrzeuge pro Seite ist konfigurierbar (12, 24, 48, 72 oder alle) und kann über die Auswahl pro Seite in der Filter-Sidebar oder der Toolbar geändert werden.

Shortcode

Das Archiv kann auf jeder beliebigen WordPress-Seite eingebettet werden mit:

[as24ci_archive]

Der Shortcode unterstützt optionale Attribute zum Überschreiben von Filtern, zum Beispiel:

[as24ci_archive make="BMW" per_page="12"]

Sortierung

Wenn der Sortierfilter aktiviert ist, können Besucher Fahrzeuge sortieren nach:

• Neueste zuerst (Standard: nach Import-/Veröffentlichungsdatum, absteigend)
• Preis: aufsteigend
• Preis: absteigend
• Kilometerstand: aufsteigend
• Jahr: neueste zuerst
• Jahr: älteste zuerst

Überprüfen Sie die genauen Sortieroptionen, die in Ihrer Plugin-Version verfügbar sind.

---

Archivfilter

Die Filter-Sidebar auf der Archivseite ermöglicht es Besuchern, die Fahrzeugliste einzugrenzen. Jeder Filter kann einzeln im ADP Car Market Hub → Layout-Manager aktiviert oder deaktiviert werden.

Standardfilter

Erweiterte Filter

Filter anwenden

Filter werden über URL-Query-Parameter angewendet. Die Auswahl einer Filteroption lädt das Archiv neu oder aktualisiert es mit den gefilterten Ergebnissen. Mehrere Filter können kombiniert werden. Das Löschen eines Filters entfernt ihn aus der Abfrage.

---

Fahrzeug-Detailseite

Eine Fahrzeug-Detailseite ist die Einzelansicht eines Fahrzeugs, auf der alle Informationen zum Inserat angezeigt werden.

Inhaltsbereiche

Die spezifischen Felder, die in der Tabelle der technischen Daten angezeigt werden, werden über die Einstellungen im Reiter Mapping gesteuert, wo jedes Feld ein- oder ausgeblendet und seine Beschriftung angepasst werden kann.

---

Kontaktformular

Das integrierte Kontaktformular wird auf jeder Fahrzeug-Detailseite angezeigt und ermöglicht es Besuchern, eine Anfrage zum Fahrzeug zu senden.

Felder

• Name — erforderlich.
• E-Mail — erforderlich. Muss eine gültige E-Mail-Adresse sein.
• Telefon — optional (in den Leads-Einstellungen aktivieren/deaktivieren).
• Nachricht — optional (in den Leads-Einstellungen aktivieren/deaktivieren).
• Einwilligungs-Checkbox — optional (in den Leads-Einstellungen aktivieren und konfigurieren). Wenn aktiviert, muss der Besucher das Kontrollkästchen vor dem Absenden aktivieren.

Spam-Schutz und Ratenbegrenzung

• Honeypot: Ein verstecktes Feld ist im Formular enthalten. Automatisierte Bots füllen dieses in der Regel aus; wenn es ausgefüllt ist, wird die Einsendung stillschweigend abgelehnt, ohne einen Lead zu erstellen oder eine E-Mail zu senden.
• Ratenbegrenzung: Es werden maximal 5 Einsendungen pro IP-Adresse und 5 Minuten akzeptiert. Einsendungen, die diesen Schwellenwert überschreiten, erhalten eine Fehlermeldung.

Nach dem Absenden

• Der Besucher wird zurück zum Anker #as24ci-contact auf der Fahrzeugseite weitergeleitet, mit einer Erfolgs- oder Fehleranzeige.
• Eine Erfolgsmeldung bestätigt, dass die Anfrage eingegangen ist.
• Eine Fehlermeldung wird angezeigt, wenn das Absenden fehlgeschlagen ist (z. B. wenn ein Pflichtfeld fehlt oder die Ratenbegrenzung überschritten wurde).

Die Erfolgs- und Fehlermeldungen sind in den Leads-Einstellungen konfigurierbar.

---

CMH Team Kontaktkarte

Wenn ein Verkaufsansprechpartner des Autohauses in CMH Team konfiguriert ist, zeigt die Fahrzeug-Detailseite diese Person als Ansprechpartner für das Inserat an.

• Die Karte zeigt den Namen des Ansprechpartners und (sofern angegeben) Foto, E-Mail-Adresse und Telefonnummer mit Click-to-Email- und Click-to-Call-Links.
• Der angezeigte Ansprechpartner ist derjenige, der für das spezifische Fahrzeug ermittelt wurde: Ein direkt dem Fahrzeug zugewiesener Ansprechpartner hat Vorrang, gefolgt von dem für den Standort des Fahrzeugs festgelegten Ansprechpartner und schließlich dem globalen Standardansprechpartner.
• Wenn kein CMH Team-Kontakt zutrifft, greift die Seite auf die Verkäuferprofildaten des Fahrzeugautors zurück.
• Derselbe ermittelte Ansprechpartner wird auch als bevorzugter Empfänger für Anfragen verwendet, die über das Kontaktformular gesendet werden (siehe Lead-Management-Workflow).

Administratoren verwalten diese Kontakte im Menü CMH Team; siehe das Administrator-Handbuch.

---

Probefahrt buchen

Wenn die Probefahrt-Funktion aktiviert ist, steht auf jeder Fahrzeug-Detailseite ein Formular zur Buchung einer Probefahrt zur Verfügung (oft als Reiter neben dem Kontaktformular dargestellt).

So funktioniert es

1. Der Besucher wählt ein Datum aus einer Datumsauswahl. Daten in der Vergangenheit und Daten, die auf einen Tag fallen, der nicht als verfügbar konfiguriert ist, können nicht ausgewählt werden.
2. Basierend auf dem ausgewählten Datum werden die verfügbaren Zeitfenster dynamisch geladen. Die Zeitfenster werden aus der konfigurierten Startzeit, Endzeit und Slot-Dauer generiert (z. B. 09:00–17:00 Uhr in 30-Minuten-Intervallen).
3. Der Besucher wählt ein Zeitfenster aus und trägt seinen Namen, seine E-Mail-Adresse und optional seine Telefonnummer ein.
4. Nach dem Absenden wird eine Probefahrtanfrage als Lead mit is_test_drive = 1 und dem ausgefüllten Feld appointment_date erstellt.
5. Die Standard-E-Mail-Benachrichtigungen werden gesendet (mit dem Hinweis "Probefahrtanfrage" in Betreff und Text).

Konfiguration (für Administratoren)

• Verfügbare Wochentage — an welchen Wochentagen Probefahrten möglich sind (Montag bis Sonntag).
• Startzeit / Endzeit — das tägliche Zeitfenster für Termine (z. B. 08:00–18:00 Uhr).
• Slot-Dauer — Länge jedes Zeitfensters in Minuten (mindestens 5 Minuten).
• Ausschlusstermine — bestimmte Daten (einzugeben als YYYY-MM-DD, eines pro Zeile), an denen keine Probefahrten verfügbar sind, unabhängig von der Wochentagseinstellung.

---

Finanzierungsrechner

Wenn die Finanzierungsrechner-Funktion aktiviert ist, wird auf den Fahrzeug-Detailseiten ein interaktiver Ratenrechner angezeigt.

Der Rechner verwendet:

• Den Fahrzeugpreis aus dem importierten Inserat.
• Den Zinssatz — konfigurierbarer Standardwert (Reiter Kredite in den Feature-Einstellungen).
• Die Laufzeit — konfigurierbarer Standardwert in Monaten (12, 24, 36, 48, 60, 72 oder 84 Monate).
• Die Anzahlung — konfigurierbarer Standardwert als Prozentsatz des Fahrzeugpreises.

Besucher können den Zinssatz, die Laufzeit und die Anzahlung anpassen, um verschiedene Ratenschätzungen zu sehen. Das Ergebnis ist eine berechnete monatliche Rate, die auf der Seite angezeigt wird. Dieser Rechner dient nur zu Veranschaulichungszwecken; die tatsächlichen Finanzierungskonditionen hängen vom Finanzdienstleister des Kunden ab.

---

---

Favoriten (Merkzettel)

Wenn die Favoritenfunktion aktiviert ist, können Besucher Fahrzeuge auf einem persönlichen Merkzettel speichern.

Funktionsweise

• Auf jeder Fahrzeugkarte im Archiv und auf der Fahrzeugdetailseite erscheint ein Herz-Symbol.
• Ein Klick auf das Herz fügt das Fahrzeug zu den Favoriten des Besuchers hinzu. Ein erneuter Klick entfernt es wieder.
• Favoriten werden im Browser des Besuchers (localStorage) gespeichert. Es ist kein Login oder Konto erforderlich.
• Favoriten sind geräte- und browserspezifisch — sie werden nicht zwischen Geräten oder Browsern synchronisiert und werden gelöscht, wenn der Besucher seinen Browserspeicher leert.
• Es können maximal 50 Fahrzeuge gleichzeitig in den Favoriten gespeichert werden.

Favoritenseite

Binden Sie die Favoritenseite auf einer beliebigen WordPress-Seite mit folgendem Shortcode ein:

[as24ci_favorites]

Die Seite ruft die Fahrzeugdaten für die gespeicherten IDs über einen REST-API-Endpunkt ab und rendert eine Liste mit den konfigurierten Feldern. Die sichtbaren Felder können im Layout-Manager (Bereich „Favoriten“) konfiguriert werden.

---

Fahrzeugvergleich

Wenn die Vergleichsfunktion aktiviert ist, können Besucher mehrere Fahrzeuge für einen direkten Vergleich auswählen.

Funktionsweise

• Eine Vergleichen-Schaltfläche erscheint auf den Archivkarten und in der schwebenden Aktionsleiste der einzelnen Fahrzeugseite.
• Ein Klick auf die Schaltfläche fügt das Fahrzeug der Vergleichsauswahl hinzu oder entfernt es daraus.
• Die ausgewählten Fahrzeuge werden in localStorage gespeichert. Es ist kein Login erforderlich.
• Die maximale Anzahl von Fahrzeugen, die gleichzeitig verglichen werden können, ist konfigurierbar (Standard: 4). Wenn das Maximum erreicht ist, wird der Besucher durch eine Meldung informiert.
• Eine schwebende Leiste oder Anzeige zeigt in der Regel an, wie viele Fahrzeuge ausgewählt sind, und bietet einen Link zur Vergleichsseite.

Vergleichsseite

Die Vergleichsseite wird durch den Shortcode gerendert:

[as24ci_compare]

Diese Seite zeigt die ausgewählten Fahrzeuge in einer Tabelle nebeneinander an, um den Vergleich der technischen Daten zu erleichtern. Wenn keine Fahrzeuge ausgewählt sind, wird ein Hinweistext angezeigt.

---

Social Sharing

Wenn Social Sharing aktiviert ist, erscheint eine Reihe von Sharing-Buttons auf den Fahrzeugdetailseiten. Es werden keine externen JavaScript-SDKs geladen — alle Buttons sind standardmäßige URL-basierte Links.

Unterstützte Netzwerke

• WhatsApp — öffnet den WhatsApp-Teilen-Dialog.
• Facebook — öffnet den Facebook-Teilen-Dialog.
• Instagram — Instagram unterstützt kein direktes URL-basiertes Teilen im Web; das Verhalten des Buttons für Instagram kann variieren. Bitte in der aktuellen Plugin-Version überprüfen.
• X (ehemals Twitter) — öffnet das X/Twitter-Verfassen-Fenster mit vorausgefüllter Fahrzeug-URL.
• E-Mail — öffnet den Standard-E-Mail-Client des Besuchers mit vorausgefülltem Betreff und Text.
• Link kopieren — kopiert die Fahrzeug-URL in die Zwischenablage des Besuchers.

Einzelne Netzwerke können in den Features-Einstellungen aktiviert oder deaktiviert werden. Die Platzierung (beispielsweise oberhalb oder unterhalb der Beschreibung) ist ebenfalls konfigurierbar.

---

PDF-Datenblatt

Wenn die Funktion „PDF-Datenblatt“ aktiviert ist, können Besucher eine druckoptimierte HTML-Seite für jedes Fahrzeug öffnen und dann die Funktion Drucken → Als PDF speichern ihres Browsers nutzen, um ein PDF-Dokument zu erstellen.

Die Datenblattseite wird aufgerufen, indem der Query-Parameter ?as24ci_pdf={post_id} an die Fahrzeug-URL angehängt wird. Eine Schaltfläche oder ein Link zum Aufrufen dieser Funktion ist in der Regel auf der Fahrzeugdetailseite enthalten, wenn die Funktion aktiviert ist.

Konfigurierbare Felder

Die folgenden Felder können im Datenblatt ein- oder ausgeschlossen werden (durch Administratoren konfigurierbar):

Fahrzeugtitel, Preis, Kilometerstand, Erstzulassung, Kraftstoffart, Getriebe, Leistung, Karosserieform, Außenfarbe, Türen, Sitze, Schadstoffklasse, CO2-Werte, Energieverbrauch, Ausstattungsliste, Beschreibung, Standort und Kontaktinformationen.

---

Suchaufträge (Smart Stock Alerts)

Wenn die Suchauftragsfunktion aktiviert ist, können Besucher eine gespeicherte Suche abonnieren und erhalten eine E-Mail-Benachrichtigung, sobald ein passendes Fahrzeug importiert wird.

Funktionsweise für Besucher

1. Auf der Archivseite wird nach dem Anwenden eines oder mehrerer Filter ein Formular Suche speichern / Benachrichtigungen abonnieren angezeigt.
2. Der Besucher gibt seine E-Mail-Adresse ein und sendet das Formular ab.
3. Eine DSGVO-konforme Double-Opt-In-Bestätigungs-E-Mail wird versendet. Das Abonnement befindet sich im Status Ausstehend, bis der Besucher auf den Bestätigungslink in der E-Mail klickt.
4. Nach der Bestätigung wird das Abonnement Aktiv. Ab diesem Zeitpunkt erhält der Besucher eine E-Mail-Benachrichtigung, wann immer ein Fahrzeug importiert wird, das seinen gespeicherten Filterkriterien entspricht.
5. Jede Benachrichtigungs-E-Mail enthält einen Abmeldelink. Ein Klick darauf setzt das Abonnement auf Inaktiv (abgemeldet).

Auslöser für Benachrichtigungen

Benachrichtigungen werden automatisch über den Action-Hook as24ci_vehicle_imported versendet, der jedes Mal ausgelöst wird, wenn ein Fahrzeug während eines Importlaufs erstellt oder aktualisiert wird. Das Plugin prüft alle aktiven Abonnements und versendet E-Mails an passende Abonnenten.

Administrator-Ansicht

Aktive, ausstehende, pausierte und abgemeldete Abonnements werden im Admin-Tab Suchaufträge aufgelistet. Administratoren können Abonnements filtern, einsehen und löschen.

---

Betriebshinweise

• Filter sind als URL-Query-Parameter implementiert. Besucher können gefilterte Ansichten als Lesezeichen speichern oder URLs mit angewendeten Filtern teilen.
• Favoriten und Vergleich nutzen das localStorage des Browsers. Das Löschen des Browserspeichers oder die Nutzung eines anderen Geräts/Browsers führt zum Verlust der gespeicherten Auswahl.
• Das Kontaktformular sendet Daten an die aktuelle Seite zurück mit einem Erfolgs- oder Fehler-Query-Parameter. JavaScript ist für das Absenden des Formulars nicht erforderlich; das Formular funktioniert mit standardmäßigem HTML-POST.
• Der Finanzierungsrechner dient nur zur Veranschaulichung. Die Ergebnisse werden im Browser auf Basis der konfigurierten Standardwerte berechnet. Sie stellen kein verbindliches Kreditangebot dar.
• Die Verfügbarkeit von Probefahrten wird serverseitig ausgewertet. Die verfügbaren Termine und Zeitfenster werden zum Zeitpunkt des Seitenaufrufs aus den konfigurierten Einstellungen abgeleitet.
• Social-Sharing-Links sind reine HTML-Anker. Es werden keine Tracking-Cookies oder Skripte von Drittanbietern geladen. Ein Click-Through-Tracking ist nicht integriert.
• Das PDF-Datenblatt ist eine vom Browser gerenderte Druckseite, keine serverseitig generierte PDF-Datei. Die Druckqualität und das Layout hängen vom Browser und Betriebssystem des Besuchers ab.
• Suchauftrags-E-Mails werden über WordPress wp_mail() versendet, was die E-Mail-Konfiguration des Servers nutzt. Wenn die E-Mail-Zustellung unzuverlässig ist, sollten Sie die Konfiguration von SMTP in Betracht ziehen.

---

Fehlerbehebung

---

Verwandte Dokumente

• Benutzerhandbuch
• Lead-Management-Workflow
• Fahrzeug-Import-Workflow
• Administrator-Handbuch