Favorieten

Dit document behandelt de favorietenfunctie (verlanglijst) van de ADP Car Market Hub WordPress Plugin: hoe bezoekers voertuigen opslaan, hoe de favorietenpagina werkt, welke gegevens worden getoond en welke beperkingen van toepassing zijn.

Wanneer u dit document moet gebruiken

Lees dit document als u de favorietenfunctie voor het eerst instelt, configureert welke voertuigdetails op de favorietenpagina verschijnen, of een bezoeker helpt te begrijpen hoe hij voertuigen kan opslaan en opnieuw kan bekijken.

Overzicht

Met de favorietenfunctie kunnen bezoekers voertuigen waarin ze geïnteresseerd zijn opslaan en deze later bekijken op een speciale favorietenpagina. Opgeslagen voertuig-ID's worden opgeslagen in de localStorage van de browser. Er is geen account of login vereist.

Wanneer een bezoeker de favorietenpagina opent, haalt de plugin de actuele voertuiggegevens voor alle opgeslagen ID's op via een REST API-eindpunt en rendert de lijst dynamisch. Dit betekent dat de favorietenpagina altijd de huidige status van de voertuigadvertentie weergeeft, inclusief eventuele prijswijzigingen of voertuigen die zijn verwijderd sinds ze zijn opgeslagen.

Vereisten of randvoorwaarden

• De favorietenfunctie moet zijn ingeschakeld in de plugin-instellingen (deze is standaard ingeschakeld).
• Er moet een favorietenpagina bestaan in WordPress met de shortcode [as24ci_favorites] in de inhoud.
• De WordPress REST API moet openbaar toegankelijk zijn om de voertuiggegevens op de favorietenpagina te kunnen laden.

Stapsgewijze instructies

De favorietenpagina instellen

1. Ga in de WordPress-beheeromgeving naar Pagina's → Nieuwe pagina.
2. Geef de pagina een titel zoals "Mijn favorieten" of "Opgeslagen voertuigen".
3. Voeg in de pagina-inhoud de shortcode [as24ci_favorites] toe.
4. Publiceer de pagina.

De favorietenpagina rendert een container die bij het laden van de pagina door JavaScript wordt gevuld. Er is geen aanvullende configuratie van de shortcode vereist.

Een voertuig opslaan als bezoeker

1. Zoek een voertuigkaart op het voertuigenoverzicht. Er verschijnt een favorietenknop (hartpictogram) op de kaart wanneer de favorietenfunctie en het element favorite_btn beide zijn ingeschakeld.
2. Klik op de hartknop om het voertuig aan uw favorieten toe te voegen. De knop verandert van status om aan te geven dat het voertuig is opgeslagen.
3. Klik nogmaals op de knop om het voertuig uit uw favorieten te verwijderen.

Dezelfde favorietenknop is beschikbaar op individuele voertuigdetailpagina's in de zwevende actiebalk (sticky floating action bar).

Opgeslagen favorieten bekijken

1. Navigeer naar de favorietenpagina.
2. De pagina laadt en roept het REST-eindpunt van de plugin aan om de actuele gegevens voor alle opgeslagen voertuig-ID's op te halen.
3. Elk opgeslagen voertuig wordt weergegeven als een kaart met de bijbehorende afbeelding, titel, prijs en geconfigureerde specificatievelden.
4. Klik op "Meer details" op een kaart om de volledige detailpagina van het voertuig te openen.

Als er geen voertuigen zijn opgeslagen, toont de pagina de tekst "U heeft nog geen opgeslagen favorieten."

Configuratiereferentie

Favorieten-instellingen

Velden op de favorietenpagina

Welke voertuigvelden op elke favorietenkaart worden getoond, wordt beheerd via de zone Layout Manager → Favorieten. De volgende velden worden ondersteund en kunnen afzonderlijk worden in- of uitgeschakeld:

Velden zonder waarde voor een voertuig, of numerieke velden met de waarde nul, worden weggelaten op de kaart van dat voertuig. De volgorde van de velden volgt de configuratie van de zone.

Favorietenknop op overzichtskaart

De favorietenknop verschijnt op voertuigoverzichtskaarten wanneer:

• De favorietenfunctie is ingeschakeld in de plugin-instellingen (FEATURE_FAVORITES).
• Het element favorite_btn is ingeschakeld in de zone Layout Manager → Overzichtskaarten.

