Fahrzeugdetailseiten

Dieses Dokument beschreibt 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, Preisen, einem Kontaktformular und optionalen Funktionen wie Finanzierungsrechner, PDF datasheet-Download, Social Sharing und Probefahrten-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, Garagen-Informationen und ähnliche Fahrzeuge.

Das aktive Theme kann das Template überschreiben, indem eine Datei single-as24ci_car.php 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 sprechende Permalinks aktiviert sein, damit das standardmässige URL-Format für einzelne Fahrzeuge funktioniert. Ohne sprechende 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 können Sie im WordPress-Adminbereich auf Fahrzeuge gehen und unter einem Fahrzeugtitel auf Anschauen klicken, um die 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 Single Vehicle – Main Content, Single Vehicle – Sidebar oder Single Vehicle – Bottom.
3. Ziehen Sie die Blöcke per Drag-and-Drop, um ihre Reihenfolge zu ändern, oder schalten Sie ihre Sichtbarkeit um.
4. Speichern Sie die Konfiguration.

Die Änderungen werden sofort für alle Fahrzeugdetailseiten übernommen, ohne dass ein erneuter Import erforderlich ist.

---

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.

Single Vehicle – Hauptinhalt (Standardreihenfolge):

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

Single Vehicle – 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)

Single Vehicle – Unten (Standardreihenfolge):

1. contact_form – Anfrage-Kontaktformular mit Verkäuferinformationen
2. dealer_info – Garagen-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 höchstens einer Zone gerendert wird (Sidebar hat Priorität vor Hauptinhalt, Hauptinhalt hat Priorität vor Unten).

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 erscheinen zuerst.

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 fahrzeugeigene Währungsfeld 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 Spezifikationen. Die sichtbaren Felder und ihre Reihenfolge werden durch die Blockkonfiguration Field Registry → Key Facts gesteuert. Die folgenden Felder werden unterstützt:

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

Technische Spezifikationen

Der Block specs im Hauptinhaltsbereich zeigt eine detaillierte Liste technischer Felder. Die gerenderten Felder hängen 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, ausserorts, 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

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

Ausstattung

Der Block equipment rendert zwei Listen:

• Serienausstattung: standardmässig enthaltene Funktionen.
• Sonderausstattung: als Option verfügbare 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: Home → Cars → Marke → Modell. Die Links für Marke und Modell filtern das Archiv vorab nach dieser Marke oder diesem Modell. Der Link "Cars" 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 Galerie, Sticky Sidebar rechts oder Seitenende:

• Unter 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össen sichtbar.
• Sticky Sidebar rechts ist eine feste Leiste am rechten Bildschirmrand, die auch die Schnellschaltflächen für Favoriten, Vergleichen und das PDF datasheet enthält (wenn diese Funktionen aktiviert sind). Sie wird auf Bildschirmen in Smartphone-Grösse (≤ 600 px) ausgeblendet. Verwenden Sie daher auf Smartphones Unter 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 zum Fahrzeug zu senden. Das Formular wird über einen Standard-HTML-POST-Request übermittelt.

Kontaktformular-Felder:

Die Datenschutz-Checkbox zeigt einen konfigurierbaren Einwilligungstext an. Wenn in den Plugin-Einstellungen eine Datenschutz-URL konfiguriert ist, wird der Text "Datenschutzerklärung" innerhalb des Einwilligungstextes automatisch in einen Link umgewandelt.

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

Probefahrt-Anfrage

Wenn die Probefahrt-Funktion aktiviert ist, enthält das Kontaktformular eine optionale Checkbox "An einer Probefahrt interessiert?". Wenn diese aktiviert ist, erscheinen Datums- und Uhrzeitfelder, mit denen der Besucher einen bestimmten Probefahrt-Termin anfragen kann. Überprüfen Sie die Probefahrt-Konfiguration in Ihren Plugin-Einstellungen, bevor Sie diese Funktion veröffentlichen.

Verkäufer- / Garagen-Informationen

Der Bereich des Kontaktformulars enthält ein Verkäufer-Panel, das Folgendes zeigt:

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

Der in diesem Panel 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 Garagen-Kontakt zurück. Ein Teammitglied, das auf "kein sichtbarer Kontakt" gesetzt ist, blendet das Panel aus, und ein inaktives Mitglied wird nie angezeigt. Nur wenn CMH Team nicht zutrifft, fällt das Panel auf das ältere Verkäuferprofil zurück (durch das Meta-Feld _as24ci_seller_user_id bestimmte WordPress-Benutzermeta oder der Autor des Beitrags). Siehe CMH Team and Contact Routing.

Favoriten- und Vergleichen-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 Favoriten-Funktion aktiviert ist.
• Vergleichen-Button: fügt das Fahrzeug zur Vergleichsauswahl hinzu oder entfernt es daraus. Wird angezeigt, wenn die Vergleichsfunktion aktiviert ist.
• PDF datasheet-Button: wird angezeigt, wenn die PDF-Datenblatt-Funktion aktiviert ist.

Diese Leiste am rechten Rand wird auf Bildschirmen in Smartphone-Grösse (≤ 600 px) ausgeblendet. Bei den anderen Sharing-Platzierungen (Unter Galerie / Seitenende) sind 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 datasheet

Wenn die PDF datasheet-Funktion aktiviert ist, steht auf der Detailseite eine Download-Schaltfläche zur Verfügung. Überprüfen Sie, ob diese Funktion in Ihren Plugin-Einstellungen aktiviert und konfiguriert ist, bevor Sie sie veröffentlichen.

Betriebshinweise

• Das Template für das einzelne Fahrzeug 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 Priorität.
• Fahrzeugdaten werden aus der benutzerdefinierten Datenbanktabelle {prefix}as24_vehicles des Plugins ausgelesen, sofern verfügbar. 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 erscheinen.
• Der Finanzierungsrechner wird in höchstens 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, was es Integrationen ermöglicht, zusätzlichen Inhalt einzufügen.

Fehlerbehebung

Die Fahrzeugdetailseite zeigt einen 404-Fehler.

• Stellen Sie sicher, dass sprechende Permalinks aktiviert sind (Einstellungen → Permalinks im WordPress-Admin). Speichern Sie die Permalink-Einstellungen nach einer Änderung einmal ab, um die Rewrite-Regeln neu zu generieren.
• Bestätigen Sie, 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 Admin die Bearbeitungsseite des Fahrzeugs und stellen Sie sicher, dass die Galeriebilder angehängt sind.
• Wenn Bilder manuell hochgeladen wurden, bestätigen Sie, 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össer 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 erscheint nicht.

• Bestätigen Sie, dass die Finanzierungsfunktion in den Plugin-Einstellungen aktiviert ist (sie ist standardmässig deaktiviert).
• Bestätigen Sie, dass sie in der Layout Manager-Zone für die Detailseite des einzelnen Fahrzeugs 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.

---

Verwandte Dokumente

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