Pagine di dettaglio del veicolo

Questo documento copre la pagina di dettaglio del veicolo del plugin ADP Car Market Hub WordPress: la sua struttura dei contenuti, la galleria, le specifiche, la visualizzazione del prezzo, le azioni di contatto e il comportamento del template.

Quando utilizzare questo documento

Leggere questo documento se si ha la necessità di comprendere cosa viene visualizzato nella pagina di un singolo veicolo, come è configurato il layout della pagina, come i visitatori interagiscono con il modulo di contatto o come il template può essere personalizzato da uno sviluppatore di temi.

Panoramica

Ogni veicolo pubblicato ha la propria pagina di dettaglio. La pagina presenta il veicolo al visitatore in un layout strutturato con una galleria, specifiche chiave, dati tecnici, elenco degli equipaggiamenti, prezzi, un modulo di contatto e funzionalità opzionali come il calcolatore di finanziamento, il download della scheda tecnica in PDF, la condivisione sui social e le richieste di test drive.

La pagina di dettaglio del veicolo viene renderizzata dal template integrato del plugin (single-as24ci_car-classic.php). Il layout è suddiviso in tre zone configurabili gestite tramite il Layout Manager:

• Contenuto principale (colonna sinistra): galleria, descrizione, specifiche, dati energetici, equipaggiamento e blocchi aggiuntivi opzionali.
• Sidebar (colonna destra): box del prezzo, dati chiave e calcolatore di finanziamento.
• Sezione inferiore: modulo di contatto, informazioni sul concessionario e veicoli simili.

Il tema attivo può sovrascrivere il template inserendo un file single-as24ci_car.php nella directory del tema. Il plugin verifica la presenza di questa sovrascrittura prima di caricare il proprio template.

Requisiti o prerequisiti

• Il plugin deve essere installato e attivato.
• Almeno un veicolo deve essere stato importato e pubblicato.
• I permalink personalizzati devono essere abilitati in WordPress (Impostazioni → Permalink) affinché il formato URL predefinito del singolo veicolo funzioni. Senza i permalink personalizzati, le pagine dei singoli veicoli potrebbero non essere raggiungibili tramite la struttura URL prevista.

Istruzioni passo-passo

Navigare verso una pagina di dettaglio del veicolo

1. Dall'archivio dei veicoli, fare clic su qualsiasi scheda veicolo. Il collegamento rimanda alla pagina di dettaglio di quel veicolo.
2. In alternativa, andare nell'amministrazione di WordPress, aprire Vehicles e fare clic su Visualizza sotto il titolo di un veicolo per aprire la sua pagina di dettaglio nel front-end.

Configurare il layout del singolo veicolo

1. Nell'amministrazione del plugin, aprire il Layout Manager.
2. Selezionare la zona Single Vehicle – Main Content, Single Vehicle – Sidebar o Single Vehicle – Bottom.
3. Trascinare i blocchi per riordinarli o attivarne/disattivarne la visibilità.
4. Salvare la configurazione.

Le modifiche si applicano immediatamente a tutte le pagine di dettaglio del veicolo senza necessità di eseguire nuovamente l'importazione.

---

Configurazione di riferimento

Zone di layout e blocchi disponibili

I seguenti blocchi sono disponibili in ciascuna zona. La configurazione predefinita è mostrata sotto ogni zona; il Layout Manager consente di modificare l'ordine o di disabilitare i singoli blocchi.

Veicolo singolo – Contenuto principale (ordine predefinito):

1. gallery – Galleria immagini
2. description – Testo di descrizione del veicolo
3. specs – Tabella delle specifiche tecniche
4. energy – Dati su energia ed emissioni
5. equipment – Elenchi degli equipaggiamenti di serie e opzionali
6. warranty – Informazioni sulla garanzia

Veicolo singolo – Barra laterale (ordine predefinito):

