Dokumentation · Frontend-Handbuch

Vergleichen

Dieses Dokument behandelt die Fahrzeugvergleichsfunktion des ADP Car Market Hub WordPress Plugins: wie Besucher Fahrzeuge zum Vergleichen auswählen, wie die Vergleichsseite funktioniert und welche Einschränkungen gelten.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie die Vergleichsfunktion zum ersten Mal einrichten, einem Besucher helfen möchten, die Funktionsweise zu verstehen, oder wenn Sie unerwartetes Verhalten in der Vergleichsansicht beheben müssen.

Übersicht

Die Vergleichsfunktion ermöglicht es Besuchern, eine konfigurierbare Anzahl von Fahrzeugen aus dem Archiv oder von einzelnen Fahrzeugdetailseiten auszuwählen und diese dann nebeneinander auf einer speziellen Vergleichsseite anzuzeigen. Die Auswahl wird im localStorage des Browsers gespeichert und erfordert kein Konto oder Login.

Die Vergleichsseite ist eine ganzseitige Tabelle mit einer Spalte pro Fahrzeug. Jede Zeile zeigt das Vorschaubild des Fahrzeugs, den Titel und die konfigurierten Spezifikationsfelder. Die Fahrzeuge werden in der Reihenfolge gerendert, in der sie ausgewählt wurden.

Anforderungen oder Voraussetzungen

Die Vergleichsfunktion muss in den Plugin-Einstellungen aktiviert sein (sie ist standardmäßig aktiviert).
Eine Vergleichsseite muss konfiguriert und zugänglich sein. Das Plugin kann bei der Aktivierung eine Standard-Vergleichsseite erstellen; Sie können eine solche Seite auch manuell erstellen und in den Plugin-Einstellungen zuweisen.
Die Vergleichsseite muss den Shortcode [as24ci_compare] enthalten, oder das Plugin muss so konfiguriert sein, dass es die Seite über die Option as24cipagecompare_id verwendet, damit es die Vergleichs-URL auflösen kann.

Schritt-für-Schritt-Anleitung

Vergleichsseite einrichten

Gehen Sie im WordPress-Adminbereich zu Seiten → Erstellen.
Geben Sie der Seite einen Titel wie „Fahrzeuge vergleichen“.
Fügen Sie im Seiteninhalt den Shortcode [as24ci_compare] hinzu.
Veröffentlichen Sie die Seite.
Notieren Sie sich in den Plugin-Einstellungen die Seiten-ID. Das Plugin verwendet die gespeicherte Vergleichsseiten-ID (as24ci_page_compare_id), um auf der gesamten Website Vergleichslinks zu generieren. Wenn diese Option nicht festgelegt ist, greift das Plugin auf home_url('/compare-cars/') zurück.

Die Vergleichsfunktion als Besucher nutzen

Suchen Sie im Fahrzeugarchiv nach einer Fahrzeugkarte. Wenn die Vergleichsfunktion aktiviert und die Vergleichsschaltfläche im Layout-Manager aktiv ist, erscheint eine Vergleichs-Schaltfläche mit Symbol auf dem Overlay der Karte.
Klicken Sie auf die Vergleichsschaltfläche, um das Fahrzeug zur Vergleichsauswahl hinzuzufügen. Die Schaltfläche ändert ihren Zustand, um anzuzeigen, dass das Fahrzeug ausgewählt ist.
Wiederholen Sie dies für andere Fahrzeuge, die Sie vergleichen möchten. Das Plugin erzwingt eine konfigurierbare maximale Anzahl von Fahrzeugen (Standard: 4).
Wenn Sie die gewünschten Fahrzeuge ausgewählt haben, klicken Sie auf den angezeigten Vergleichslink oder die Schaltfläche (die Beschriftung lautet „Vergleichen“). Dies leitet Sie zur Vergleichsseite weiter.
Die Vergleichsseite wird geladen und die ausgewählten Fahrzeuge werden nebeneinander in einer Tabelle angezeigt.

