Favoriten

Dieses Dokument behandelt die Favoritenfunktion (Wunschzettel) des ADP Car Market Hub WordPress Plugins: wie Besucher Fahrzeuge speichern, wie die Favoritenseite funktioniert, welche Daten angezeigt werden und welche Einschränkungen gelten.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie die Favoritenfunktion zum ersten Mal einrichten, konfigurieren, welche Fahrzeugdetails auf der Favoritenseite angezeigt werden, oder einem Besucher erklären möchten, wie er Fahrzeuge speichern und wieder aufrufen kann.

Übersicht

Die Favoritenfunktion ermöglicht es Besuchern, Fahrzeuge, an denen sie interessiert sind, zu speichern und sie später auf einer speziellen Favoritenseite anzusehen. Gespeicherte Fahrzeug-IDs werden im localStorage des Browsers gespeichert. Es ist kein Konto oder Login erforderlich.

Wenn ein Besucher die Favoritenseite öffnet, ruft das Plugin die aktuellen Fahrzeugdaten für alle gespeicherten IDs von einem REST-API-Endpunkt ab und rendert die Liste dynamisch. Das bedeutet, dass die Favoritenseite immer den aktuellen Zustand der Fahrzeugliste widerspiegelt, einschließlich eventueller Preisänderungen oder Fahrzeuge, die seit dem Speichern entfernt wurden.

Voraussetzungen oder Vorbedingungen

• Die Favoritenfunktion muss in den Plugin-Einstellungen aktiviert sein (sie ist standardmäßig aktiviert).
• In WordPress muss eine Favoritenseite existieren, die den Shortcode [as24ci_favorites] in ihrem Inhalt enthält.
• Die WordPress REST-API muss öffentlich zugänglich sein, damit die Favoritenseite Fahrzeugdaten laden kann.

Schritt-für-Schritt-Anleitung

Favoritenseite einrichten

1. Gehen Sie im WordPress-Adminbereich zu Seiten → Erstellen.
2. Geben Sie der Seite einen Titel wie „Meine Favoriten“ oder „Gespeicherte Fahrzeuge“.
3. Fügen Sie im Seiteninhalt den Shortcode [as24ci_favorites] hinzu.
4. Veröffentlichen Sie die Seite.

Die Favoritenseite rendert einen Container, der beim Laden der Seite durch JavaScript befüllt wird. Es ist keine zusätzliche Konfiguration des Shortcodes erforderlich.

Fahrzeug als Besucher speichern

1. Suchen Sie in der Fahrzeug-Übersicht eine Fahrzeugkarte. Eine Favoriten-Schaltfläche (Herz-Symbol) erscheint auf der Karte, wenn die Favoritenfunktion und das Element favorite_btn beide aktiviert sind.
2. Klicken Sie auf die Herz-Schaltfläche, um das Fahrzeug zu Ihren Favoriten hinzuzufügen. Die Schaltfläche ändert ihren Zustand, um anzuzeigen, dass das Fahrzeug gespeichert ist.
3. Klicken Sie erneut auf die Schaltfläche, um das Fahrzeug aus Ihren Favoriten zu entfernen.

Dieselbe Favoriten-Schaltfläche ist auch auf den einzelnen Fahrzeugdetailseiten in der fixierten, schwebenden Aktionsleiste verfügbar.

Gespeicherte Favoriten anzeigen

1. Navigieren Sie zur Favoritenseite.
2. Die Seite lädt und ruft den REST-Endpunkt des Plugins auf, um die aktuellen Daten für alle gespeicherten Fahrzeug-IDs abzurufen.
3. Jedes gespeicherte Fahrzeug wird als Karte mit Bild, Titel, Preis und den konfigurierten Spezifikationsfeldern angezeigt.
4. Klicken Sie auf einer Karte auf „Mehr Details“, um die vollständige Detailseite des Fahrzeugs zu öffnen.

Wenn keine Fahrzeuge gespeichert sind, zeigt die Seite „Sie haben noch keine gespeicherten Favoriten.“ an.

Konfigurationsreferenz

Favoriten-Einstellungen

Felder der Favoritenseite

Welche Fahrzeugfelder auf jeder Favoritenkarte angezeigt werden, wird über den Bereich Layout-Manager → Favoriten gesteuert. Die folgenden Felder werden unterstützt und können einzeln aktiviert oder deaktiviert werden:

Felder ohne Wert für ein Fahrzeug oder numerische Felder mit dem Wert Null werden auf der Karte dieses Fahrzeugs ausgeblendet. Die Reihenfolge der Felder folgt der Konfiguration des Bereichs.

Favoriten-Schaltfläche auf der Archivkarte

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

• Die Favoritenfunktion in den Plugin-Einstellungen (FEATURE_FAVORITES) aktiviert ist.
• Das Element favorite_btn im Bereich Layout-Manager → Archivkarten aktiviert ist.

