Dokumentation · Frontend-Handbuch
Fahrzeugarchiv
Dieses Dokument behandelt die Fahrzeug-Archivseite des ADP Car Market Hub WordPress Plugins: wie Fahrzeuge aufgelistet werden, wie Filter und Sortierung funktionieren und was Besucher im Archiv tun können.
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 angezeigt 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_carund fängt das Archiv-Template über den Filterarchive_templateab. - Shortcode-Seite: Platzieren Sie den Shortcode
[as24ci_archive]auf einer beliebigen WordPress-Seite. Das Plugin rendert das vollständige Archiv einschließlich Filtern und Paginierung auf dieser Seite. Dies ist der empfohlene Ansatz, wenn Sie einfache (nicht-sprechende) Permalinks verwenden oder wenn Sie den URL-Slug des Archivs selbst bestimmen 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 ID der Archivseite in der Konfiguration des Plugins korrekt eingestellt ist, damit Breadcrumbs und Vergleichslinks 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 | Nach Marke filtern (Slug) | bmw, volkswagen |
model | Nach Modell filtern (Slug) | 3-series, golf |
price_min | Mindestpreis | 5000 |
price_max | Maximalpreis | 30000 |
fuel | Nach Kraftstoffart filtern (Slug) | diesel, electric |
body | Nach Karosserieform filtern (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.
Konfigurationsreferenz
Filter-Steuerelemente
Das Archiv enthält ein Suchfilter-Formular. Welche Filter angezeigt werden, wird über den Bereich Layout-Manager → Suchfilter des Plugins gesteuert. Die folgenden Filterfelder werden unterstützt:
Standardfilter (standardmäßig sichtbar):
- Marke
- Modell (abhängig von der Markenauswahl)
- Erstzulassung (Min/Max-Bereich)
- Kilometerstand (Min/Max-Bereich)
- Preis (Min/Max-Bereich)
- Kraftstoffart
- Getriebe
- Antriebsart
- Fahrzeugzustand
- Außenfarbe
Erweiterte Filter (werden über einen „Mehr anzeigen“-Umschalter eingeblendet):
- Innenfarbe
- Hubraum (Min/Max-Bereich)
- Energieeffizienzklasse
- Standort
Optionale Filter (standardmäßig deaktiviert, können aktiviert werden):
- Karosserieform
- Türen (Min/Max-Bereich)
- Sitzplätze (Min/Max-Bereich)
Toolbar-Steuerelemente (konfigurierbar):
- Sortierung
- Ergebnisse pro Seite
- Stichwortsuche (
q)
Jeder Filter kann im Layout-Manager einzeln aktiviert oder deaktiviert werden. Deaktivierte Filter werden für Besucher ausgeblendet, haben jedoch keinen Einfluss auf aktuell aktive Filterwerte.
Vom Archiv akzeptierte GET-Parameter
Das Archiv verarbeitet die folgenden GET-Parameter, die vom Filterformular automatisch übermittelt werden:
| Parameter | Typ | Beschreibung |
|---|---|---|
make | string | Slug der Fahrzeugmarke |
model | string | Slug des Fahrzeugmodells |
body_type | string | Slug der Karosserieform |
drive_type | string | Slug der Antriebsart |
condition | string | Slug des Fahrzeugzustands (new oder used) |
fuel_type | string | Slug der Kraftstoffart |
transmission | string | Slug der Getriebeart |
color_exterior | string | Slug der Außenfarbe (color wird als Alias akzeptiert) |
color_interior | string | Slug der Innenfarbe |
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 | Slug der Energieeffizienzklasse |
location | string | Name des Standorts |
doors_min | int | Mindestanzahl an Türen |
doors_max | int | Maximalanzahl an Türen |
seats_min | int | Mindestanzahl an Sitzplätzen |
seats_max | int | Maximalanzahl an Sitzplätzen |
status | string | all, new oder used (Zustands-Tab) |
q | string | Stichwortsuche (max. 100 Zeichen) |
sort | string | Sortierung (siehe Abschnitt Sortierung) |
per_page | string | Ergebnisse pro Seite: 12, 24, 48, 72 oder all |
paged | int | Seitennummer für die Paginierung |
Sortierung
Das Archiv unterstützt die folgenden Sortieroptionen über den GET-Parameter sort:
| Wert | Beschreibung |
|---|---|
| (leer) | Neueste zuerst (Datum absteigend) |
price_asc | Preis: aufsteigend |
price_desc | Preis: absteigend |
mileage_asc | Kilometerstand: aufsteigend |
mileage_desc | Kilometerstand: absteigend |
Die Standardsortierung kann in den Plugin-Einstellungen konfiguriert werden. Wenn kein Standard konfiguriert ist, sortiert das Archiv standardmäßig nach den neuesten Fahrzeugen zuerst.
Layout- und Anzeigeoptionen
Die folgenden Anzeigeeinstellungen sind im Plugin-Adminbereich verfügbar:
| Einstellung | Optionen | Beschreibung |
|---|---|---|
| Archiv-Layout | grid, list, both | Darstellungsmodus der Karten. both fügt eine Schaltfläche zum Wechseln der Ansicht hinzu. |
| Spalten im Raster | 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 |
| Länge des Textauszugs in der Liste | 0–500 Zeichen | Zeichenbegrenzung für den in der Listenansicht angezeigten Textauszug |
| Badges | Neu, Gebraucht, Angebot, Top-Angebot | Legt fest, welche Badges auf den Fahrzeugkarten angezeigt werden |
Inhalt der Archivkarte
Jede Fahrzeugkarte im Archiv zeigt die folgenden Informationen. Einzelne Elemente können über den Bereich Layout-Manager → Archivkarten 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, Gebraucht, Angebot, Top-Angebot)
- Wichtigste Daten: Erstzulassung, Kilometerstand, Kraftstoffart, Getriebe, Leistung, Karosserieform, Außenfarbe, Fahrzeugzustand (konfigurierbar)
- Favoriten-Button (Herz-Symbol, sofern die Favoritenfunktion aktiviert ist)
- Vergleichen-Button (sofern die Vergleichsfunktion aktiviert ist)
- Textauszug (nur in der Listenansicht, wenn die Länge des Textauszugs größer als Null ist)
Zustands-Tabs
Der Archiv-Header enthält drei Tabs: Alle, Neu und Gebraucht. Jeder Tab zeigt die Anzahl der Fahrzeuge an, die dem aktuellen Filterzustand entsprechen. Das Klicken auf einen Tab filtert nach dem jeweiligen Zustand. Wenn ein Zustand über den Dropdown-Filter für den Fahrzeugzustand ausgewählt wird, werden die Tab-Zahlen und die Tab-Auswahl mit dieser Auswahl synchronisiert.
Betriebshinweise
- Kategoriale Filter (Marke, Modell, Kraftstoffart, Zustand usw.) werden mithilfe von WordPress Taxonomie-Abfragen implementiert. Numerische Filter (Preis, Kilometerstand, Erstzulassung, Hubraum) fragen die benutzerdefinierte Datenbanktabelle
{prefix}as24_vehiclesdes Plugins ab. - Die Standortfilterung löst den Standortnamen in eine Reihe von Seller IDs auf und filtert die Fahrzeuge anschließend nach diesen Verkäufern.
- Wenn die Option
per_page=allausgewählt ist, wird die Paginierung ausgeblendet und alle passenden Fahrzeuge werden in einer einzigen Anfrage zurückgegeben. - Das Archiv-Template wird über den Filter WordPress
archive_templategeladen. Das aktive Theme kann das Template überschreiben, indem es eine Dateiarchive-as24ci_car.phpim Theme-Verzeichnis bereitstellt. - Bei Verwendung des Shortcodes verweist die Formular-Aktion auf die aktuelle Seiten-URL und nicht auf die URL des CPT-Archivs. Dadurch wird sichergestellt, dass Filterübermittlungen und Paginierung auf der Shortcode-Seite korrekt funktionieren.
- Das Plugin lädt seine eigenen CSS- und JavaScript-Dateien 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 „sprechende“ Permalinks (Pretty Permalinks) aktiviert sind.
Filter werden nicht angezeigt.
- Überprüfen Sie den Bereich Layout-Manager-Referenz → Suchfilter und bestätigen Sie, 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.
- Bestätigen Sie, dass das Plugin aktiv ist und der Shortcode korrekt im Seiteninhalt platziert wurde.
- Suchen Sie nach Konflikten mit dem Theme oder anderen Plugins, die die Shortcode-Ausgabe unterdrücken könnten.
Die Seitennummerierung (Pagination) funktioniert auf einer Shortcode-Seite nicht.
- Die GET-Parameter
pagedundpagewerden beide unterstützt. Überprüfen Sie, ob die Paginierungs-Links Ihres Themes einen dieser Parameter generieren.