Documentazione · Guida del frontend

Search Alerts Frontend

Questo documento copre la funzionalità Search Agent (Smart Stock Alerts) del plugin ADP Car Market Hub WordPress: come i visitatori si iscrivono per ricevere notifiche, come funziona la conferma tramite double opt-in e come funziona la disiscrizione.

Quando utilizzare questo documento

Leggi questo documento se stai configurando la funzionalità degli avvisi di ricerca per la prima volta, se stai aiutando un visitatore a capire come iscriversi e gestire i propri avvisi, o se stai risolvendo problemi relativi a iscrizioni e notifiche.

Panoramica

La funzionalità Search Agent consente ai visitatori di salvare un set di criteri di ricerca e ricevere una notifica via email ogni volta che un nuovo veicolo corrispondente a tali criteri viene importato nel sistema. Questa funzionalità utilizza un flusso di lavoro double opt-in conforme al GDPR: il visitatore deve fare clic su un link di conferma nella propria email prima che le notifiche vengano attivate.

I visitatori possono disiscriversi in qualsiasi momento facendo clic sul link di disiscrizione incluso in ogni email di notifica. Non è richiesto alcun account o login.

Requisiti o prerequisiti

La funzionalità Search Agent deve essere abilitata nelle impostazioni del plugin (è abilitata per impostazione predefinita, controllata da FEATURE_SEARCH_AGENT).
Il sito WordPress deve essere in grado di inviare email. Se l'invio di email transazionali non è configurato sul tuo hosting, valuta l'uso di un plugin SMTP. Senza una consegna email funzionante, le email di conferma e di notifica non verranno inviate.
Il modulo di iscrizione al search agent deve essere visibile nella pagina dell'archivio. Il plugin esegue il rendering del modulo come parte del template dell'archivio quando la funzionalità è abilitata.

Istruzioni passo-passo

Visitatore: iscriversi agli avvisi di ricerca

Apri la pagina dell'archivio veicoli.
Individua il modulo Search Agent sotto o accanto ai filtri di ricerca.
Compila almeno un criterio di ricerca (come marca, modello, fascia di prezzo o chilometraggio massimo).
Inserisci un indirizzo email nel campo di iscrizione.
Invia il modulo.
Viene visualizzato un messaggio di successo: "Quasi fatto! Controlla la tua casella di posta e conferma il tuo indirizzo email."
Apri l'email di conferma e fai clic sul link di conferma.
Sul sito viene mostrato un messaggio di conferma. L'iscrizione è ora attiva.

Da questo momento in poi, il visitatore riceverà una notifica via email ogni volta che viene importato un nuovo veicolo corrispondente ai criteri salvati.

Visitatore: disiscriversi dagli avvisi

Apri una qualsiasi email di notifica ricevuta dal sistema di avvisi di ricerca.
Fai clic sul link disiscriviti (unsubscribe) in fondo all'email.
Viene mostrata una pagina di conferma. L'iscrizione viene disattivata immediatamente.

L'azione di disiscrizione è irreversibile dal lato del visitatore; il visitatore dovrà iscriversi nuovamente per ricevere avvisi futuri.

Riferimento di configurazione

Criteri del search agent

Il modulo di iscrizione acquisisce i seguenti criteri. Il visitatore deve fornirne almeno uno affinché l'iscrizione venga accettata:

Criterio	Descrizione
`make`	Marca del veicolo
`model`	Modello del veicolo
`body_type`	Carrozzeria
`drive_type`	Trazione
`condition`	Stato: nuovo o usato
`color`	Colore esterno
`min_price`	Prezzo minimo
`max_price`	Prezzo massimo
`mileage_max`	Chilometraggio massimo
`status`	Filtro stato (nuovo, usato o tutti)

Tutti i criteri utilizzano la logica AND: un veicolo deve corrispondere a ogni criterio specificato per attivare una notifica. Un criterio vuoto viene ignorato.

Stati dell'iscrizione

Ogni iscrizione è memorizzata nella tabella personalizzata {prefix}as24ci_search_agents del plugin e presenta uno dei seguenti stati:

Stato	Significato
`pending`	Email di double opt-in inviata; il visitatore non ha ancora confermato
`active`	Confermato; le notifiche vengono inviate per i veicoli corrispondenti
`inactive`	Disiscritto dal visitatore
`paused`	Sospeso manualmente da un amministratore nel pannello di amministrazione del plugin

