Arbeitsabläufe im Frontend

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 deckt die Fahrzeug-Archivseite, Detailseiten, Filtersteuerungen, Favoriten, den Vergleich, Kontakt- und Probefahrtformulare, den Finanzierungsrechner, Social Sharing, das PDF-Datenblatt und Suchabos ab.

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.

Für die Konfiguration dieser Funktionen durch den Administrator lesen Sie bitte das Administrator-Handbuch.

---

Übersicht

Das Plugin stellt den Fahrzeugbestand im WordPress-Frontend mithilfe eines dedizierten 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 über 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 Suchabos müssen aktiviert sein, bevor sie im Frontend erscheinen. Die Schalter für Favoriten und Vergleich befinden sich auf dem Tab Einstellungen (und im Setup-Assistenten); Social Sharing wird unter Design & Styles konfiguriert; Suchabos werden auf dem dedizierten Tab Suchabos verwaltet; die Probefahrt-Buchung und der Finanzierungsrechner werden im Tab 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) Ausschlussdaten im Tab 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, Aktion oder Top-Angebot — konfigurierbar in Design & Styles).
• Fahrzeugtitel (Marke, Modell, Variante).
• Wichtigste Spezifikationen (Jahr, Kilometerstand, Treibstoffart, Leistung).
• Preis.
• Favoriten-Herz-Button (falls die Favoriten-Funktion aktiviert ist).
• Vergleichs-Button (falls 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 mit folgendem Code eingebettet werden:

[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 nach folgenden Kriterien sortieren:

• 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 im ADP Car Market Hub → Layout-Manager einzeln aktiviert oder deaktiviert werden.

Standardfilter

Erweiterte Filter

Filter anwenden

Filter werden über URL-Query-Parameter angewendet. Das Auswählen 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 Spezifikationstabelle angezeigt werden, werden über die Einstellungen im Tab 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 Übermittlung stillschweigend abgelehnt, ohne dass ein Lead erstellt oder eine E-Mail gesendet wird.
• Ratenbegrenzung: Es werden maximal 5 Übermittlungen pro IP-Adresse und 5 Minuten akzeptiert. Übermittlungen, 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 Fehlermeldung.
• Eine Erfolgsmeldung bestätigt, dass die Anfrage eingegangen ist.
• Eine Fehlermeldung wird angezeigt, wenn die Übermittlung 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 der Garage 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 (falls 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 Auto zugewiesener Kontakt hat Vorrang, danach folgt der für den Standort des Autos festgelegte Kontakt und schliesslich der globale Standardkontakt.
• Wenn kein CMH Team-Kontakt zutrifft, fällt die Seite auf die Verkäuferprofildaten des Autors des Fahrzeugs zurück.
• Derselbe ermittelte Kontakt 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-Buchung

Wenn die Probefahrt-Funktion aktiviert ist, steht auf jeder Fahrzeug-Detailseite ein Formular zur Buchung einer Probefahrt zur Verfügung (oft als Tab 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 Slots werden aus der konfigurierten Startzeit, Endzeit und Slot-Dauer generiert (z. B. 09:00–17:00 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 Probefahrt-Anfrage als Lead mit is_test_drive = 1 und dem gesetzten Feld appointment_date erstellt.
5. Die Standard-E-Mail-Benachrichtigungen werden versendet (mit dem Hinweis "Probefahrt-Anfrage" 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 Slots (z. B. 08:00–18:00).
• Slot-Dauer — Länge jedes Zeitfensters in Minuten (mindestens 5 Minuten).
• Ausschlussdaten — spezifische Daten (einzugeben als YYYY-MM-DD, eines pro Zeile), an denen keine Probefahrten verfügbar sind, unabhängig von der Wochentagseinstellung.

---

Finanzierungsrechner

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

Der Rechner verwendet:

• Den Fahrzeugpreis aus dem importierten Inserat.
• Den Zinssatz — konfigurierbarer Standardwert (Tab "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 Ratenberechnungen 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 (Merkliste)

Wenn die Favoriten-Funktion aktiviert ist, können Besucher Fahrzeuge auf einer persönlichen Merkliste speichern.

Wie es funktioniert

• 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 gespeichert (localStorage). Es ist kein Login oder Konto erforderlich.
• Favoriten sind geräte- und browserspezifisch — sie werden nicht zwischen verschiedenen 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

Betten 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 stellt eine Liste mit den konfigurierten Feldern dar. 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 nebeneinander auswählen.

Wie es funktioniert

• Eine Vergleichen-Schaltfläche erscheint auf den Archivkarten und auf der schwebenden Aktionsleiste der einzelnen Fahrzeugseite.
• Ein Klick auf die Schaltfläche fügt das Fahrzeug zur 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 normalerweise an, wie viele Fahrzeuge ausgewählt sind, und bietet einen Link zur Vergleichsseite.

Vergleichsseite

Die Vergleichsseite wird durch den Shortcode gerrendered:

[as24ci_compare]

Diese Seite zeigt die ausgewählten Fahrzeuge in einer Tabelle nebeneinander an, um den Vergleich der Spezifikationen zu erleichtern. Wenn keine Fahrzeuge ausgewählt sind, wird eine Anleitung angezeigt.

---

Social Sharing

Wenn Social Sharing aktiviert ist, erscheint auf den Fahrzeugdetailseiten eine Reihe von Sharing-Buttons. Es werden keine externen JavaScript-SDKs geladen — alle Buttons sind standardmässige 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. Überprüfen Sie dies in der aktuellen Plugin-Version.
• X (ehemals Twitter) — öffnet das X/Twitter-Verfassungsfenster 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 anschliessend die Funktion Drucken → Als PDF speichern ihres Browsers nutzen, um ein PDF-Dokument zu erstellen.

Der Zugriff auf die Datenblattseite erfolgt durch Anhängen des Query-Parameters ?as24ci_pdf={post_id} an die Fahrzeug-URL. Eine Schaltfläche oder ein Link zum Aufrufen dieser Funktion ist normalerweise 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, Treibstoffart, Getriebe, Leistung, Karosserieform, Aussenfarbe, Türen, Sitze, Schadstoffklasse, CO2-Werte, Energieverbrauch, Ausstattungsliste, Beschreibung, Standort und Kontaktinformationen.

---

Suchabos (Smart Stock Alerts)

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

Wie es für Besucher funktioniert

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).

Benachrichtigungsauslöser

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 Suchabos aufgelistet. Administratoren können Abonnements filtern, einsehen und löschen.

---

Betriebliche Hinweise

• 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 den localStorage des Browsers. Beim Löschen des Browserspeichers oder bei Verwendung eines anderen Geräts/Browsers geht die gespeicherte Auswahl verloren.
• 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ässigem HTML-POST.
• Der Finanzierungsrechner dient nur zur Veranschaulichung. Die Ergebnisse werden im Browser basierend auf den konfigurierten Standardwerten 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 Ladens der Seite 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.
• Suchabo-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