Confronta

Questo documento copre la funzionalità di confronto dei veicoli del plugin ADP Car Market Hub WordPress: come i visitatori selezionano i veicoli da confrontare, come funziona la pagina di confronto e quali limitazioni si applicano.

Quando utilizzare questo documento

Leggi questo documento se stai configurando la funzionalità di confronto per la prima volta, se stai aiutando un visitatore a capire come usarla o se stai risolvendo problemi relativi a comportamenti imprevisti nella vista di confronto.

Panoramica

La funzionalità di confronto consente ai visitatori di selezionare fino a un numero configurabile di veicoli dall'archivio o dalle singole pagine di dettaglio del veicolo, per poi visualizzarli fianco a fianco su una pagina di confronto dedicata. La selezione viene memorizzata nel localStorage del browser e non richiede un account o l'accesso.

La pagina di confronto è una tabella a schermo intero con una colonna per veicolo. Ogni riga mostra la miniatura del veicolo, il titolo e i campi delle specifiche configurati. I veicoli vengono renderizzati nell'ordine in cui sono stati selezionati.

Requisiti o prerequisiti

• La funzionalità di confronto deve essere abilitata nelle impostazioni del plugin (è abilitata per impostazione predefinita).
• Una pagina di confronto deve essere configurata e accessibile. Il plugin può creare una pagina di confronto predefinita durante l'attivazione; puoi anche crearne una manualmente e assegnarla nelle impostazioni del plugin.
• La pagina di confronto deve contenere lo shortcode [as24ci_compare], oppure il plugin deve essere configurato per utilizzare la pagina tramite l'opzione as24cipagecompare_id in modo da poter risolvere l'URL di confronto.

Istruzioni passo-passo

Configurare la pagina di confronto

1. Nell'amministrazione di WordPress, vai su Pagine → Aggiungi nuova.
2. Assegna alla pagina un titolo come "Confronta veicoli".
3. Nel contenuto della pagina, aggiungi lo shortcode [as24ci_compare].
4. Pubblica la pagina.
5. Nelle impostazioni del plugin, prendi nota dell'ID della pagina. Il plugin utilizza l'ID della pagina di confronto memorizzato (as24ci_page_compare_id) per creare i link di confronto in tutto il sito. Se questa opzione non è impostata, il plugin utilizza come fallback home_url('/compare-cars/').

Utilizzare la funzionalità di confronto come visitatore