1. price_box – Visualizzazione del prezzo con prezzo di listino e badge di risparmio
2. key_facts – Griglia delle informazioni chiave (marca, modello, chilometraggio, anno, tipo di carburante, ecc.)
3. financing_calc – Calcolatore di finanziamento (se abilitato)

Veicolo singolo – Parte inferiore (ordine predefinito):

1. contact_form – Modulo di contatto per richiesta informazioni con dati del venditore
2. dealer_info – Scheda informativa del concessionario (indipendente)
3. similar_vehicles – Veicoli correlati della stessa marca e modello

I blocchi aggiuntivi di questi elenchi possono essere inseriti in altre zone se il Layout Manager lo consente, ad eccezione del calcolatore di finanziamento che viene visualizzato al massimo in una sola zona (la barra laterale ha la priorità sul contenuto principale, il contenuto principale ha la priorità sulla parte inferiore).

Galleria

La galleria mostra tutte le immagini associate al veicolo. Le immagini vengono assemblate da due fonti: immagini importate (_as24ci_image_ids) e immagini caricate manualmente (_as24ci_manual_image_ids). Le immagini caricate manualmente appaiono per prime.

Opzioni di visualizzazione della galleria:

Se non sono disponibili immagini, la sezione della galleria non mostra un segnaposto di fallback per l'immagine principale.

Visualizzazione del prezzo

Il box del prezzo nella barra laterale mostra:

• Prezzo di vendita: il prezzo del veicolo importato o impostato manualmente, formattato con la valuta configurata.
• Prezzo di listino (se disponibile e superiore al prezzo di vendita): mostrato barrato, con la differenza di risparmio calcolata automaticamente.
• Valuta: utilizza il campo valuta specifico del veicolo o, in alternativa, la valuta predefinita configurata nelle impostazioni del plugin.

Barra laterale delle informazioni chiave

Il blocco delle informazioni chiave mostra una griglia con le specifiche importanti. I campi visibili e il loro ordine sono controllati dalla configurazione del blocco Registro dei campi → Informazioni chiave. Sono supportati i seguenti campi:

I campi che non hanno alcun valore per il veicolo corrente vengono nascosti automaticamente.

Specifiche tecniche

Il blocco specs nell'area del contenuto principale mostra un elenco dettagliato di campi tecnici. I campi visualizzati dipendono dai dati del veicolo e da ciò che è stato importato. Le unità di misura vengono applicate automaticamente:

• Chilometraggio: km
• Potenza del motore: CV / kW
• Cilindrata: cm³
• Emissioni di CO₂: g/km
• Consumo di carburante: l/100 km (urbano, extraurbano, combinato) o kg/100 km per il metano (CNG)
• Consumo di energia elettrica: kWh/100 km
• Capacità della batteria: kWh
• Autonomia: km
• Peso: kg
• Dimensioni (altezza, larghezza, lunghezza, passo): mm
• Volume del bagagliaio: l
• Potenza di ricarica: kW
• Tempo di ricarica: min

I valori vengono letti dalla tabella del database dei veicoli personalizzati del plugin, quando disponibili, con fallback sui post meta per i veicoli importati prima dell'attuale struttura della tabella.

Equipaggiamento

Il blocco equipment genera due elenchi:

• Equipaggiamento di serie: caratteristiche incluse di serie.
• Equipaggiamento opzionale: caratteristiche disponibili come optional.

Entrambi gli elenchi vengono importati dalla sorgente dati del veicolo e memorizzati nella tabella dei veicoli personalizzati. Gli elenchi degli equipaggiamenti vengono mostrati solo quando contengono almeno un elemento.

Breadcrumb

La pagina di dettaglio del veicolo include un percorso di navigazione (breadcrumb): Home → Auto → Marca → Modello. I link di Marca e Modello pre-filtrano l'archivio in base a quella marca o modello. Il link "Auto" rimanda alla pagina dell'archivio configurata.

Condivisione social