Dieselbe Vergleichsschaltfläche erscheint in der fixierten, schwebenden Leiste auf den einzelnen Fahrzeugdetailseiten, sodass Besucher ein Fahrzeug zur Vergleichsauswahl hinzufügen können, während sie dessen vollständige Details betrachten.

Vergleichsseite direkt öffnen

Die Vergleichsseite liest Fahrzeug-IDs aus dem GET-Parameter ids, bei dem es sich um eine kommagetrennte Liste von Fahrzeug-Post-IDs handelt:

https://yoursite.com/compare-cars/?ids=123,456,789

Der JavaScript-Vergleichs-Umschalter erstellt diese URL automatisch, wenn der Besucher auf den Link „Vergleichen“ klickt.

Konfigurationsreferenz

Vergleichseinstellungen

Einstellung	Ort	Beschreibung
Vergleich aktivieren	Plugin-Einstellungen → Einstellungen (oder Setup-Assistent)	Aktiviert oder deaktiviert die gesamte Vergleichsfunktion
Maximale Fahrzeuge	Plugin-Einstellungen → Vergleichen	Maximale Anzahl an Fahrzeugen, die ein Besucher zu einem Vergleich hinzufügen kann (Standard 4, Minimum 2)
Vergleichsseite	Plugin-Einstellungen → Seiten	Seiten-ID der Vergleichsseite. Wird verwendet, um auf der gesamten Website Vergleichs-URLs zu generieren.

Felder der Vergleichstabelle

Die in der Vergleichstabelle angezeigten Felder werden im Bereich Layout-Manager → Vergleichen konfiguriert. Jedes aktivierte Feld erscheint als Zeile in der Tabelle für jedes ausgewählte Fahrzeug. Die verfügbaren Felder und ihre Standardbeschriftungen umfassen:

Feld-ID	Beschreibung
`conditionType`	Zustand (neu oder gebraucht)
`bodyType`	Karosserieform
`fuelType`	Kraftstoffart
`transmissionType`	Getriebe
`driveType`	Antriebsart
`bodyColorText`	Außenfarbe
`interiorColorText`	Innenfarbe
`doors`	Anzahl der Türen
`seats`	Anzahl der Sitze
`mileage`	Kilometerstand (formatiert mit km)
`cubicCapacity`	Hubraum (cm³)
`range`	Elektrische Reichweite (km)
`firstRegistrationYear`	Erstzulassungsjahr
`firstRegistrationDate`	Erstzulassungsdatum
`kiloWatts`	Leistung in kW
`horsePower`	Leistung in PS
`co2Emission`	CO₂-Emissionen (g/km)
`price`	Verkaufspreis
`listPrice`	Listenpreis
`emissionStandard`	Abgasnorm
`energyLabel`	Energielabel
`batteryCapacity`	Batteriekapazität (kWh)
`hadAccident`	Unfallhistorie (Ja/Nein)

Zusätzliche Felder können je nach den importierten Fahrzeugdaten verfügbar sein. Überprüfen Sie die aktuelle Liste im Layout-Manager Ihres Plugins.

Einheiten werden automatisch auf numerische Werte angewendet:

Preis: formatiert mit Währung
Kilometerstand, Reichweite, Garantie-Kilometerstand, Anhängelast, Leergewicht, Gesamtgewicht: km bzw. kg nach Bedarf
CO₂: g/km
Hubraum: cm³
Pferdestärken: HP
Verbrauch: l/100 km
Batteriekapazität: kWh
Stromverbrauch: kWh/100 km
Schnellladeleistung: kW
Garantiedauer: Monate
Boolean-Felder (hadAccident, inspected): angezeigt als Ja oder Nein

Felder ohne Wert für ein Fahrzeug zeigen einen Geviertstrich (—) an.

Vergleichsschaltfläche auf Archivkarten

Die Vergleichsschaltfläche erscheint auf den Fahrzeug-Archivkarten, wenn:

Die Vergleichsfunktion in den Plugin-Einstellungen aktiviert ist (FEATURE_COMPARE).
Das Element compare_btn im Bereich Layout-Manager → Archivkarten aktiviert ist.

