Fahrzeug-Detailseiten

Dieses Dokument behandelt die Fahrzeugdetailseite des ADP Car Market Hub WordPress Plugins: ihre Inhaltsstruktur, Galerie, Spezifikationen, Preisanzeige, Kontaktaktionen und das Template-Verhalten.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie verstehen möchten, was auf einer einzelnen Fahrzeugseite angezeigt wird, wie das Seitenlayout konfiguriert ist, wie Besucher mit dem Kontaktformular interagieren oder wie das Template von einem Theme-Entwickler angepasst werden kann.

Übersicht

Jedes veröffentlichte Fahrzeug hat seine eigene Detailseite. Die Seite präsentiert das Fahrzeug dem Besucher in einem strukturierten Layout mit einer Galerie, wichtigen Spezifikationen, technischen Daten, Ausstattungsliste, Preisgestaltung, einem Kontaktformular und optionalen Funktionen wie Finanzierungsrechner, PDF-Datenblatt-Download, Social Sharing und Probefahrt-Anfragen.

Die Fahrzeugdetailseite wird durch das integrierte Template des Plugins (single-as24ci_car-classic.php) gerendert. Das Layout ist in drei konfigurierbare Zonen unterteilt, die über den Layout-Manager verwaltet werden:

• Hauptinhalt (linke Spalte): Galerie, Beschreibung, Spezifikationen, Energiedaten, Ausstattung und optionale zusätzliche Blöcke.
• Sidebar (rechte Spalte): Preisbox, Key Facts und Finanzierungsrechner.
• Unterer Bereich: Kontaktformular, Händlerinformationen und ähnliche Fahrzeuge.

Das aktive Theme kann das Template überschreiben, indem eine single-as24ci_car.php-Datei im Theme-Verzeichnis abgelegt wird. Das Plugin prüft auf dieses Override, bevor es sein eigenes Template lädt.

Anforderungen oder Voraussetzungen

• Das Plugin muss installiert und aktiviert sein.
• Mindestens ein Fahrzeug muss importiert und veröffentlicht worden sein.
• In WordPress (Einstellungen → Permalinks) müssen „schöne“ Permalinks (Pretty Permalinks) aktiviert sein, damit das Standard-URL-Format für einzelne Fahrzeuge funktioniert. Ohne Pretty Permalinks sind die einzelnen Fahrzeugseiten möglicherweise nicht über die erwartete URL-Struktur erreichbar.

Schritt-für-Schritt-Anleitung

Zu einer Fahrzeugdetailseite navigieren

1. Klicken Sie im Fahrzeugarchiv auf eine beliebige Fahrzeugkarte. Der Link führt zur Detailseite dieses Fahrzeugs.
2. Alternativ gehen Sie in den WordPress-Adminbereich, öffnen Sie Fahrzeuge und klicken Sie unter einem Fahrzeugtitel auf Anschauen, um dessen Frontend-Detailseite zu öffnen.

Das Layout für einzelne Fahrzeuge konfigurieren

1. Öffnen Sie im Plugin-Adminbereich den Layout-Manager.
2. Wählen Sie die Zone Einzelnes Fahrzeug – Hauptinhalt, Einzelnes Fahrzeug – Sidebar oder Einzelnes Fahrzeug – Unten.
3. Ziehen Sie Blöcke per Drag-and-Drop, um ihre Reihenfolge zu ändern, oder schalten Sie deren Sichtbarkeit um.
4. Speichern Sie die Konfiguration.

Die Änderungen werden sofort und ohne erneuten Import auf alle Fahrzeugdetailseiten angewendet.

---

Konfigurationsreferenz

Layout-Zonen und verfügbare Blöcke

Die folgenden Blöcke sind in jeder Zone verfügbar. Die Standardkonfiguration wird unter jeder Zone angezeigt; der Layout-Manager ermöglicht es, die Reihenfolge zu ändern oder einzelne Blöcke zu deaktivieren.

Einzelnes Fahrzeug – Hauptinhalt (Standardreihenfolge):

1. gallery – Bildergalerie
2. description – Fahrzeugbeschreibungstext
3. specs – Tabelle mit technischen Daten
4. energy – Energie- und Emissionsdaten
5. equipment – Listen für Serien- und Sonderausstattung
6. warranty – Garantieinformationen

Einzelnes Fahrzeug – Sidebar (Standardreihenfolge):

1. price_box – Preisanzeige mit Listenpreis und Ersparnis-Badge
2. key_facts – Key Facts-Raster (Marke, Modell, Kilometerstand, Jahr, Kraftstoffart usw.)
3. financing_calc – Finanzierungsrechner (falls aktiviert)