Se la funzionalità di condivisione social è abilitata, i pulsanti di condivisione vengono visualizzati nella pagina di dettaglio. I social network supportati sono WhatsApp, Facebook, Instagram, X (precedentemente Twitter), Email e Copia link (il set visibile è configurabile). Il posizionamento è configurabile — Sotto la galleria, Barra laterale destra fissa o Fine pagina:

• Sotto la galleria e Fine pagina mostrano una riga orizzontale di pulsanti (sotto la galleria o in fondo alla pagina sotto la sezione dei contatti) e sono visibili su schermi di tutte le dimensioni.
• Barra laterale destra fissa è una barra fissa sul bordo destro dello schermo che ospita anche i pulsanti rapidi Preferiti, Confronta e PDF datasheet (quando queste funzionalità sono abilitate). È nascosta sugli schermi dei telefoni (≤ 600 px), pertanto sui telefoni si consiglia di utilizzare Sotto la galleria o Fine pagina per mantenere visibile la condivisione.

Il posizionamento e i social network visibili si configurano in Design e stili → Pulsanti di condivisione social; consultare il Riferimento a design e stili.

Modulo di contatto

Il modulo di contatto consente ai visitatori di inviare una richiesta di informazioni sul veicolo. Il modulo viene inviato tramite una richiesta HTML POST standard.

Campi del modulo di contatto:

La casella di controllo del consenso alla privacy mostra un testo di consenso configurabile. Se nelle impostazioni del plugin è configurato l'URL dell'informativa sulla privacy, il testo "informativa sulla privacy" all'interno del testo di consenso viene convertito automaticamente in un link.

I messaggi di successo e di errore dopo l'invio del modulo sono configurabili nelle impostazioni del plugin.

Richiesta di prova su strada

Se la funzionalità di prova su strada è abilitata, il modulo di contatto include una casella di controllo opzionale "Interessato a una prova su strada?". Se selezionata, appaiono i campi per la data e l'ora che consentono al visitatore di richiedere una fascia oraria specifica per la prova su strada. Verificare la configurazione della prova su strada nelle impostazioni del plugin prima di pubblicare questa funzionalità.

Informazioni sul venditore / concessionario

La sezione del modulo di contatto include un pannello del venditore che mostra:

• Nome del venditore
• Ruolo aziendale
• Indirizzo
• Indirizzo email (come link mailto: cliccabile)
• Numero di telefono (come link tel: cliccabile)
• Foto del profilo
• Link ai profili social (Facebook, Instagram, X, LinkedIn)

Il contatto mostrato in questo pannello viene risolto tramite il routing dei contatti di CMH Team. Il plugin cerca prima un contatto CMH Team per il veicolo — un'assegnazione per singolo veicolo, il contatto predefinito per la filiale del veicolo o il contatto predefinito globale — e ricorre al contatto generale della concessionaria quando configurato. Un membro del team impostato su "nessun contatto visibile" nasconde il pannello, e un membro inattivo non viene mai mostrato. Solo quando CMH Team non è applicabile, il pannello ricorre al profilo del venditore legacy (i meta utente WordPress determinati dal campo post meta _as24ci_seller_user_id, o l'autore del post). Consultare CMH Team and Contact Routing.

Pulsanti preferiti e confronta

Quando è selezionato il posizionamento della condivisione social Barra laterale destra fissa, la barra fissa sul bordo destro della pagina di dettaglio include anche:

• Pulsante Preferiti (icona a cuore): aggiunge o rimuove il veicolo dai preferiti salvati del visitatore. Mostrato quando la funzionalità dei preferiti è abilitata.
• Pulsante Confronta: aggiunge o rimuove il veicolo dalla selezione di confronto. Mostrato quando la funzionalità di confronto è abilitata.
• Pulsante PDF datasheet: mostrato quando la funzionalità PDF datasheet è abilitata.