1. Sull'archivio dei veicoli, individua la scheda di un veicolo. Quando la funzionalità di confronto è abilitata e il pulsante di confronto è attivo nel Layout Manager, sulla scheda in sovrimpressione appare un pulsante con l'icona di confronto.
2. Fai clic sul pulsante di confronto per aggiungere il veicolo alla selezione di confronto. Il pulsante cambia stato per indicare che il veicolo è selezionato.
3. Ripeti l'operazione per gli altri veicoli che desideri confrontare. Il plugin impone un numero massimo configurabile di veicoli (impostazione predefinita: 4).
4. Dopo aver selezionato i veicoli desiderati, fai clic sul link o sul pulsante di confronto che appare (l'etichetta riporta "Confronta"). Questo reindirizza alla pagina di confronto.
5. La pagina di confronto si carica mostrando i veicoli selezionati affiancati in una tabella.

Lo stesso pulsante di confronto appare nella barra mobile adesiva sulle singole pagine di dettaglio del veicolo, consentendo ai visitatori di aggiungere un veicolo alla selezione di confronto mentre ne visualizzano i dettagli completi.

Aprire direttamente la pagina di confronto

La pagina di confronto legge gli ID dei veicoli dal parametro GET ids, che consiste in un elenco separato da virgole di ID dei post dei veicoli:

https://yoursite.com/compare-cars/?ids=123,456,789

L'interruttore di confronto in JavaScript crea automaticamente questo URL quando il visitatore fa clic sul link "Confronta".

Riferimento di configurazione

Impostazioni di confronto

Campi della tabella di confronto

I campi visualizzati nella tabella di confronto sono configurati nella zona Layout Manager → Confronta. Ogni campo abilitato appare come una riga nella tabella per ciascun veicolo selezionato. I campi disponibili e le loro etichette predefinite includono:

Potrebbero essere disponibili campi aggiuntivi a seconda dei dati del veicolo importati. Verifica l'elenco corrente nel Layout Manager del tuo plugin.

Le unità di misura vengono applicate automaticamente ai valori numerici:

• Prezzo: formattato con la valuta
• Chilometraggio, autonomia, chilometraggio della garanzia, capacità di traino, peso a vuoto, peso totale: km o kg a seconda dei casi
• CO₂: g/km
• Cilindrata: cm³
• Cavalli vapore: CV
• Consumo: l/100 km
• Capacità della batteria: kWh
• Consumo di energia: kWh/100 km
• Potenza di ricarica rapida: kW
• Durata della garanzia: mesi
• Campi booleani (hadAccident, inspected): visualizzati come Sì o No

I campi senza alcun valore per un veicolo mostrano un trattino lungo (—).

Pulsante di confronto della scheda dell'archivio

Il pulsante di confronto appare sulle schede dei veicoli nell'archivio quando:

• La funzionalità di confronto è abilitata nelle impostazioni del plugin (FEATURE_COMPARE).
• L'elemento compare_btn è abilitato nella zona Layout Manager → Schede archivio.

Il pulsante mostra un'icona di confronto e attiva o disattiva lo stato selezionato quando viene cliccato.

Note operative

• Le selezioni dei veicoli sono memorizzate in localStorage sotto una chiave gestita dal JavaScript di confronto. Le selezioni persistono durante la navigazione tra le pagine all'interno della stessa sessione del browser e sopravvivono ai ricaricamenti della pagina.
• La cancellazione dei dati del browser (cookie, memoria locale) reimposterà la selezione di confronto.
• La pagina di confronto legge il parametro GET ids e carica fino a 4 veicoli (limite massimo codificato nel template). Vengono caricati solo i veicoli pubblicati del tipo di post corretto; i veicoli non pubblicati o eliminati vengono esclusi silenziosamente.
• Il massimo configurabile (COMPARE_MAX_VEHICLES) controlla l'applicazione del limite tramite JavaScript durante la selezione. Il template lato server applica il proprio limite rigido di 4. Se il massimo configurabile supera 4, il server renderizzerà comunque al massimo 4 colonne.
• I dati del veicolo nella tabella di confronto vengono letti dalla tabella personalizzata {prefix}as24_vehicles del plugin quando disponibile, con fallback al payload API grezzo (colonna JSON raw_data) e poi ai post meta di WordPress per i veicoli legacy.
• La pagina di confronto può essere utilizzata sia come pagina WordPress autonoma (tramite lo shortcode [as24ci_compare]) sia come pagina basata su template. Entrambe generano lo stesso output.
• L'asset JavaScript di confronto viene accodato solo nelle pagine dell'archivio veicoli, nelle singole pagine dei veicoli e nelle pagine contenenti lo shortcode [as24ci_archive] o [as24ci_compare].

Risoluzione dei problemi

Il pulsante di confronto non appare sulle schede dei veicoli.

• Verifica che la funzionalità di confronto sia abilitata nelle impostazioni del plugin.
• Controlla la zona Layout Manager → Schede archivio e conferma che compare_btn sia abilitato.

Facendo clic sul pulsante di confronto viene visualizzato "Puoi confrontare fino a X veicoli."

• Il visitatore ha raggiunto il limite massimo configurato. Deve rimuovere un veicolo dalla selezione prima di poterne aggiungere un altro.

La pagina di confronto mostra "Nessun veicolo selezionato per il confronto."

• Il visitatore ha navigato verso la pagina di confronto senza alcun veicolo nella sua selezione localStorage.
• Questo può accadere anche se il browser non supporta localStorage o se questo è stato svuotato.

La pagina di confronto mostra meno veicoli del previsto.

• Vengono caricati solo i veicoli pubblicati. Se un veicolo è stato eliminato o rimosso dalla pubblicazione dopo essere stato aggiunto alla selezione di confronto, viene escluso dall'output.
• Il template impone un massimo di 4 veicoli indipendentemente dall'impostazione configurabile.

I link di confronto rimandano alla pagina sbagliata.

• Verifica che l'ID della pagina di confronto sia impostato correttamente nelle impostazioni del plugin (as24ci_page_compare_id). Se questa opzione manca o punta a una pagina eliminata, l'URL di confronto utilizza come fallback home_url('/compare-cars/').

Documenti correlati

• Archivio veicoli
• Pagine di dettaglio del veicolo
• Preferiti
• Riferimento shortcode