Arbeitsabläufe im Frontend

--- This document describes how visitors interact with the vehicle inventory on the public-facing (frontend) side of a WordPress site powered by the ADP Car Market Hub plugin. It covers the vehicle archive page, detail pages, filter controls, Favorites, Compare, contact and test drive forms, financing calculator, social sharing, PDF datasheet, and Search Alerts.

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 das Administrator-Handbuch.

---

Übersicht

Das Plugin stellt den Fahrzeugbestand auf dem WordPress-Frontend mithilfe eines dedizierten Custom Post Type (as24ci_car) und einer Reihe integrierter Templates dar. Die Hauptbereiche im Frontend 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 CPT-Archiv-URL von WordPress, native Taxonomie-Archiv-URLs oder WordPress-Seiten mit Plugin-Shortcodes 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 der Registerkarte Settings (und im Setup-Assistenten); Social Sharing wird unter Design & Styles konfiguriert; Suchaufträge werden auf der dedizierten Registerkarte Search Alerts verwaltet; die Buchung von Probefahrten und der Finanzierungsrechner werden auf der Registerkarte 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) Sperrtage auf der Registerkarte Leads konfiguriert werden.

---

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, Kraftstoffart, Leistung).
• Preis.
• Favoriten-Herz-Button (wenn die Favoriten-Funktion aktiviert ist).
• Vergleich-Button (wenn die Vergleichs-Funktion aktiviert ist).
• Link zur Fahrzeug-Detailseite.

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

Shortcode

Das Archiv kann auf jeder 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-Seitenleiste auf der Archivseite ermöglicht es Besuchern, die Fahrzeugliste einzugrenzen. Jeder Filter kann einzeln in CMH Center → 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 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 #as24ci-contact-Anker auf der Fahrzeugseite weitergeleitet, mit einer Erfolgs- oder Fehleranzeige.
• 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 können in den Leads-Einstellungen konfiguriert werden.

---

CMH Team Kontaktkarte

Wenn ein Verkaufsansprechpartner der Garage im CMH Team konfiguriert ist, zeigt die Fahrzeug-Detailseite diese Person als Kontakt für das Inserat an.

• Die Karte zeigt den Namen des Kontakts und (falls vorhanden) das Foto, die E-Mail-Adresse und die Telefonnummer mit Click-to-Email- und Click-to-Call-Links.
• Der angezeigte Kontakt ist derjenige, der für das spezifische Fahrzeug ermittelt wurde: Ein direkt dem Auto zugewiesener Kontakt hat Vorrang, danach 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 Fahrzeugautors zurück.
• Derselbe ermittelte Kontakt wird auch als bevorzugter Empfänger für Anfragen verwendet, die über das Kontaktformular gesendet werden (siehe Arbeitsablauf für das Lead-Management).

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

Wie es funktioniert

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 Probefahrt-Anfrage als Lead mit is_test_drive = 1 und dem ausgefüllten Feld appointment_date erstellt.
5. Die Standard-E-Mail-Benachrichtigungen werden versendet (mit dem Hinweis "Probefahrt-Anfrage" im Betreff und im 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 die Termine (z. B. 08:00–18:00 Uhr).
• Slot-Dauer — Länge jedes Zeitfensters in Minuten (mindestens 5 Minuten).
• Sperrtage — 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 Schätzer für die monatliche Rate angezeigt.

Der Rechner verwendet:

• Fahrzeugpreis aus dem importierten Inserat.
• Zinssatz — konfigurierbarer Standardwert (Tab "Kredite" in den Features-Einstellungen).
• Laufzeit — konfigurierbarer Standardwert in Monaten (12, 24, 36, 48, 60, 72 oder 84 Monate).
• 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 ein berechneter monatlicher Ratenbetrag, der 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

• Ein Button mit einem Herz-Symbol erscheint auf jeder Fahrzeugkarte im Archiv und auf der Fahrzeug-Detailseite.
• 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 keine Anmeldung oder Registrierung 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

Binden Sie die Favoritenseite auf einer beliebigen WordPress-Seite mit dem 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 auswählen.

So funktioniert es

• Eine Vergleichen-Schaltfläche erscheint auf den Archivkarten und auf der schwebenden Aktionsleiste der einzelnen Fahrzeugseite.
• Durch Klicken auf die Schaltfläche wird das Fahrzeug in die Vergleichsauswahl aufgenommen oder daraus entfernt.
• Die ausgewählten Fahrzeuge werden in localStorage gespeichert. Es ist keine Anmeldung 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 gerendert:

[as24ci_compare]

Diese Seite zeigt die ausgewählten Fahrzeuge in einer nebeneinander liegenden Tabelle 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 der Schaltfläche für Instagram kann variieren. In der aktuellen Plugin-Version überprüfen.
• X (ehemals Twitter) – öffnet das X/Twitter-Verfassungsfenster mit vorausgefüllter Fahrzeug-URL.
• E-Mail – öffnet den Standard-E-Mail-Client des Besuchers mit einem vorausgefüllten 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 (z. B. über oder unter der Beschreibung) ist ebenfalls konfigurierbar.

---

PDF-Datenblatt

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

Der Zugriff auf die Datenblattseite erfolgt durch Hinzufügen des Query-Parameters ?as24ci_pdf={post_id} zur Fahrzeug-URL. Eine Schaltfläche oder ein Link zum Auslösen 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 (konfigurierbar durch Administratoren):

Fahrzeugtitel, Preis, Kilometerstand, Erstzulassung, Kraftstoffart, Getriebe, Leistung, Karosserieform, Aussenfarbe, 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, wenn ein passendes Fahrzeug importiert wird.

So funktioniert es 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 gesendet. 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. Durch Klicken darauf wird das Abonnement auf Inaktiv (abgemeldet) gesetzt.

Benachrichtigungsauslöser

Benachrichtigungen werden automatisch über den Action-Hook as24ci_vehicle_imported gesendet, 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 sendet 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, anzeigen 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 verwenden das localStorage des Browsers. Das Löschen des Browserspeichers oder die Verwendung 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ä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 Klick-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() gesendet, was die E-Mail-Konfiguration des Servers verwendet. Wenn die E-Mail-Zustellung unzuverlässig ist, sollten Sie die Konfiguration von SMTP in Betracht ziehen.

---

Fehlerbehebung

---

---

Verwandte Dokumente

• Benutzerhandbuch
• Arbeitsabläufe im Lead-Management
• Arbeitsablauf für den Fahrzeugimport
• Administrator-Handbuch