Documentatie · Frontend-handleiding

Zoekagenten frontend

Dit document behandelt de Zoekagent (Smart Stock Alerts) functie van de ADP Car Market Hub WordPress Plugin: hoe bezoekers zich aanmelden voor meldingen, hoe de double opt-in bevestiging werkt en hoe het afmelden in zijn werk gaat.

Wanneer u dit document moet gebruiken

Lees dit document als u de functie voor zoekagenten voor de eerste keer instelt, een bezoeker helpt te begrijpen hoe deze zich kan aanmelden en diens meldingen kan beheren, of bij het oplossen van problemen met aanmeldingen en meldingen.

Overzicht

Met de Zoekagent-functie kunnen bezoekers een set zoekcriteria opslaan en een e-mailmelding ontvangen telkens wanneer er een nieuw voertuig in het systeem wordt geïmporteerd dat aan die criteria voldoet. De functie maakt gebruik van een AVG-conforme double opt-in workflow: de bezoeker moet op een bevestigingslink in diens e-mail klikken voordat meldingen worden geactiveerd.

Bezoekers kunnen zich op elk moment afmelden door op de afmeldlink te klikken die in elke meldingsmail is opgenomen. Er is geen account of login vereist.

Vereisten of randvoorwaarden

De Zoekagent-functie moet zijn ingeschakeld in de plugin-instellingen (deze is standaard ingeschakeld, beheerd door FEATURE_SEARCH_AGENT).
De WordPress site moet e-mail kunnen verzenden. Als transactionele e-mail niet is geconfigureerd op uw hosting, overweeg dan om een SMTP-plugin te gebruiken. Zonder een werkende e-mailbezorging worden bevestigings- en meldingsmails niet verzonden.
Het aanmeldingsformulier voor de zoekagent moet zichtbaar zijn op de archiefpagina. De plugin rendert het formulier als onderdeel van de archieftemplate wanneer de functie is ingeschakeld.

Stapsgewijze instructies

Bezoeker: aanmelden voor zoekagenten

Open de voertuigarchiefpagina.
Zoek het Zoekagent-formulier onder of naast de zoekfilters.
Vul ten minste één zoekcriterium in (zoals merk, model, prijsklasse of maximale kilometerstand).
Voer een e-mailadres in het aanmeldingsveld in.
Verzend het formulier.
Er verschijnt een succesmelding: "Bijna klaar! Controleer uw inbox en bevestig uw e-mailadres."
Open de bevestigingsmail en klik op de bevestigingslink.
Er wordt een bevestigingsbericht getoond op de site. De aanmelding is nu actief.

Vanaf dit moment ontvangt de bezoeker een e-mailmelding telkens wanneer er een nieuw voertuig wordt geïmporteerd dat aan de opgeslagen criteria voldoet.

Bezoeker: afmelden voor meldingen

Open een willekeurige meldingsmail die is ontvangen van het zoekagentsysteem.
Klik op de afmelden-link onderaan de e-mail.
Er wordt een bevestigingspagina getoond. De aanmelding is direct gedeactiveerd.
De afmeldactie is onomkeerbaar vanaf de kant van de bezoeker; de bezoeker moet zich opnieuw aanmelden om toekomstige meldingen te ontvangen.

Configuratiereferentie

Zoekagentcriteria

Het aanmeldingsformulier registreert de volgende criteria. De bezoeker moet er ten minste één opgeven om de aanmelding te accepteren:

Criterium	Beschrijving
`make`	Voertuigmerk
`model`	Voertuigmodel
`body_type`	Carrosserievorm
`drive_type`	Aandrijving
`condition`	Staat: nieuw of gebruikt
`color`	Exterieurkleur
`min_price`	Minimumprijs
`max_price`	Maximumprijs
`mileage_max`	Maximale kilometerstand
`status`	Statusfilter (nieuw, gebruikt of alle)

Alle criteria gebruiken EN-logica: een voertuig moet aan elk opgegeven criterium voldoen om een melding te activeren. Een leeg criterium wordt genegeerd.

Aanmeldingsstatussen

Elke aanmelding wordt opgeslagen in de aangepaste {prefix}as24ci_search_agents-tabel van de plugin en heeft een van de volgende statussen:

Status	Betekenis
`pending`	Double opt-in e-mail verzonden; bezoeker heeft nog niet bevestigd
`active`	Bevestigd; meldingen worden verzonden voor overeenkomende voertuigen
`inactive`	Afgemeld door de bezoeker
`paused`	Handmatig gepauzeerd door een beheerder in de plugin-beheeromgeving

