Documentazione · Guida del frontend

Preferiti

Questo documento copre la funzionalità dei preferiti (wishlist) del plugin ADP Car Market Hub WordPress: come i visitatori salvano i veicoli, come funziona la pagina dei preferiti, quali dati vengono mostrati e quali limitazioni si applicano.

Quando utilizzare questo documento

Leggi questo documento se stai configurando la funzionalità dei preferiti per la prima volta, se stai configurando quali dettagli del veicolo visualizzare nella pagina dei preferiti o se stai aiutando un visitatore a capire come salvare e ritrovare i veicoli.

Panoramica

La funzionalità dei preferiti consente ai visitatori di salvare i veicoli a cui sono interessati e di visualizzarli in un secondo momento in una pagina dedicata ai preferiti. Gli ID dei veicoli salvati vengono memorizzati nel localStorage del browser. Non è richiesto alcun account o login.

Quando un visitatore apre la pagina dei preferiti, il plugin recupera i dati correnti del veicolo per tutti gli ID salvati da un endpoint REST API e renderizza l'elenco in modo dinamico. Ciò significa che la pagina dei preferiti riflette sempre lo stato corrente dell'annuncio del veicolo, inclusi eventuali cambi di prezzo o veicoli che sono stati rimossi dopo essere stati salvati.

Requisiti o prerequisiti

La funzionalità dei preferiti deve essere abilitata nelle impostazioni del plugin (è abilitata per impostazione predefinita).
Una pagina dei preferiti deve esistere in WordPress con lo shortcode [as24ci_favorites] nel suo contenuto.
La REST API di WordPress deve essere accessibile pubblicamente affinché la pagina dei preferiti possa caricare i dati del veicolo.

Istruzioni passo-passo

Configurare la pagina dei preferiti

Nell'amministrazione di WordPress, vai su Pagine → Aggiungi nuova.
Assegna alla pagina un titolo come "I miei preferiti" o "Veicoli salvati".
Nel contenuto della pagina, aggiungi lo shortcode [as24ci_favorites].
Pubblica la pagina.

La pagina dei preferiti renderizza un contenitore che viene popolato tramite JavaScript al caricamento della pagina. Non è richiesta alcuna configurazione aggiuntiva dello shortcode.

Salvare un veicolo come visitatore

Nell'archivio dei veicoli, individua la scheda di un veicolo. Un pulsante dei preferiti (icona a forma di cuore) appare sulla scheda quando la funzionalità dei preferiti e l'elemento favorite_btn sono entrambi abilitati.
Fai clic sul pulsante del cuore per aggiungere il veicolo ai tuoi preferiti. Il pulsante cambia stato per indicare che il veicolo è salvato.
Fai clic nuovamente sul pulsante per rimuovere il veicolo dai tuoi preferiti.

Lo stesso pulsante dei preferiti è disponibile sulle singole pagine di dettaglio del veicolo nella barra delle azioni fluttuante e fissa.

Visualizzare i preferiti salvati

Naviga alla pagina dei preferiti.
La pagina si carica ed effettua una chiamata all'endpoint REST del plugin per recuperare i dati correnti di tutti gli ID dei veicoli salvati.
Ogni veicolo salvato viene visualizzato come una scheda con la sua immagine, titolo, prezzo e i campi delle specifiche configurati.
Fai clic su "Più dettagli" su una scheda per aprire la pagina di dettaglio completa del veicolo.

Se non ci sono veicoli salvati, la pagina mostra il messaggio "Non hai ancora nessun preferito salvato."

Riferimento di configurazione

Impostazioni dei preferiti

Impostazione	Posizione	Descrizione
Abilita preferiti	Impostazioni del plugin → Impostazioni (o Configurazione guidata)	Abilita o disabilita l'intera funzionalità dei preferiti
Campi preferiti	Layout Manager → Preferiti	Quali campi del veicolo vengono mostrati su ciascuna scheda dei preferiti

Campi della pagina dei preferiti

I campi del veicolo mostrati su ciascuna scheda dei preferiti sono controllati dalla zona Layout Manager → Preferiti. I seguenti campi sono supportati e possono essere abilitati o disabilitati singolarmente:

ID Campo	Descrizione
`price`	Prezzo di vendita (formattato con valuta)
`mileage`	Chilometraggio in km
`firstRegistrationYear`	Anno di immatricolazione
`fuelType`	Tipo di carburante
`transmissionType`	Trasmissione
`bodyType`	Tipo di carrozzeria
`conditionType`	Stato (nuovo o usato)
`horsePower`	Potenza in CV
`bodyColorText`	Colore esterno
`doors`	Numero di porte
`seats`	Numero di posti
`driveType`	Tipo di trazione
`co2Emission`	Emissioni di CO₂ in g/km
`consumptionCombined`	Consumo di carburante combinato in l/100 km
`energyLabel`	Classe energetica
`firstRegistrationDate`	Data di prima immatricolazione (formattata)
`warrantyType`	Tipo di garanzia

