Dokumentation · Frontend-Handbuch

Vergleichen

Dieses Dokument beschreibt die Fahrzeugvergleichs-Funktion 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 bei der Nutzung helfen oder unerwartetes Verhalten in der Vergleichsansicht beheben möchten.

Übersicht

Die Vergleichsfunktion ermöglicht es Besuchern, eine konfigurierbare Anzahl von Fahrzeugen aus dem Archiv oder von einzelnen Fahrzeugdetailseiten auszuwählen und diese anschliessend auf einer speziellen Vergleichsseite nebeneinander 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, den Titel und die konfigurierten Spezifikationsfelder des Fahrzeugs. 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ässig aktiviert).
Eine Vergleichsseite muss konfiguriert und zugänglich sein. Das Plugin kann bei der Aktivierung eine Standard-Vergleichsseite erstellen; Sie können eine solche 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 nutzt, 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 überall auf der Website Vergleichslinks zu generieren. Wenn diese Option nicht festgelegt ist, fällt das Plugin auf home_url('/compare-cars/') zurück.

Die Vergleichsfunktion als Besucher nutzen

Suchen Sie im Fahrzeugarchiv eine 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

Vergleichs-Einstellungen

Einstellung	Ort	Beschreibung
Vergleich aktivieren	Plugin-Einstellungen → Einstellungen (oder Setup-Assistent)	Aktiviert oder deaktiviert die gesamte Vergleichsfunktion
Maximale Fahrzeuge	Plugin-Einstellungen → Vergleichen	Maximale Anzahl von 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 überall auf der 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`	Aussenfarbe
`interiorColorText`	Innenfarbe
`doors`	Anzahl Türen
`seats`	Anzahl Sitze
`mileage`	Kilometerstand (formatiert mit km)
`cubicCapacity`	Hubraum (cm³)
`range`	Elektrische Reichweite (km)
`firstRegistrationYear`	Jahr der Erstzulassung
`firstRegistrationDate`	Datum der Erstzulassung
`kiloWatts`	Leistung in kW
`horsePower`	Leistung in PS
`co2Emission`	CO₂-Emissionen (g/km)
`price`	Verkaufspreis
`listPrice`	Listenpreis
`emissionStandard`	Abgasnorm
`energyLabel`	Energieetikette
`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 oder kg gemäss Angabe
CO₂: g/km
Hubraum: cm³
Pferdestärken: PS
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 der Archivkarte

Die Vergleichsschaltfläche erscheint auf den Fahrzeugarchivkarten, 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.

Betriebliche Hinweise

Die Fahrzeugauswahl wird im localStorage unter einem Schlüssel gespeichert, der vom Vergleichs-JavaScript verwaltet wird. Die Auswahl bleibt beim Navigieren zwischen den Seiten innerhalb derselben Browsersitzung und bei Neuladen der Seite erhalten.
Das Löschen von Browserdaten (Cookies, lokaler Speicher) setzt die Vergleichsauswahl zurück.
Die Vergleichsseite liest den GET-Parameter ids aus und lädt bis zu 4 Fahrzeuge (hartcodiertes Maximum im Template). Es werden nur veröffentlichte Fahrzeuge des korrekten Post-Typs geladen; nicht veröffentlichte oder gelöschte Fahrzeuge werden stillschweigend ausgeschlossen.
Das konfigurierbare Maximum (COMPARE_MAX_VEHICLES) steuert die JavaScript-Erzwingung des Limits 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 Fallback auf die Roh-API-Payload (Spalte raw_data JSON) und anschliessend auf WordPress Post-Meta 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 Fahrzeuge in seiner localStorage-Auswahl zu haben.
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 die Veröffentlichung aufgehoben 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.

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