Dokumentation · Frontend-Handbuch

Fahrzeug-Archiv

Dieses Dokument beschreibt die Fahrzeug-Archivseite des ADP Car Market Hub WordPress Plugins: wie Fahrzeuge aufgelistet werden, wie Filter und Sortierung funktionieren und welche Möglichkeiten Besucher im Archiv haben.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie das Fahrzeug-Archiv zum ersten Mal konfigurieren, Fehler beim Filter- oder Sortierverhalten beheben oder einem Besucher helfen möchten, die Suche und das Durchsuchen des Bestands zu verstehen.

Übersicht

Das Fahrzeug-Archiv zeigt alle importierten Fahrzeuge als durchsuchbare, filterbare Liste an. Besucher können die Ergebnisse mithilfe von Suchfiltern eingrenzen, die Liste nach Preis oder Kilometerstand sortieren, zwischen Raster- und Listenansicht wechseln und zu den einzelnen Fahrzeug-Detailseiten navigieren.

Das Archiv wird durch das integrierte Archiv-Template des Plugins (archive-as24ci_car.php) gerendert. Es kann auf zwei Arten dargestellt werden:

Natives CPT-Archiv: WordPress stellt das Archiv automatisch unter der URL des Custom Post Type-Archivs bereit. Das Plugin registriert den Post-Typ as24ci_car und fängt das Archiv-Template über den Filter archive_template ab.
Shortcode-Seite: Platzieren Sie den Shortcode [as24ci_archive] auf einer beliebigen WordPress-Seite. Das Plugin rendert das vollständige Archiv einschliesslich Filtern und Seitennummerierung auf dieser Seite. Dies ist der empfohlene Ansatz, wenn Sie einfache (nicht-sprechende) Permalinks verwenden oder wenn Sie den URL-Slug des Archivs selbst steuern möchten.

Beide Methoden verwenden dasselbe Template und erzeugen eine identische Ausgabe.

Anforderungen oder Voraussetzungen

Das Plugin muss installiert und aktiviert sein.
Mindestens ein Fahrzeug muss importiert und veröffentlicht worden sein.
Bei Verwendung der Shortcode-Methode muss eine Seite mit [as24ci_archive] in WordPress existieren.
Die Archivseite oder die CPT-Archiv-URL muss öffentlich zugänglich sein.

Schritt-für-Schritt-Anleitung

Fahrzeug-Archiv via Shortcode anzeigen

Gehen Sie im WordPress-Adminbereich zu Seiten → Erstellen.
Geben Sie der Seite einen Titel wie "Unsere Fahrzeuge" oder "Fahrzeugbestand".
Fügen Sie im Inhaltseditor der Seite den Shortcode [as24ci_archive] hinzu.
Veröffentlichen Sie die Seite.
Bestätigen Sie in den Plugin-Einstellungen, dass die Archivseiten-ID in der Konfiguration des Plugins korrekt eingestellt ist, damit Breadcrumbs und Vergleichs-Links auf die richtige URL verweisen.

Archiv mittels Shortcode-Attributen vorfiltern

Sie können das Archiv über den Shortcode vorfiltern, um nur eine Teilmenge der Fahrzeuge anzuzeigen:

[as24ci_archive make="bmw" fuel="diesel" per_page="12"]

Unterstützte Shortcode-Attribute:

Attribut	Beschreibung	Beispielwert
`make`	Filtern nach Marke (Slug)	`bmw`, `volkswagen`
`model`	Filtern nach Modell (Slug)	`3-series`, `golf`
`price_min`	Mindestpreis	`5000`
`price_max`	Maximalpreis	`30000`
`fuel`	Filtern nach Treibstoffart (Slug)	`diesel`, `electric`
`body`	Filtern nach Karosserieform (Slug)	`suv`, `sedan`
`order_by`	Sortierfeld: `price`, `mileage` oder `date`	`price`
`order`	Sortierrichtung: `asc` oder `desc`	`asc`
`per_page`	Ergebnisse pro Seite: `12`, `24`, `48`, `72` oder `all`	`24`

Besucher können nach dem Laden der Seite weiterhin mit dem Filterformular interagieren. GET-Parameter aus dem Filterformular überschreiben die Shortcode-Attribute.

Konfigurations-Referenz

Filter-Steuerelemente

Das Archiv enthält ein Suchfilter-Formular. Welche Filter angezeigt werden, wird über den Bereich Layout Manager → Search Filters des Plugins gesteuert. Die folgenden Filterfelder werden unterstützt:

Standardfilter (standardmässig sichtbar):

