Favoriten

Dieses Dokument beschreibt die Favoriten-Funktion (Merkliste) 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 Favoriten-Funktion 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 Favoriten-Funktion ermöglicht es Besuchern, Fahrzeuge, an denen sie interessiert sind, zu speichern und sie später auf einer eigenen Favoritenseite anzusehen. Gespeicherte Fahrzeug-IDs werden im localStorage des Browsers gespeichert. Es ist kein Konto und kein 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, einschliesslich allfälliger Preisänderungen oder Fahrzeuge, die seit dem Speichern entfernt wurden.

Anforderungen oder Voraussetzungen

• Die Favoriten-Funktion muss in den Plugin-Einstellungen aktiviert sein (sie ist standardmässig 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.

Ein 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 Favoriten-Funktion und das Element favorite_btn beide aktiviert sind.
2. Klicken Sie auf das Herz-Symbol, 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 ansehen

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 Favoriten gespeichert." an.

Konfigurations-Referenz

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 Favoriten-Funktion 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.

Betriebliche Hinweise

• Fahrzeug-IDs werden im Browser-localStorage gespeichert. Favoriten bleiben beim Navigieren auf der Website und beim Neuladen der Seite im selben Browser erhalten. Das Löschen von Browserdaten (Cookies und lokaler Speicher) entfernt alle gespeicherten Favoriten.
• Favoriten werden nicht geräte- oder browserübergreifend 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.
• Vom REST-Endpunkt werden nur veröffentlichte Fahrzeuge des korrekten Post-Typs zurückgegeben. Fahrzeuge, deren Veröffentlichung aufgehoben oder die seit dem Speichern gelöscht wurden, werden stillschweigend aus der Antwort ausgeschlossen.
• Das Zulassungsjahr wird über eine Prioritätskette ermittelt: zuerst aus dem gemappten Meta-Key für firstRegistrationYear, dann aus dem veralteten Meta-Key _as24ci_year und schliesslich über den Vehicle Field Resolver, der die benutzerdefinierte Tabelle und die Rohdatenspalten prüft.
• Datumsangaben (Erstzulassungsdatum) werden gemäss der Datumsformat-Einstellung der WordPress-Website formatiert.
• Numerische Felder wie Leistung und Treibstoffverbrauch werden weggelassen, wenn ihr Wert Null oder leer ist, damit 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 allfällige konfigurierte Design-Inline-Styles werden zusammen mit dem JavaScript geladen.

Fehlerbehebung

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

• Stellen Sie sicher, dass die Favoriten-Funktion 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 Schliessen löscht, oder es wird ein privater Modus (Inkognito-Fenster) verwendet.

Ein gespeichertes Fahrzeug wird nicht mehr auf der Favoritenseite angezeigt.

• Das Fahrzeug wurde möglicherweise nach dem Speichern im WordPress-Adminbereich offline genommen oder 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