Questa barra sul bordo destro è nascosta sugli schermi dei telefoni (≤ 600 px). Con gli altri posizionamenti di condivisione (Sotto la galleria / Fine pagina), questi pulsanti rapidi non sono raggruppati in una barra laterale. Indipendentemente dal posizionamento, la funzionalità di confronto mostra la propria barra di confronto fluttuante una volta che il visitatore ha selezionato i veicoli da confrontare.

Veicoli simili

Il blocco similar_vehicles mostra fino a quattro altri veicoli pubblicati con la stessa marca e modello. Ogni scheda mostra l'immagine in miniatura, il titolo, il prezzo, il tipo di carburante, il cambio, l'anno e il chilometraggio. Un link "Mostra tutti i veicoli" riporta il visitatore all'archivio completo.

PDF datasheet

Se la funzionalità PDF datasheet è abilitata, nella pagina di dettaglio è disponibile un pulsante di download. Verificare che questa funzionalità sia abilitata e configurata nelle impostazioni del plugin prima della pubblicazione.

Note operative

• Il template del singolo veicolo viene caricato tramite il filtro WordPress single_template. Il plugin verifica la presenza di un override del tema (single-as24ci_car.php nel tema attivo) prima di caricare il proprio template. Se esistono entrambi, il file del tema ha la priorità.
• I dati del veicolo vengono letti dalla tabella personalizzata del database {prefix}as24_vehicles del plugin, quando disponibile. Per i veicoli importati prima dell'esistenza di questa tabella, i dati ricorrono ai campi post meta WordPress.
• La galleria combina le immagini caricate manualmente e le immagini importate, con le immagini caricate manualmente che appaiono sempre per prime.
• Il calcolatore di finanziamento viene visualizzato al massimo in una sola zona. Se viene inserito sia nella barra laterale che nel contenuto principale, viene visualizzata solo l'istanza della barra laterale.
• L'hook d'azione as24ci_after_contact_form si attiva dopo la sezione del modulo di contatto, consentendo alle integrazioni di inserire contenuti aggiuntivi.

Risoluzione dei problemi

La pagina di dettaglio del veicolo mostra un errore 404.

• Verificare che i permalink personalizzati siano abilitati (Impostazioni → Permalink nell'amministratore di WordPress). Dopo aver modificato le impostazioni dei permalink, salvarle una volta per aggiornare le regole di riscrittura.
• Confermare che il veicolo sia pubblicato e non in stato di bozza o privato.

La galleria non mostra le immagini.

• Verificare che le immagini siano state importate correttamente. Nell'amministratore, aprire la pagina di modifica del veicolo e verificare che le immagini della galleria siano associate.
• Se le immagini sono state caricate manualmente, confermare che siano salvate nel campo degli ID delle immagini manuali.

Non viene visualizzato alcun prezzo.

• Il box del prezzo mostra un prezzo solo se il veicolo ha un valore di prezzo superiore a zero. Controllare i dati del veicolo importato.

Il modulo di contatto non invia messaggi.

• Verificare che il sito WordPress sia in grado di inviare email. Molti ambienti di hosting richiedono un plugin SMTP o una configurazione di posta aggiuntiva.
• Controllare la configurazione dei lead del plugin per eventuali campi obbligatori o restrizioni.

Il calcolatore di finanziamento non appare.

• Confermare che la funzionalità di finanziamento sia abilitata nelle impostazioni del plugin (è disabilitata per impostazione predefinita).
• Confermare che sia attiva nella zona del Layout Manager per la pagina del singolo veicolo.

Le informazioni chiave mostrano valori pari a zero o vuoti.

• Alcuni campi dipendono dalla tabella dei veicoli personalizzati. Se un veicolo è stato importato prima della creazione della tabella, la reimportazione del veicolo potrebbe risolvere i valori mancanti.

---

Documenti correlati

• Archivio veicoli
• Confronta
• Preferiti
• Calcolatore di finanziamento
• PDF datasheet
• Richieste di test drive