Marke
Modell (abhängig von der Markenauswahl)
Jahr (Min/Max-Bereich)
Kilometerstand (Min/Max-Bereich)
Preis (Min/Max-Bereich)
Treibstoffart
Getriebe
Antriebsart
Zustand
Aussenfarbe

Erweiterte Filter (über einen "Mehr anzeigen"-Umschalter eingeblendet):

Innenfarbe
Hubraum (Min/Max-Bereich)
Energieetikette
Standort

Optionale Filter (standardmässig deaktiviert, können aktiviert werden):

Karosserieform
Türen (Min/Max-Bereich)
Sitze (Min/Max-Bereich)

Toolbar-Steuerelemente (konfigurierbar):

Sortierreihenfolge
Ergebnisse pro Seite
Stichwortsuche (q)

Jeder Filter kann im Layout Manager einzeln aktiviert oder deaktiviert werden. Deaktivierte Filter werden für Besucher ausgeblendet, beeinflussen jedoch keine aktuell aktiven Filterwerte.

Vom Archiv akzeptierte GET-Parameter

Das Archiv verarbeitet die folgenden GET-Parameter, die vom Filterformular automatisch übermittelt werden:

Parameter	Typ	Beschreibung
`make`	string	Fahrzeugmarke-Slug
`model`	string	Fahrzeugmodell-Slug
`body_type`	string	Karosserieform-Slug
`drive_type`	string	Antriebsart-Slug
`condition`	string	Zustand-Slug (`new` oder `used`)
`fuel_type`	string	Treibstoffart-Slug
`transmission`	string	Getriebe-Slug
`color_exterior`	string	Aussenfarbe-Slug (`color` wird als Alias akzeptiert)
`color_interior`	string	Innenfarbe-Slug
`min_price`	int	Mindestpreis
`max_price`	int	Maximalpreis
`mileage_min`	int	Mindestkilometerstand in km
`mileage_max`	int	Maximalkilometerstand in km
`year_min`	int	Mindestjahr der Erstzulassung
`year_max`	int	Maximaljahr der Erstzulassung
`displacement_min`	int	Mindesthubraum in ccm
`displacement_max`	int	Maximalhubraum in ccm
`energy_label`	string	Energieetikette-Slug
`location`	string	Standortname
`doors_min`	int	Mindestanzahl Türen
`doors_max`	int	Maximalanzahl Türen
`seats_min`	int	Mindestanzahl Sitze
`seats_max`	int	Maximalanzahl Sitze
`status`	string	`all`, `new` oder `used` (Status-Tab)
`q`	string	Stichwortsuche (max. 100 Zeichen)
`sort`	string	Sortierreihenfolge (siehe Abschnitt Sortierung)
`per_page`	string	Ergebnisse pro Seite: `12`, `24`, `48`, `72` oder `all`
`paged`	int	Seitennummer für die Seitennummerierung

Sortierung

Das Archiv unterstützt die folgenden Sortieroptionen über den GET-Parameter sort:

Wert	Beschreibung
(leer)	Neueste zuerst (Datum absteigend)
`price_asc`	Preis: niedrigster zuerst
`price_desc`	Preis: höchster zuerst
`mileage_asc`	Kilometerstand: niedrigster zuerst
`mileage_desc`	Kilometerstand: höchster zuerst

Die Standard-Sortierreihenfolge kann in den Plugin-Einstellungen konfiguriert werden. Wenn kein Standard konfiguriert ist, zeigt das Archiv standardmässig die neuesten Fahrzeuge zuerst an.

Layout- und Anzeigeoptionen

Die folgenden Anzeigeeinstellungen sind im Plugin-Adminbereich verfügbar:

Einstellung	Optionen	Beschreibung
Archiv-Layout	`grid`, `list`, `both`	Karten-Anzeigemodus. `both` fügt eine Schaltfläche zum Wechseln der Ansicht hinzu.
Raster-Spalten	1, 2, 3, 4	Anzahl der Spalten in der Rasteransicht
Ergebnisse pro Seite	12, 24, 48, 72 oder benutzerdefinierte Ganzzahl	Standardanzahl der Fahrzeuge pro Seite
Auszugslänge (Liste)	0–500 Zeichen	Zeichenbegrenzung für den in der Listenansicht angezeigten Auszug
Badges	Neu, Occasion, Aktion, Top-Angebot	Steuert, welche Badges auf den Fahrzeugkarten angezeigt werden

Inhalt der Fahrzeugkarte

Jede Fahrzeugkarte im Archiv zeigt die folgenden Informationen an. Einzelne Elemente können über den Bereich Layout Manager → Archive Cards neu angeordnet oder deaktiviert werden:

Fahrzeug-Vorschaubild (fällt auf einen Platzhalter zurück, wenn kein Bild verfügbar ist)
Fahrzeugtitel
Preis (formatiert mit Währung)
Zustands-Badges (Neu, Occasion, Aktion, Top-Angebot)
Wichtigste Daten: Jahr, Kilometerstand, Treibstoffart, Getriebe, PS, Karosserieform, Aussenfarbe, Zustand (konfigurierbar)
Favoriten-Schaltfläche (Herz-Symbol, sofern Favoriten-Funktion aktiviert ist)
Vergleichen-Schaltfläche (sofern Vergleichs-Funktion aktiviert ist)
Auszugstext (nur in der Listenansicht, wenn die Auszugslänge grösser als Null ist)

Zustands-Tabs

Der Archiv-Header enthält drei Tabs: Alle, Neu und Occasion. Jeder Tab zeigt die Anzahl der Fahrzeuge an, die dem aktuellen Filterzustand entsprechen. Das Klicken auf einen Tab filtert nach Zustand. Wenn ein Zustand über den Dropdown-Filter ausgewählt wird, werden die Tab-Zahlen und die Tab-Auswahl mit dieser Auswahl synchronisiert.

Betriebliche Hinweise

Kategorische Filter (Marke, Modell, Treibstoffart, Zustand usw.) sind mittels WordPress-Taxonomie-Abfragen implementiert. Numerische Filter (Preis, Kilometerstand, Jahr, Hubraum) fragen die benutzerdefinierte Datenbanktabelle {prefix}as24_vehicles des Plugins ab.
Die Standortfilterung löst den Standortnamen in eine Reihe von Seller IDs auf und filtert anschliesslich die Fahrzeuge nach diesen Verkäufern.
Wenn die Option per_page=all ausgewählt ist, wird die Seitennummerierung ausgeblendet und alle passenden Fahrzeuge werden in einer einzigen Anfrage zurückgegeben.
Das Archiv-Template wird über den Filter WordPress archive_template geladen. Das aktive Theme kann das Template überschreiben, indem es eine Datei archive-as24ci_car.php im Theme-Verzeichnis bereitstellt.
Bei Verwendung des Shortcodes verweist die Formular-Aktion auf die aktuelle Seiten-URL und nicht auf die CPT-Archiv-URL. Dadurch wird sichergestellt, dass Filterübermittlungen und die Seitennummerierung auf der Shortcode-Seite korrekt funktionieren.
Das Plugin lädt sein eigenes CSS und JavaScript nur auf Archivseiten, einzelnen Fahrzeugseiten und Seiten, die einen erkannten Plugin-Shortcode enthalten. ---

Fehlerbehebung

Die Archivseite zeigt keine Fahrzeuge an.

Bestätigen Sie, dass mindestens ein Fahrzeug importiert und veröffentlicht wurde.
Überprüfen Sie, ob in den Plugin-Einstellungen die richtige Seite als Archivseite konfiguriert ist.
Wenn Sie die CPT-Archiv-URL verwenden, stellen Sie sicher, dass unter WordPress Einstellungen → Permalinks die sprechenden Permalinks aktiviert sind.

Filter werden nicht angezeigt.

Überprüfen Sie den Bereich Layout Manager → Suchfilter und stellen Sie sicher, dass die gewünschten Filter aktiviert sind.
Wenn das Filterformular angezeigt wird, aber ein bestimmter Filter fehlt, wurde dieser möglicherweise im Layout Manager deaktiviert.

Die Sortierung nach Preis oder Kilometerstand funktioniert nicht richtig.

Die Sortierung nach Preis und Kilometerstand basiert auf der benutzerdefinierten Fahrzeugtabelle des Plugins. Fahrzeuge, die vor der Erstellung dieser Tabelle importiert wurden, werden möglicherweise erst nach einem erneuten Import oder nach Ausführung des Migrations-Tools korrekt sortiert.

Der Shortcode [as24ci_archive] wird nicht gerendert.

Stellen Sie sicher, dass das Plugin aktiv ist und der Shortcode korrekt im Seiteninhalt platziert wurde.
Prüfen Sie, ob Theme- oder Plugin-Konflikte vorliegen, die die Ausgabe des Shortcodes unterdrücken.

Die Seitennummerierung (Pagination) funktioniert auf einer Shortcode-Seite nicht.

Die GET-Parameter paged und page werden beide unterstützt. Überprüfen Sie, ob die Seitennummerierungs-Links Ihres Themes einen dieser Parameter generieren.