Flusso di lavoro per l'uso del frontend

Questo documento descrive come i visitatori interagiscono con l'inventario dei veicoli sul lato pubblico (frontend) di un sito WordPress basato sul plugin ADP Car Market Hub. Copre la pagina di archivio dei veicoli, le pagine di dettaglio, i controlli dei filtri, i Preferiti, il Confronto, i moduli di contatto e di prenotazione del test drive, il calcolatore di finanziamento, la condivisione sui social, la scheda tecnica in PDF e gli Avvisi di ricerca.

Quando utilizzare questo documento

Leggere questo documento se si desidera:

• Comprendere cosa vedono i visitatori e quali azioni possono intraprendere sul frontend.
• Configurare o testare le funzionalità del frontend (filtri, preferiti, confronto, moduli e così via).
• Verificare che il frontend mostri correttamente l'inventario dopo un'importazione.
• Integrare gli shortcode nelle pagine WordPress.

Per la configurazione di queste funzionalità da parte dell'amministratore, consultare il Manuale dell'amministratore.

---

Panoramica

Il plugin mostra l'inventario dei veicoli sul frontend di WordPress utilizzando un custom post type dedicato (as24ci_car) e un set di template integrati. Le aree principali del frontend sono:

• Pagina di archivio dei veicoli — una griglia impaginata di tutte le schede dei veicoli pubblicati.
• Pagina di dettaglio del veicolo — le informazioni complete di un singolo veicolo.
• Pagina di confronto — confronto affiancato dei veicoli selezionati.
• Pagina dei preferiti — un elenco di veicoli salvati dal visitatore.

Queste pagine possono essere fornite tramite l'URL dell'archivio CPT di WordPress, gli URL degli archivi delle tassonomie native o le pagine WordPress contenenti gli shortcode del plugin.

---

Requisiti o prerequisiti

• Almeno un veicolo deve essere importato e pubblicato (stato del post: publish) prima che appaia qualsiasi cosa sul frontend.
• L'archivio dei veicoli e le pagine di confronto/preferiti devono essere pagine WordPress pubblicate contenenti gli shortcode appropriati, oppure l'archivio CPT di WordPress deve essere accessibile tramite la struttura dei permalink.
• Funzionalità come Preferiti, Confronto, Calcolatore di finanziamento, Test Drive, Condivisione sui social e Avvisi di ricerca devono essere abilitate prima di apparire sul frontend. I selettori per Preferiti e Confronto si trovano nella scheda Settings (e nella Configurazione guidata); la Condivisione sui social si configura sotto Design & Styles; gli Avvisi di ricerca sono gestiti nella scheda dedicata Search Alerts; la prenotazione del Test Drive e il Calcolatore di finanziamento sono configurati rispettivamente nella scheda Leads e nella sezione delle impostazioni di finanziamento. Verificare la posizione corrente nella versione del plugin installata, poiché il layout dell'amministratore può evolvere tra i rilasci.
• Per la funzionalità Test Drive, i giorni feriali disponibili, la finestra temporale, la durata dello slot e (opzionalmente) le date di esclusione devono essere configurati nella scheda Leads.

---

Pagina di archivio dei veicoli

Visualizzazione

La pagina di archivio mostra i veicoli pubblicati come una griglia basata su schede. Ogni scheda mostra:

• Immagine del veicolo (miniatura).
• Badge delle condizioni (Nuovo, Usato, In offerta o Migliore offerta — configurabile in Design & Styles).
• Titolo del veicolo (marca, modello, variante).
• Specifiche chiave (anno, chilometraggio, tipo di carburante, potenza).
• Prezzo.
• Pulsante a cuore dei Preferiti (se la funzionalità Preferiti è abilitata).
• Pulsante Confronta (se la funzionalità Confronto è abilitata).
• Link alla pagina di dettaglio del veicolo.

Il numero di veicoli per pagina è configurabile (12, 24, 48, 72 o tutti) e può essere modificato tramite il selettore per pagina nella barra laterale dei filtri o nella barra degli strumenti.

Shortcode

L'archivio può essere incorporato in qualsiasi pagina WordPress utilizzando:

[as24ci_archive]

Lo shortcode supporta attributi opzionali di sovrascrittura dei filtri, ad esempio:

[as24ci_archive make="BMW" per_page="12"]

Ordinamento

Quando il filtro di ordinamento è abilitato, i visitatori possono ordinare i veicoli per:

• Più recenti prima (impostazione predefinita: per data di importazione/pubblicazione, decrescente)
• Prezzo: dal più basso al più alto
• Prezzo: dal più alto al più basso
• Chilometraggio: dal più basso al più alto
• Anno: più recenti prima
• Anno: più vecchi prima