I campi senza valore per un veicolo, o i campi numerici con valore pari a zero, vengono omessi dalla scheda di quel veicolo. L'ordine dei campi segue la configurazione della zona.

Pulsante preferiti della scheda archivio

Il pulsante dei preferiti appare sulle schede dell'archivio veicoli quando:

La funzionalità dei preferiti è abilitata nelle impostazioni del plugin (FEATURE_FAVORITES).
L'elemento favorite_btn è abilitato nella zona Layout Manager → Schede Archivio.

Il pulsante mostra un'icona a forma di cuore e attiva/disattiva lo stato di salvataggio quando viene cliccato.

Note operative

Gli ID dei veicoli sono memorizzati nel localStorage del browser. I preferiti persistono durante la navigazione tra le pagine e sopravvivono ai ricaricamenti della pagina all'interno dello stesso browser. La cancellazione dei dati del browser (cookie e memoria locale) rimuove tutti i preferiti salvati.
I preferiti non sono condivisi tra dispositivi o browser diversi. Non esiste un salvataggio dell'account lato server per i preferiti.
La pagina dei preferiti recupera i dati dei veicoli dall'endpoint REST POST /wp-json/as24ci/v1/favorites a ogni caricamento della pagina. Il corpo della richiesta contiene un array di ID dei post.
L'endpoint REST impone un limite massimo di 50 veicoli per richiesta. Se in localStorage sono memorizzati più di 50 veicoli, vengono recuperati solo i primi 50.
L'endpoint REST restituisce solo i veicoli pubblicati del corretto tipo di post. I veicoli che sono stati non pubblicati o eliminati dopo essere stati salvati vengono esclusi silenziosamente dalla risposta.
L'anno di immatricolazione viene risolto utilizzando una catena di priorità: prima dalla chiave meta mappata per firstRegistrationYear, poi dalla chiave meta legacy _as24ci_year e infine dal Vehicle Field Resolver che controlla la tabella personalizzata e le colonne dei dati grezzi.
Le date (data di prima immatricolazione) sono formattate utilizzando l'impostazione del formato data del sito di WordPress.
I campi numerici come la potenza e il consumo di carburante vengono omessi se il loro valore è zero o vuoto, in modo che la scheda non mostri "0 CV" o "0.0 l/100 km".
L'asset JavaScript dei preferiti viene accodato nelle pagine dell'archivio veicoli, nelle pagine dei singoli veicoli e nelle pagine che contengono lo shortcode [as24ci_favorites] o [as24ci_archive].
Il CSS dei preferiti e gli eventuali stili inline di design configurati vengono accodati insieme al JavaScript.

Risoluzione dei problemi

Il pulsante dei preferiti non appare sulle schede dei veicoli.

Verifica che la funzionalità dei preferiti sia abilitata nelle impostazioni del plugin.
Controlla la zona Layout Manager → Schede Archivio e conferma che favorite_btn sia abilitato.

La pagina dei preferiti mostra "Caricamento preferiti..." e non si aggiorna.

Verifica che la REST API di WordPress sia accessibile. Molti plugin di sicurezza o configurazioni del server bloccano l'accesso alla REST API agli utenti non loggati.
Apri la console di sviluppo del browser e controlla la presenza di errori JavaScript o richieste di rete non andate a buon fine.
Conferma che la pagina contenga lo shortcode [as24ci_favorites].

La pagina dei preferiti mostra "Impossibile caricare i preferiti."

La richiesta REST a /wp-json/as24ci/v1/favorites è fallita o ha restituito un errore. Verifica che la REST API funzioni correttamente.
Verifica che le impostazioni dei permalink del sito consentano la risoluzione degli URL della REST API.

I veicoli salvati scompaiono dopo il riavvio del browser.

localStorage persiste dopo il riavvio del browser in tutti i browser moderni. Se i preferiti scompaiono, il browser potrebbe essere configurato per cancellare la memoria alla chiusura, oppure potrebbe essere in uso una modalità di navigazione privata (finestra in incognito/privata).

Un veicolo che era stato salvato non viene più mostrato nella pagina dei preferiti.

Il veicolo potrebbe essere stato rimosso dalla pubblicazione o eliminato dall'amministrazione di WordPress dopo essere stato salvato. L'endpoint REST restituisce solo i veicoli pubblicati.

La pagina dei preferiti mostra solo una parte dei veicoli salvati.

L'endpoint REST restituisce un massimo di 50 veicoli. Se in localStorage sono salvati più di 50 veicoli, vengono recuperati solo i primi 50.