Die Schaltfläche zeigt ein Herz-Symbol und schaltet den gespeicherten Zustand bei Klick um.

Betriebshinweise

• Fahrzeug-IDs werden im Browser-localStorage gespeichert. Favoriten bleiben beim Navigieren zwischen Seiten und bei Seiten-Reloads im selben Browser erhalten. Das Löschen von Browserdaten (Cookies und lokaler Speicher) entfernt alle gespeicherten Favoriten.
• Favoriten werden nicht über verschiedene Geräte oder Browser hinweg geteilt. Es gibt keine serverseitige Kontospeicherung für Favoriten.
• Die Favoritenseite ruft bei jedem Laden der Seite Fahrzeugdaten vom REST-Endpunkt POST /wp-json/as24ci/v1/favorites ab. Der Request-Body enthält ein Array von Post-IDs.
• Der REST-Endpunkt erzwingt ein Maximum von 50 Fahrzeugen pro Anfrage. Wenn mehr als 50 Fahrzeuge in localStorage gespeichert sind, werden nur die ersten 50 abgerufen.
• Nur veröffentlichte Fahrzeuge des korrekten Post-Typs werden vom REST-Endpunkt zurückgegeben. Fahrzeuge, deren Veröffentlichung rückgängig gemacht wurde oder die seit dem Speichern gelöscht wurden, werden stillschweigend aus der Antwort ausgeschlossen.
• Das Erstzulassungsjahr wird über eine Prioritätskette ermittelt: zuerst aus dem gemappten Meta-Key für firstRegistrationYear, dann aus dem veralteten Meta-Key _as24ci_year und schließlich über den Vehicle Field Resolver, der die benutzerdefinierte Tabelle und die Rohdatenspalten prüft.
• Daten (Erstzulassungsdatum) werden unter Verwendung der Website-Datumsformateinstellung von WordPress formatiert.
• Numerische Felder wie Leistung und Kraftstoffverbrauch werden weggelassen, wenn ihr Wert Null oder leer ist, sodass auf der Karte nicht „0 PS“ oder „0.0 l/100 km“ angezeigt wird.
• Das Favoriten-JavaScript-Asset wird auf Fahrzeug-Archivseiten, einzelnen Fahrzeugseiten und Seiten, die den Shortcode [as24ci_favorites] oder [as24ci_archive] enthalten, in die Warteschlange eingereiht.
• Das Favoriten-CSS und alle konfigurierten Design-Inline-Styles werden zusammen mit dem JavaScript geladen.

Fehlerbehebung

Die Favoriten-Schaltfläche erscheint nicht auf den Fahrzeugkarten.

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

Die Favoritenseite zeigt „Favoriten werden geladen...“ und aktualisiert sich nicht.

• Überprüfen Sie, ob die WordPress REST-API zugänglich ist. Viele Sicherheits-Plugins oder Serverkonfigurationen blockieren den Zugriff auf die REST-API für nicht angemeldete Benutzer.
• Öffnen Sie die Entwicklerkonsole des Browsers und suchen Sie nach JavaScript-Fehlern oder fehlgeschlagenen Netzwerkanfragen.
• Stellen Sie sicher, dass die Seite den Shortcode [as24ci_favorites] enthält.

Die Favoritenseite zeigt „Favoriten konnten nicht geladen werden.“

• Die REST-Anfrage an /wp-json/as24ci/v1/favorites ist fehlgeschlagen oder hat einen Fehler zurückgegeben. Überprüfen Sie, ob die REST-API korrekt funktioniert.
• Stellen Sie sicher, dass die Permalink-Einstellungen der Website das Auflösen von REST-API-URLs zulassen.

Gespeicherte Fahrzeuge verschwinden nach einem Browser-Neustart.

• localStorage bleibt in allen modernen Browsern auch nach einem Browser-Neustart erhalten. Wenn Favoriten verschwinden, ist der Browser möglicherweise so konfiguriert, dass er den Speicher beim Schließen löscht, oder es wird ein privater Modus (Inkognito-Modus/privates Fenster) verwendet.

Ein gespeichertes Fahrzeug wird nicht mehr auf der Favoritenseite angezeigt.

• Die Veröffentlichung des Fahrzeugs wurde möglicherweise nach dem Speichern im WordPress-Adminbereich aufgehoben oder das Fahrzeug wurde gelöscht. Der REST-Endpunkt gibt nur veröffentlichte Fahrzeuge zurück.

Die Favoritenseite zeigt nur einen Teil der gespeicherten Fahrzeuge.

• Der REST-Endpunkt gibt maximal 50 Fahrzeuge zurück. Wenn mehr als 50 Fahrzeuge in localStorage gespeichert sind, werden nur die ersten 50 abgerufen.

Verwandte Dokumente

• Fahrzeug-Archiv
• Fahrzeugdetailseiten
• Vergleichen
• Shortcodes-Referenz