Template delle email

Il plugin invia automaticamente due tipi di email:

Email di conferma (inviata al momento dell'iscrizione):

Oggetto: "Conferma il tuo search agent"
Contiene i criteri salvati dal visitatore e il link di conferma.

Email di notifica corrispondenza (inviata quando viene importato un nuovo veicolo corrispondente):

Oggetto: "Nuovo veicolo corrispondente: [titolo del veicolo]"
Contiene il titolo del veicolo, un link alla pagina di dettaglio del veicolo, i criteri salvati e un link di disiscrizione.

Entrambe le email vengono inviate come testo normale utilizzando l'indirizzo email configurato del sito come mittente. Il contenuto delle email non è attualmente configurabile dall'interfaccia di amministrazione; la personalizzazione richiede un intervento a livello di codice tramite i filtri WordPress.

Attivazione/disattivazione funzionalità

Impostazione	Chiave opzione	Predefinito	Descrizione
Abilita Search Agent	`as24ci_feature_search_agent`	On	Interruttore principale per la funzionalità degli avvisi di ricerca

Note operative

Il plugin invia notifiche solo per i veicoli appena importati. I veicoli che erano già presenti nel sistema quando un visitatore si è iscritto non attivano alcuna notifica. Anche i veicoli che vengono aggiornati (re-importati) non attivano notifiche.
Il modulo di iscrizione include un campo honeypot per ridurre gli invii da parte di bot. Se il campo nascosto viene compilato, l'invio viene accettato silenziosamente ma non viene creata alcuna iscrizione.
Le iscrizioni sono memorizzate in una tabella di database personalizzata dedicata. La tabella viene creata automaticamente durante l'attivazione del plugin e aggiornata secondo necessità al caricamento del plugin.
Il token utilizzato per i link di conferma e disiscrizione è una stringa esadecimale di 64 caratteri crittograficamente sicura. Il token è incorporato negli URL di conferma e disiscrizione come parametro GET.
I link di conferma hanno il formato: /?as24ci_sa_action=confirm&token=[token]
I link di disiscrizione hanno il formato: /?as24ci_sa_action=unsubscribe&token=[token]
Dopo una conferma andata a buon fine, il visitatore viene reindirizzato alla homepage con ?as24ci_sa_msg=confirmed.
Dopo la disiscrizione, il visitatore viene reindirizzato alla homepage con ?as24ci_sa_msg=unsubscribed.
Gli amministratori possono visualizzare, modificare, sospendere ed eliminare le iscrizioni dal pannello di amministrazione del plugin.

Risoluzione dei problemi

Il modulo di iscrizione non appare nella pagina dell'archivio.

Verifica che la funzionalità Search Agent sia abilitata nelle impostazioni del plugin.
Controlla che venga utilizzato lo shortcode [as24ci_archive] o l'archivio CPT nativo. Il modulo del search agent fa parte del template dell'archivio.
Se il modulo viene renderizzato ma non è visibile, controlla eventuali sovrascritture CSS del tema o la configurazione del Layout Manager che potrebbero nascondere il widget.

Il visitatore non ha ricevuto l'email di conferma.

Verifica che WordPress sia in grado di inviare email. Utilizza un plugin come WP Mail SMTP per testare la consegna delle email.
Controlla la cartella spam del sito; le email di conferma provenienti da WordPress a volte possono essere contrassegnate come posta indesiderata.
Conferma che l'indirizzo email del visitatore sia valido e sia stato inserito correttamente.

Il link di conferma non funziona.

Assicurati che il link venga aperto in un browser e non sia troncato da un client di posta elettronica.
Verifica che le impostazioni dei permalink del sito consentano l'elaborazione dei parametri di query.
Se si è fatto clic sul link più di una volta, il secondo clic non aggiornerà lo stato (la riga viene aggiornata da pending a active una sola volta).

Le email di notifica non vengono inviate quando i veicoli vengono importati.

Controlla che almeno un'iscrizione abbia lo stato active.
Conferma che i veicoli importati fossero nuovi (non aggiornamenti di veicoli esistenti). Il plugin non invia notifiche per veicoli re-importati o aggiornati.
Verifica che il veicolo soddisfi i criteri dell'iscritto: tutti i criteri utilizzano la logica AND, quindi un veicolo deve corrispondere a ogni campo specificato.