Einzelnes Fahrzeug – Unten (Standardreihenfolge):

1. contact_form – Anfrage-Kontaktformular mit Verkäuferinformationen
2. dealer_info – Händler-Informationskarte (eigenständig)
3. similar_vehicles – Ähnliche Fahrzeuge derselben Marke und desselben Modells

Zusätzliche Blöcke aus diesen Listen können in anderen Zonen platziert werden, sofern der Layout-Manager dies zulässt, mit Ausnahme des Finanzierungsrechners, der in maximal einer Zone gerendert wird (die Sidebar hat Vorrang vor dem Hauptinhalt, der Hauptinhalt hat Vorrang vor dem unteren Bereich).

Galerie

Die Galerie zeigt alle dem Fahrzeug zugeordneten Bilder an. Die Bilder werden aus zwei Quellen zusammengestellt: importierte Bilder (_as24ci_image_ids) und manuell hochgeladene Bilder (_as24ci_manual_image_ids). Manuell hochgeladene Bilder werden zuerst angezeigt.

Optionen für die Galerieanzeige:

Wenn keine Bilder verfügbar sind, rendert der Galeriebereich keinen Fallback-Platzhalter für das Hauptbild.

Preisanzeige

Die Preisbox in der Sidebar zeigt:

• Verkaufspreis: der importierte oder manuell festgelegte Fahrzeugpreis, formatiert mit der konfigurierten Währung.
• Listenpreis (falls verfügbar und höher als der Verkaufspreis): durchgestrichen dargestellt, wobei die Ersparnisdifferenz automatisch berechnet wird.
• Währung: verwendet das eigene Währungsfeld des Fahrzeugs oder greift auf die in den Plugin-Einstellungen konfigurierte Standardwährung zurück.

Key Facts-Sidebar

Der Key Facts-Block zeigt ein Raster mit wichtigen technischen Daten. Die sichtbaren Felder und ihre Reihenfolge werden über die Blockkonfiguration Feld-Registrierung → Key Facts gesteuert. Die folgenden Felder werden unterstützt:

Felder, die für das aktuelle Fahrzeug keinen Wert haben, werden automatisch ausgeblendet.

Technische Daten

Der Block specs im Hauptinhaltsbereich zeigt eine detaillierte Liste technischer Felder. Welche Felder gerendert werden, hängt von den Fahrzeugdaten und dem Import ab. Einheiten werden automatisch angewendet:

• Kilometerstand: km
• Motorleistung: PS / kW
• Hubraum: ccm
• CO₂-Emissionen: g/km
• Kraftstoffverbrauch: l/100 km (innerorts, außerorts, kombiniert) oder kg/100 km für Erdgas (CNG)
• Stromverbrauch: kWh/100 km
• Batteriekapazität: kWh
• Reichweite: km
• Gewicht: kg
• Abmessungen (Höhe, Breite, Länge, Radstand): mm
• Kofferraumvolumen: l
• Ladeleistung: kW
• Ladezeit: Min.

Die Werte werden, sofern verfügbar, aus der benutzerdefinierten Fahrzeug-Datenbanktabelle des Plugins ausgelesen, mit einem Fallback auf Post-Meta für Fahrzeuge, die vor der aktuellen Tabellenstruktur importiert wurden.

Ausstattung

Der Block equipment rendert zwei Listen:

• Serienausstattung: standardmäßig enthaltene Funktionen.
• Sonderausstattung: als Option erhältliche Funktionen.

Beide Listen werden aus der Fahrzeugdatenquelle importiert und in der benutzerdefinierten Fahrzeugtabelle gespeichert. Ausstattungslisten werden nur angezeigt, wenn sie mindestens ein Element enthalten.

Breadcrumbs

Die Fahrzeugdetailseite enthält einen Breadcrumb-Pfad: Startseite → Fahrzeuge → Marke → Modell. Die Links für Marke und Modell filtern das Archiv vorab nach dieser Marke oder diesem Modell. Der Link „Fahrzeuge“ verweist auf die konfigurierte Archivseite.

Social Sharing

Wenn die Social-Sharing-Funktion aktiviert ist, werden auf der Detailseite Share-Buttons gerendert. Die unterstützten Netzwerke sind WhatsApp, Facebook, Instagram, X (ehemals Twitter), E-Mail und Link kopieren (die sichtbare Auswahl ist konfigurierbar). Die Platzierung ist konfigurierbar – Unter der Galerie, Sticky-Sidebar rechts oder Seitenende:

• Unter der Galerie und Seitenende rendern eine horizontale Reihe von Buttons (unter der Galerie oder ganz unten auf der Seite unter dem Kontaktbereich) und sind auf allen Bildschirmgrößen sichtbar.
• Sticky-Sidebar rechts ist eine feste Leiste am rechten Bildschirmrand, die auch die Schnellschaltflächen für Favoriten, Vergleichen und das PDF-Datenblatt enthält (sofern diese Funktionen aktiviert sind). Sie wird auf Bildschirmen in Smartphone-Größe (≤ 600 px) ausgeblendet. Verwenden Sie daher auf Smartphones Unter der Galerie oder Seitenende, um das Teilen sichtbar zu halten.

Platzierung und sichtbare Netzwerke werden unter Design & Styles → Social-Sharing-Buttons konfiguriert; siehe Referenz für Design & Styles.

Kontaktformular

Das Kontaktformular ermöglicht es Besuchern, eine Anfrage zu dem Fahrzeug zu senden. Das Formular wird über einen Standard-HTML-POST-Request übermittelt.

Kontaktformular-Felder:

Das Kontrollkästchen für die Datenschutzeinwilligung zeigt einen konfigurierbaren Einwilligungstext an. Wenn in den Plugin-Einstellungen eine URL zur Datenschutzerklärung konfiguriert ist, wird das Wort „Datenschutzerklärung“ innerhalb des Einwilligungstextes automatisch in einen Link umgewandelt.

Erfolgs- und Fehlermeldungen nach dem Absenden des Formulars sind in den Plugin-Einstellungen konfigurierbar.

Probefahrtsanfrage

Wenn die Probefahrt-Funktion aktiviert ist, enthält das Kontaktformular ein optionales Kontrollkästchen „Interesse an einer Probefahrt?“. Wenn dieses aktiviert ist, erscheinen Datums- und Uhrzeitfelder, über die der Besucher einen bestimmten Termin für eine Probefahrt anfragen kann. Überprüfen Sie die Probefahrt-Konfiguration in Ihren Plugin-Einstellungen, bevor Sie diese Funktion veröffentlichen.

Verkäufer- / Händlerinformationen

Der Bereich des Kontaktformulars enthält eine Verkäuferbox, die Folgendes anzeigt:

• Name des Verkäufers
• Berufsbezeichnung
• Adresse
• E-Mail-Adresse (als anklickbarer mailto:-Link)
• Telefonnummer (als anklickbarer tel:-Link)
• Profilbild
• Links zu sozialen Profilen (Facebook, Instagram, X, LinkedIn)

Der in dieser Box angezeigte Kontakt wird über das CMH Team-Kontakt-Routing ermittelt. Das Plugin sucht zuerst nach einem CMH Team-Kontakt für das Fahrzeug – eine Zuweisung pro Fahrzeug, der Standardkontakt für die Filiale des Fahrzeugs oder der globale Standardkontakt – und greift bei entsprechender Konfiguration auf den allgemeinen Autohaus-Kontakt zurück. Ein Teammitglied, das auf „kein sichtbarer Kontakt“ gesetzt ist, blendet die Box aus, und ein inaktives Mitglied wird niemals angezeigt. Nur wenn das CMH Team nicht greift, fällt die Box auf das veraltete Verkäuferprofil zurück (WordPress-User-Meta, bestimmt durch das Post-Meta-Feld _as24ci_seller_user_id, oder den Autor des Beitrags). Siehe CMH Team und Kontakt-Routing.

Favoriten- und Vergleichs-Buttons

Wenn die Social-Sharing-Platzierung Sticky-Sidebar rechts ausgewählt ist, enthält die feste Leiste am rechten Rand der Detailseite auch:

• Favoriten-Button (Herz-Symbol): fügt das Fahrzeug zu den gespeicherten Favoriten des Besuchers hinzu oder entfernt es daraus. Wird angezeigt, wenn die Favoritenfunktion aktiviert ist.
• Vergleichs-Button: fügt das Fahrzeug zur Vergleichsauswahl hinzu oder entfernt es daraus. Wird angezeigt, wenn die Vergleichsfunktion aktiviert ist.
• PDF-Datenblatt-Button: wird angezeigt, wenn die PDF-Datenblatt-Funktion aktiviert ist.

Diese Leiste am rechten Rand wird auf Bildschirmen in Smartphone-Größe (≤ 600 px) ausgeblendet. Bei den anderen Sharing-Platzierungen (Unter der Galerie / Seitenende) werden diese Schnellschaltflächen nicht in einer Seitenleiste gruppiert. Unabhängig von der Platzierung zeigt die Vergleichsfunktion eine eigene schwebende Vergleichsleiste an, sobald der Besucher Fahrzeuge zum Vergleichen ausgewählt hat.