Verificare le opzioni di ordinamento esatte disponibili nella propria versione del plugin.

---

Filtri dell'archivio

La barra laterale dei filtri nella pagina di archivio consente ai visitatori di restringere l'elenco dei veicoli. Ogni filtro può essere abilitato o disabilitato singolarmente in ADP Car Market Hub → Layout Manager.

Filtri standard

Filtri avanzati

Applicazione dei filtri

I filtri vengono applicati tramite parametri di query dell'URL. La selezione di un'opzione di filtro ricarica o aggiorna l'archivio con i risultati filtrati. È possibile combinare più filtri. La cancellazione di un filtro lo rimuove dalla query.

---

Pagina di dettaglio del veicolo

La pagina di dettaglio del veicolo è la vista del singolo veicolo che mostra le informazioni complete dell'annuncio.

Sezioni di contenuto

I campi specifici visualizzati nella tabella delle specifiche sono controllati dalle impostazioni della scheda Mapping, dove ogni campo può essere mostrato o nascosto e la sua etichetta personalizzata.

---

Modulo di contatto

Il modulo di contatto integrato è mostrato in ogni pagina di dettaglio del veicolo e consente ai visitatori di inviare una richiesta sul veicolo.

Campi

• Nome — obbligatorio.
• Email — obbligatorio. Deve essere un indirizzo email valido.
• Telefono — opzionale (abilitare/disabilitare nelle impostazioni dei Leads).
• Messaggio — opzionale (abilitare/disabilitare nelle impostazioni dei Leads).
• Casella di controllo del consenso — opzionale (abilitare e configurare nelle impostazioni dei Leads). Se abilitata, il visitatore deve selezionare la casella prima dell'invio.

Spam e limitazione della frequenza (rate limiting)

• Honeypot: nel modulo è incluso un campo nascosto. I bot automatizzati in genere lo compilano; se compilato, l'invio viene rifiutato silenziosamente senza creare un lead o inviare un'email.
• Limitazione della frequenza: vengono accettati fino a 5 invii per indirizzo IP ogni 5 minuti. Gli invii oltre questa soglia ricevono una risposta di errore.

Dopo l'invio

• Il visitatore viene reindirizzato all'ancora #as24ci-contact sulla pagina del veicolo con un indicatore di successo o di errore.
• Un messaggio di successo conferma che la richiesta è stata ricevuta.
• Viene mostrato un messaggio di errore se l'invio non è andato a buon fine (ad esempio, manca un campo obbligatorio o è stato superato il limite di frequenza).

I messaggi di successo e di errore sono configurabili nelle impostazioni dei Leads.

---

Scheda contatto CMH Team

Quando un contatto di vendita della concessionaria è configurato in CMH Team, la pagina di dettaglio del veicolo mostra quella persona come contatto per l'annuncio.

• La scheda mostra il nome del contatto e (ove forniti) la foto, l'indirizzo email e il numero di telefono, con link cliccabili per inviare un'email o avviare una chiamata.
• Il contatto mostrato è quello risolto per lo specifico veicolo: un contatto assegnato direttamente all'auto ha la precedenza, seguito dal contatto impostato per la sede dell'auto, e infine dal contatto predefinito globale.
• Se non si applica alcun contatto CMH Team, la pagina ripiega sui dettagli del profilo del venditore dell'autore del veicolo.
• Lo stesso contatto risolto viene utilizzato anche come destinatario preferito per le richieste inviate tramite il modulo di contatto (vedere Flusso di lavoro per la gestione dei lead).

Gli amministratori gestiscono questi contatti nel menu CMH Team; vedere il Manuale dell'amministratore.

---

Prenotazione del Test Drive

Quando la funzionalità Test Drive è abilitata, un modulo di prenotazione del test drive è disponibile in ogni pagina di dettaglio del veicolo (spesso visualizzato come una scheda accanto al modulo di contatto).

Come funziona