Die Schaltfläche zeigt ein Vergleichssymbol und schaltet bei Klick den Auswahlzustand um.

Betriebshinweise

Fahrzeugauswahlen werden in localStorage unter einem Schlüssel gespeichert, der vom Vergleichs-JavaScript verwaltet wird. Die Auswahl bleibt bei der Seitennavigation innerhalb derselben Browsersitzung und auch nach dem Neuladen der Seite erhalten.
Das Löschen von Browserdaten (Cookies, Local Storage) setzt die Vergleichsauswahl zurück.
Die Vergleichsseite liest den GET-Parameter ids und lädt bis zu 4 Fahrzeuge (fest codiertes Maximum im Template). Es werden nur veröffentlichte Fahrzeuge des korrekten Post-Typs geladen; unveröffentlichte oder gelöschte Fahrzeuge werden stillschweigend ausgeschlossen.
Das konfigurierbare Maximum (COMPARE_MAX_VEHICLES) steuert die Durchsetzung des Limits durch JavaScript während der Auswahl. Das serverseitige Template wendet sein eigenes hartes Limit von 4 an. Wenn das konfigurierbare Maximum 4 überschreitet, rendert der Server dennoch maximal 4 Spalten.
Fahrzeugdaten in der Vergleichstabelle werden, sofern verfügbar, aus der benutzerdefinierten Tabelle {prefix}as24_vehicles des Plugins gelesen, mit einem Fallback auf den rohen API-Payload (Spalte raw_data JSON) und anschließend auf die Post-Meta WordPress für ältere Fahrzeuge.
Die Vergleichsseite kann sowohl als eigenständige WordPress-Seite (über den Shortcode [as24ci_compare]) als auch als Template-gesteuerte Seite verwendet werden. Beide rendern dieselbe Ausgabe.
Das Vergleichs-JavaScript-Asset wird nur auf Fahrzeugarchivseiten, einzelnen Fahrzeugseiten und Seiten, die den Shortcode [as24ci_archive] oder [as24ci_compare] enthalten, in die Warteschlange eingereiht.

Fehlerbehebung

Die Vergleichsschaltfläche erscheint nicht auf den Fahrzeugkarten.

Überprüfen Sie, ob die Vergleichsfunktion in den Plugin-Einstellungen aktiviert ist.
Überprüfen Sie den Bereich Layout-Manager → Archivkarten und stellen Sie sicher, dass compare_btn aktiviert ist.

Das Klicken auf die Vergleichsschaltfläche zeigt „Sie können bis zu X Fahrzeuge vergleichen.“

Der Besucher hat das konfigurierte Maximum erreicht. Er muss ein Fahrzeug aus der Auswahl entfernen, bevor er ein anderes hinzufügen kann.

Die Vergleichsseite zeigt „Keine Fahrzeuge zum Vergleich ausgewählt.“

Der Besucher hat die Vergleichsseite aufgerufen, ohne dass sich Fahrzeuge in seiner localStorage-Auswahl befanden.
Dies kann auch passieren, wenn der Browser localStorage nicht unterstützt oder wenn dieser gelöscht wurde.

Die Vergleichsseite zeigt weniger Fahrzeuge als erwartet.

Es werden nur veröffentlichte Fahrzeuge geladen. Wenn ein Fahrzeug nach dem Hinzufügen zur Vergleichsauswahl gelöscht oder offline genommen wurde, wird es von der Ausgabe ausgeschlossen.
Das Template erzwingt ein Maximum von 4 Fahrzeugen, unabhängig von der konfigurierbaren Einstellung.

Vergleichslinks verweisen auf die falsche Seite.

Stellen Sie sicher, dass die Vergleichsseiten-ID in den Plugin-Einstellungen korrekt eingestellt ist (as24ci_page_compare_id). Wenn diese Option fehlt oder auf eine gelöschte Seite verweist, fällt die Vergleichs-URL auf home_url('/compare-cars/') zurück.