E-mailtemplates

De plugin verzendt automatisch twee soorten e-mail:

Bevestigingsmail (verzonden bij aanmelding):

Onderwerp: "Bevestig uw zoekagent"
Bevat de opgeslagen criteria van de bezoeker en de bevestigingslink.

Match-meldingsmail (verzonden wanneer een nieuw overeenkomend voertuig wordt geïmporteerd):

Onderwerp: "Nieuwe voertuigmatch: [vehicle title]"
Bevat de voertuigtitel, een link naar de voertuigdetailpagina, de opgeslagen criteria en een afmeldlink.

Beide e-mails worden als platte tekst verzonden met het geconfigureerde e-mailadres van de site als afzender. De e-mailinhoud is momenteel niet configureerbaar via de beheerinterface; aanpassing vereist interventie op codeniveau via WordPress-filters.

Functieschakelaar

Instelling	Optiesleutel	Standaard	Beschrijving
Zoekagent inschakelen	`as24ci_feature_search_agent`	Aan	Hoofdschakelaar voor de zoekagent-functie

Operationele opmerkingen

De plugin verzendt alleen meldingen voor nieuw geïmporteerde voertuigen. Voertuigen die al in het systeem stonden toen een bezoeker zich aanmeldde, activeren geen melding. Voertuigen die worden bijgewerkt (opnieuw geïmporteerd) activeren ook geen meldingen.
Het aanmeldingsformulier bevat een honeypot-veld om bot-inzendingen te verminderen. Als het verborgen veld is ingevuld, wordt de inzending geruisloos geaccepteerd, maar wordt er geen aanmelding aangemaakt.
Aanmeldingen worden opgeslagen in een speciale aangepaste databasetabel. De tabel wordt automatisch aangemaakt tijdens de activatie van de plugin en indien nodig bijgewerkt bij het laden van de plugin.
Het token dat wordt gebruikt voor bevestigings- en afmeldlinks is een cryptografisch veilige hex-tekenreeks van 64 tekens. Het token is ingebed in de bevestigings- en afmeld-URL's als een GET-parameter.
Bevestigingslinks hebben het formaat: /?as24ci_sa_action=confirm&token=[token]
Afmeldlinks hebben het formaat: /?as24ci_sa_action=unsubscribe&token=[token]
Na een succesvolle bevestiging wordt de bezoeker doorgestuurd naar de homepage met ?as24ci_sa_msg=confirmed.
Na het afmelden wordt de bezoeker doorgestuurd naar de homepage met ?as24ci_sa_msg=unsubscribed.
Beheerders kunnen aanmeldingen bekijken, bewerken, pauzeren en verwijderen via het beheerpaneel van de plugin.

Problemen oplossen

Het aanmeldingsformulier verschijnt niet op de archiefpagina.

Controleer of de Zoekagent-functie is ingeschakeld in de plugin-instellingen.
Controleer of de [as24ci_archive] shortcode of het native CPT-archief wordt gebruikt. Het zoekagentformulier maakt deel uit van de archieftemplate.
Als het formulier wel wordt gerenderd maar niet zichtbaar is, controleer dan op CSS-overrides van het thema of de configuratie van de Layout Manager die de widget mogelijk verbergt.

De bezoeker heeft geen bevestigingsmail ontvangen.

Controleer of WordPress e-mail kan verzenden. Gebruik een plugin zoals WP Mail SMTP om de e-mailbezorging te testen.
Controleer het spamfilter van de site; bevestigingsmails van WordPress kunnen soms als ongewenst worden gemarkeerd.
Controleer of het e-mailadres van de bezoeker geldig is en correct is ingevoerd.

De bevestigingslink werkt niet.

Zorg ervoor dat de link in een browser wordt geopend en niet wordt afgebroken door een e-mailclient.
Controleer of de permalink-instellingen van de site het verwerken van query-parameters toestaan.
Als er meer dan eens op de link is geklikt, zal de tweede klik de status niet bijwerken (de rij wordt slechts eenmaal bijgewerkt van pending naar active).

Er worden geen meldingsmails verzonden wanneer voertuigen worden geïmporteerd.

Controleer of ten minste één aanmelding de status active heeft.
Controleer of de geïmporteerde voertuigen nieuw waren (geen updates van bestaande voertuigen). De plugin verzendt geen meldingen voor opnieuw geïmporteerde of bijgewerkte voertuigen.
Controleer of het voertuig voldoet aan de criteria van de abonnee: alle criteria gebruiken EN-logica, dus een voertuig moet overeenkomen met elk opgegeven veld.