De knop toont een hartpictogram en schakelt de opgeslagen status om wanneer erop wordt geklikt.

Operationele opmerkingen

• Voertuig-ID's worden opgeslagen in de localStorage van de browser. Favorieten blijven behouden tijdens het navigeren door de site en overleven het herladen van pagina's binnen dezelfde browser. Het wissen van browsergegevens (cookies en lokale opslag) verwijdert alle opgeslagen favorieten.
• Favorieten worden niet gedeeld tussen verschillende apparaten of browsers. Er is geen server-side accountopslag voor favorieten.
• De favorietenpagina haalt bij elke paginalading voertuiggegevens op van het REST-eindpunt POST /wp-json/as24ci/v1/favorites. De request body bevat een array van post-ID's.
• Het REST-eindpunt dwingt een maximum af van 50 voertuigen per verzoek. Als er meer dan 50 voertuigen zijn opgeslagen in localStorage, worden alleen de eerste 50 opgehaald.
• Alleen gepubliceerde voertuigen van het juiste post-type worden door het REST-eindpunt geretourneerd. Voertuigen die zijn gedepubliceerd of verwijderd sinds ze zijn opgeslagen, worden geruisloos uitgesloten van het antwoord.
• Het registratiejaar wordt bepaald aan de hand van een prioriteitsketen: eerst vanuit de gemapte meta-key voor firstRegistrationYear, daarna vanuit de legacy _as24ci_year meta-key, en tot slot vanuit de Vehicle Field Resolver die de aangepaste tabel en kolommen met ruwe gegevens controleert.
• Datums (datum eerste toelating) worden geformatteerd met behulp van de WordPress datumformaat-instelling van de site.
• Numerieke velden zoals vermogen en brandstofverbruik worden weggelaten als hun waarde nul of leeg is, zodat de kaart niet "0 pk" of "0.0 l/100 km" toont.
• Het JavaScript-bestand voor favorieten wordt ingeladen op voertuigoverzichtspagina's, individuele voertuigpagina's en pagina's die de shortcode [as24ci_favorites] of [as24ci_archive] bevatten.
• De CSS voor favorieten en eventuele geconfigureerde inline designstijlen worden samen met het JavaScript ingeladen.

Probleemoplossing

De favorietenknop verschijnt niet op voertuigkaarten.

• Controleer of de favorietenfunctie is ingeschakeld in de plugin-instellingen.
• Controleer de zone Layout Manager → Overzichtskaarten en bevestig dat favorite_btn is ingeschakeld.

De favorietenpagina toont "Favorieten laden..." en wordt niet bijgewerkt.

• Controleer of de WordPress REST API toegankelijk is. Veel beveiligingsplugins of serverconfiguraties blokkeren REST API-toegang voor niet-ingelogde gebruikers.
• Open de ontwikkelaarsconsole van de browser en controleer op JavaScript-fouten of mislukte netwerkverzoeken.
• Bevestig dat de pagina de shortcode [as24ci_favorites] bevat.

De favorietenpagina toont "Kon favorieten niet laden."

• Het REST-verzoek naar /wp-json/as24ci/v1/favorites is mislukt of heeft een fout geretourneerd. Controleer of de REST API correct functioneert.
• Controleer of de permalink-instellingen van de site het toelaten om REST API-URL's op te lossen.

Opgeslagen voertuigen verdwijnen na het herstarten van de browser.

• localStorage blijft in alle moderne browsers behouden na het herstarten van de browser. Als favorieten verdwijnen, is de browser mogelijk geconfigureerd om de opslag te wissen bij het sluiten, of wordt er een privénavigatiemodus (incognito/privévenster) gebruikt.
• Het voertuig is mogelijk gedepubliceerd of verwijderd uit de WordPress-beheeromgeving nadat het was opgeslagen. Het REST-eindpunt retourneert alleen gepubliceerde voertuigen.

De favorietenpagina toont slechts een deel van de opgeslagen voertuigen.

• Het REST-eindpunt retourneert maximaal 50 voertuigen. Als er meer dan 50 voertuigen zijn opgeslagen in localStorage, worden alleen de eerste 50 opgehaald.

Gerelateerde documenten

• Voertuigenoverzicht
• Voertuigdetailpagina's
• Vergelijken
• Shortcodes-referentie