Ähnliche Fahrzeuge

Der Block similar_vehicles zeigt bis zu vier weitere veröffentlichte Fahrzeuge derselben Marke und desselben Modells. Jede Karte zeigt das Vorschaubild, den Titel, den Preis, die Kraftstoffart, das Getriebe, das Jahr und den Kilometerstand. Ein Link „Alle Fahrzeuge anzeigen“ führt den Besucher zurück zum vollständigen Archiv.

PDF-Datenblatt

Wenn die PDF-Datenblatt-Funktion aktiviert ist, steht auf der Detailseite eine Download-Schaltfläche zur Verfügung. Stellen Sie sicher, dass diese Funktion in Ihren Plugin-Einstellungen aktiviert und konfiguriert ist, bevor Sie sie veröffentlichen.

Betriebshinweise

• Das Template für das Einzelfahrzeug wird über den Filter WordPress single_template geladen. Das Plugin prüft auf einen Theme-Override (single-as24ci_car.php im aktiven Theme), bevor es sein eigenes Template lädt. Wenn beide existieren, hat die Theme-Datei Vorrang.
• Fahrzeugdaten werden, sofern verfügbar, aus der benutzerdefinierten Datenbanktabelle {prefix}as24_vehicles des Plugins gelesen. Für Fahrzeuge, die vor der Existenz dieser Tabelle importiert wurden, fallen die Daten auf die WordPress-Post-Meta-Felder zurück.
• Die Galerie kombiniert manuell hochgeladene Bilder und importierte Bilder, wobei manuell hochgeladene Bilder immer zuerst angezeigt werden.
• Der Finanzierungsrechner wird in maximal einer Zone gerendert. Wenn er sowohl in der Sidebar als auch im Hauptinhalt platziert ist, wird nur die Instanz in der Sidebar gerendert.
• Der Action-Hook as24ci_after_contact_form wird nach dem Kontaktformular-Bereich ausgeführt, sodass Integrationen zusätzlichen Inhalt einfügen können.

Fehlerbehebung

Die Fahrzeugdetailseite zeigt einen 404-Fehler.

• Stellen Sie sicher, dass „Sprechende Permalinks“ aktiviert sind (Einstellungen → Permalinks im WordPress-Adminbereich). Speichern Sie die Permalink-Einstellungen nach einer Änderung einmal ab, um die Rewrite-Regeln neu zu generieren.
• Vergewissern Sie sich, dass das Fahrzeug veröffentlicht ist und sich nicht im Entwurfs- oder privaten Status befindet.

Die Galerie zeigt keine Bilder an.

• Überprüfen Sie, ob die Bilder korrekt importiert wurden. Öffnen Sie im Adminbereich die Bearbeitungsseite des Fahrzeugs und stellen Sie sicher, dass die Galeriebilder angehängt sind.
• Wenn Bilder manuell hochgeladen wurden, vergewissern Sie sich, dass sie im Feld für die manuellen Bild-IDs gespeichert sind.

Es wird kein Preis angezeigt.

• Die Preisbox zeigt nur dann einen Preis an, wenn das Fahrzeug einen Preiswert größer als Null hat. Überprüfen Sie die importierten Fahrzeugdaten.

Das Kontaktformular sendet keine Nachrichten.

• Stellen Sie sicher, dass Ihre WordPress-Website E-Mails senden kann. Viele Hosting-Umgebungen erfordern ein SMTP-Plugin oder eine zusätzliche E-Mail-Konfiguration.
• Überprüfen Sie die Leads-Konfiguration des Plugins auf erforderliche Felder oder Einschränkungen.

Der Finanzierungsrechner wird nicht angezeigt.

• Vergewissern Sie sich, dass die Finanzierungsfunktion in den Plugin-Einstellungen aktiviert ist (sie ist standardmäßig deaktiviert).
• Stellen Sie sicher, dass sie in der Layout-Manager-Zone für die Einzelfahrzeugseite aktiv ist.

Key Facts zeigen Nullwerte oder leere Werte an.

• Einige Felder hängen von der benutzerdefinierten Fahrzeugtabelle ab. Wenn ein Fahrzeug vor der Erstellung der Tabelle importiert wurde, kann ein erneuter Import des Fahrzeugs fehlende Werte beheben.

---

Zugehörige Dokumente

• Fahrzeugarchiv
• Vergleichen
• Favoriten
• Finanzierungsrechner
• PDF-Datenblatt
• Probefahrt-Anfragen