1. Il visitatore seleziona una data da un selettore di date. Le date nel passato e le date che cadono in un giorno non configurato come disponibile non sono selezionabili.
2. In base alla data selezionata, gli slot orari disponibili vengono caricati dinamicamente. Gli slot vengono generati a partire dall'ora di inizio, dall'ora di fine e dalla durata dello slot configurate (ad esempio, 09:00–17:00 in intervalli di 30 minuti).
3. Il visitatore seleziona uno slot orario e inserisce il proprio nome, email e numero di telefono opzionale.
4. All'invio, viene creata una richiesta di test drive come lead con is_test_drive = 1 e il campo appointment_date impostato.
5. Vengono inviate le notifiche email standard (con "Richiesta di Test Drive" indicata nell'oggetto e nel corpo).

Configurazione (per gli amministratori)

• Giorni feriali disponibili — quali giorni della settimana consentono i test drive (dal lunedì alla domenica).
• Ora di inizio / Ora di fine — la finestra temporale giornaliera per gli slot (ad esempio, 08:00–18:00).
• Durata dello slot — lunghezza di ciascun slot orario in minuti (minimo 5 minuti).
• Date di esclusione — date specifiche (inserite come YYYY-MM-DD, una per riga) in cui non sono disponibili test drive, indipendentemente dall'impostazione del giorno della settimana.

---

Calcolatore di finanziamento

Quando la funzionalità Calcolatore di finanziamento è abilitata, nelle pagine di dettaglio del veicolo viene mostrato uno stimatore interattivo della rata mensile.

Il calcolatore utilizza:

• Il prezzo del veicolo dall'annuncio importato.
• Il tasso di interesse — valore predefinito configurabile (scheda Loans nelle impostazioni delle Features).
• La durata del prestito — valore predefinito configurabile in mesi (12, 24, 36, 48, 60, 72 o 84 mesi).
• L'anticipo — valore predefinito configurabile come percentuale del prezzo del veicolo.

I visitatori possono regolare il tasso, la durata e l'anticipo per vedere diverse stime di pagamento. Il risultato è una cifra calcolata della rata mensile visualizzata sulla pagina. Questo calcolatore ha solo scopo illustrativo; le condizioni di finanziamento effettive dipendono dal fornitore finanziario del cliente.

---

---

Preferiti (Lista dei desideri)

Quando la funzionalità Preferiti è abilitata, i visitatori possono salvare i veicoli in una lista dei desideri personale.

Come funziona

• Un pulsante con l'icona di un cuore appare su ogni scheda veicolo nell'archivio e nella pagina di dettaglio del veicolo.
• Facendo clic sul cuore si aggiunge il veicolo ai preferiti del visitatore. Facendo nuovamente clic lo si rimuove.
• I preferiti sono memorizzati nel browser del visitatore (localStorage). Non è richiesto alcun login o account.
• I preferiti sono specifici del dispositivo e del browser — non si sincronizzano tra dispositivi o browser diversi e vengono cancellati se il visitatore svuota la memoria del browser.
• È possibile memorizzare contemporaneamente un massimo di 50 veicoli nei preferiti.

Pagina dei preferiti

Incorpora la pagina dei preferiti su qualsiasi pagina WordPress utilizzando lo shortcode:

[as24ci_favorites]

La pagina recupera i dati del veicolo per gli ID memorizzati tramite un endpoint REST API e restituisce un elenco con i campi configurati. I campi visibili sono configurabili nel Layout Manager (zona Preferiti).

---

Confronto veicoli

Quando la funzionalità Confronta è abilitata, i visitatori possono selezionare più veicoli per un confronto affiancato.

Come funziona

• Un pulsante Confronta appare sulle schede dell'archivio e sulla barra delle azioni fluttuante della pagina del singolo veicolo.
• Facendo clic sul pulsante si attiva/disattiva il veicolo nella selezione di confronto.
• I veicoli selezionati sono memorizzati in localStorage. Non è richiesto alcun login.
• Il numero massimo di veicoli che possono essere confrontati contemporaneamente è configurabile (impostazione predefinita: 4). Al raggiungimento del limite massimo, un messaggio informa il visitatore.
• Una barra fluttuante o un indicatore mostra solitamente quanti veicoli sono selezionati e fornisce un link alla pagina di confronto.

Pagina di confronto

La pagina di confronto viene renderizzata dallo shortcode:

[as24ci_compare]

Questa pagina mostra i veicoli selezionati in una tabella affiancata per un facile confronto delle specifiche. Se non è selezionato alcun veicolo, viene mostrato un messaggio informativo.

---

Condivisione social

Quando la Condivisione social è abilitata, una riga di pulsanti di condivisione appare sulle pagine di dettaglio del veicolo. Non vengono caricati SDK JavaScript esterni — tutti i pulsanti sono collegamenti standard basati su URL.

Reti supportate

• WhatsApp — apre la finestra di dialogo di condivisione di WhatsApp.
• Facebook — apre la finestra di dialogo di condivisione di Facebook.
• Instagram — Instagram non supporta la condivisione web diretta basata su URL; il comportamento del pulsante per Instagram può variare. Verificare nella versione corrente del plugin.
• X (precedentemente Twitter) — apre la finestra di composizione di X/Twitter con l'URL del veicolo precompilato.
• E-mail — apre il client di posta elettronica predefinito del visitatore con un oggetto e un corpo precompilati.
• Copia link — copia l'URL del veicolo negli appunti del visitatore.

Le singole reti possono essere abilitate o disabilitate nelle impostazioni delle Funzionalità. Anche il posizionamento (ad esempio, sopra o sotto la descrizione) è configurabile.

---

PDF datasheet

Quando la funzionalità PDF datasheet è abilitata, i visitatori possono aprire una pagina HTML ottimizzata per la stampa per qualsiasi veicolo, quindi utilizzare la funzione del proprio browser Stampa → Salva come PDF per creare un documento PDF.

Si accede alla pagina della scheda tecnica aggiungendo il parametro di query ?as24ci_pdf={post_id} all'URL del veicolo. Un pulsante o un link per attivare questa funzione è solitamente incluso nella pagina di dettaglio del veicolo quando la funzionalità è abilitata.

Campi configurabili

I seguenti campi possono essere inclusi o esclusi nella scheda tecnica (configurabili dagli amministratori):

Titolo del veicolo, prezzo, chilometraggio, prima immatricolazione, tipo di carburante, trasmissione, potenza, tipo di carrozzeria, colore esterno, porte, sedili, classe di emissione, valori di CO2, consumo energetico, elenco degli equipaggiamenti, descrizione, posizione e informazioni di contatto.

---

Avvisi di ricerca (Smart Stock Alerts)

Quando la funzionalità Avvisi di ricerca è abilitata, i visitatori possono iscriversi a una ricerca salvata e ricevere una notifica via e-mail quando viene importato un veicolo corrispondente.

Come funziona per i visitatori

1. Nella pagina dell'archivio, dopo aver applicato uno o più filtri, viene mostrato un modulo Salva ricerca / Iscriviti agli avvisi.
2. Il visitatore inserisce il proprio indirizzo e-mail e invia il modulo.
3. Viene inviata un'e-mail di conferma Double-Opt-In conforme al GDPR. L'iscrizione rimane in stato In attesa finché il visitatore non fa clic sul link di conferma contenuto nell'e-mail.
4. Dopo la conferma, l'iscrizione diventa Attiva. Da questo momento in poi, il visitatore riceve una notifica via e-mail ogni volta che viene importato un veicolo corrispondente ai criteri di filtro salvati.
5. Ogni e-mail di notifica include un link di disiscrizione. Facendo clic su di esso, l'iscrizione viene impostata su Inattiva (disiscritto).

Attivazione delle notifiche

Le notifiche vengono inviate automaticamente sull'hook di azione as24ci_vehicle_imported, che si attiva ogni volta che un veicolo viene creato o aggiornato durante un'esecuzione di importazione. Il plugin controlla tutte le iscrizioni attive e invia e-mail agli iscritti corrispondenti.

Vista amministratore

Le iscrizioni attive, in attesa, in pausa e disiscritte sono elencate nella scheda amministrativa Avvisi di ricerca. Gli amministratori possono filtrare, visualizzare ed eliminare le iscrizioni.

---

Note operative

• I filtri sono implementati come parametri di query URL. I visitatori possono salvare nei segnalibri le viste filtrate o condividere URL con filtri applicati.
• Preferiti e Confronta utilizzano il localStorage del browser. Svuotare la memoria del browser o utilizzare un dispositivo/browser diverso comporta la perdita della selezione salvata.
• Il modulo di contatto invia i dati alla pagina corrente con un parametro di query di successo o errore. JavaScript non è richiesto per l'invio del modulo; il modulo funziona con lo standard HTML POST.
• Il calcolatore finanziario è solo illustrativo. I risultati sono calcolati nel browser a partire dai valori predefiniti configurati. Non rappresentano un'offerta di credito vincolante.
• La disponibilità del test drive è valutata lato server. Le date e le fasce orarie disponibili derivano dalle impostazioni configurate al momento del caricamento della pagina.
• I link di condivisione social sono puri ancoraggi HTML. Non vengono caricati cookie di tracciamento o script di terze parti. Il tracciamento dei clic non è integrato.
• Il PDF datasheet è una pagina di stampa renderizzata dal browser, non un file PDF generato dal server. La qualità di stampa e il layout dipendono dal browser e dal sistema operativo del visitatore.
• Le e-mail di avviso di ricerca vengono inviate tramite WordPress wp_mail(), che utilizza la configurazione e-mail del server. Se la consegna delle e-mail non è affidabile, considerare la configurazione di SMTP.

---

Risoluzione dei problemi

---

Documenti correlati

• Manuale utente
• Flusso di lavoro per la gestione dei lead
• Flusso di lavoro per l'importazione dei veicoli
• Manuale dell'amministratore