Documentazione · Riferimento amministratore

Riferimento Layout Manager

Questo documento rappresenta il riferimento per la schermata Layout Manager del plugin ADP Car Market Hub (Car Market Hub → Layout Manager). Spiega l'area di lavoro basata sulle zone, come aggiungere, riordinare e configurare gli elementi, e le impostazioni aggiuntive esposte per le schede dell'archivio.

Quando utilizzare questo documento

Utilizza questo riferimento quando hai bisogno di controllare quali campi, blocchi o filtri sono visibili sul frontend, l'ordine in cui appaiono o come è strutturata la griglia dell'archivio. Per colori, tipografia e pulsanti, consulta il Riferimento a design e stili.

Panoramica

Il Layout Manager organizza il frontend in sette zone. Ogni zona ha la propria area di lavoro con due colonne: un elenco Active Layout (ciò che è attualmente mostrato sul frontend) e un elenco Available Elements (ciò che può ancora essere aggiunto). Per alcuni blocchi, un pannello aggiuntivo Configure fields espone la visibilità dei campi per singolo blocco.

Le sette zone sono:

Zona	Etichetta	Scopo
`search_filters`	Search Filters	Quali input di filtro appaiono nella pagina dell'archivio e in quale ordine.
`archive_cards`	Car Archive Cards	Quali campi vengono visualizzati su ciascuna scheda veicolo nelle viste archivio e elenco.
`single_main`	Single Vehicle Main Content	Ordine e visibilità dei blocchi di contenuto principali nella pagina di dettaglio del veicolo.
`single_sidebar`	Single Vehicle – Sidebar	Blocchi mostrati nella barra laterale della pagina di dettaglio del veicolo.
`single_bottom`	Single Vehicle – Bottom Section	Blocchi visualizzati sotto il contenuto principale nella pagina di dettaglio del veicolo.
`compare`	Compare Cars	Campi mostrati nella vista di confronto affiancato dei veicoli.
`favorites`	Favorites	Campi di riepilogo mostrati sulle schede dei preferiti/lista dei desideri.

Il layout personalizzato si applica al frontend solo se l'interruttore principale Use the custom block order instead of the built-in defaults è abilitato in Design & Styles → Layout Manager.

Requisiti o prerequisiti

Permessi per gestire il plugin.
Per le zone Compare e Favorites, le relative funzionalità frontend devono essere abilitate in Settings → Frontend Features.
Per il blocco Financing Calculator, il calcolatore deve essere abilitato in Settings → Frontend Features.

Istruzioni passo dopo passo

Scegliere una zona

Apri Car Market Hub → Layout Manager.
Utilizza il selettore di zona in alto per passare tra le sette zone. La zona attiva viene riflessa anche nell'URL tramite il parametro lm_zone.

Aggiungere un elemento al layout attivo

Nella colonna di destra Available Elements, scegli un elemento dal menu a discesa e fai clic su Add Element, oppure usa il pulsante + su una riga.
L'elemento appare nell'elenco Active Layout a sinistra.

Riordinare gli elementi

Trascina la riga tramite la sua maniglia (icona ≡) per riordinare.
Il contatore "X / Y enabled" si aggiorna man mano che attivi o disattivi gli elementi.

Abilitare, disabilitare o rimuovere un elemento

Usa l'interruttore nella riga per disabilitare un elemento senza rimuoverlo (zone Single Vehicle, Compare e Favorites).
Fai clic sul pulsante − per spostare nuovamente un elemento in Available Elements.
Per le zone Search Filters e Car Archive Cards, solo gli elementi abilitati vengono mantenuti nell'elenco attivo; gli elementi disabilitati vengono riportati automaticamente in Available Elements.

Configurare i campi all'interno di un blocco

Per i blocchi configurabili, la riga espone un pulsante Configure fields.
Fai clic su di esso per aprire il pannello di configurazione sul lato destro e attivare/disattivare i singoli campi mostrati all'interno di quel blocco.

Configurare la zona Car Archive Cards

Questa zona ha un layout dedicato con la scheda del gestore dei campi in alto e due schede affiancate in basso:

Archive Layout Settings — controlla la presentazione a griglia/elenco.
Badges & Labels — seleziona quali badge di stato appaiono sulle schede.

Riferimento di configurazione

Archive Layout Settings (solo zona Car Archive Cards)

Campo	Note
Archive grid columns	Numero di schede per riga: `1`, `2`, `3` o `4`.
Default sort order	`Newest`, `Lowest Price`, `Highest Price` o `Lowest Mileage`.
Vehicles per page	Numero intero positivo.
Archive layout	`Grid`, `List` o `Both (Grid & List)` per consentire ai visitatori di cambiare vista.
List excerpt length	Numero di caratteri mostrati dall'estratto dell'articolo nella vista Elenco. `0` nasconde l'estratto. Intervallo 0–500. Visibile solo quando il layout è `List` o `Both`.

Badges & Labels (solo zona Car Archive Cards)

Campo	Note
Visible badges	Attiva o disattiva ciascuno di: New, Used, Sale, Top offer.

Sotto gli interruttori di visibilità, la scheda espone anche una matrice di aspetto. Ogni riga è un badge (New, Used, Sale, Top) e le colonne consentono di definire lo stile di quel badge individualmente:

Colonna	Note
Background colour	Colore di sfondo del badge.
Text colour	Colore del testo dell'etichetta del badge.
Weight	Spessore del carattere dell'etichetta del badge.
Transform	Trasformazione del testo applicata all'etichetta (ad esempio UPPERCASE).
Size (px)	Dimensione del carattere dell'etichetta del badge in pixel.

Posizionamento del Financing Calculator

Il blocco Financing Calculator può essere posizionato in Single Vehicle Main Content, Single Vehicle – Sidebar o Single Vehicle – Bottom Section. Il plugin impone un singolo posizionamento attivo:

Quando il calcolatore è attivo in una delle tre zone Single Vehicle, viene mostrato come bloccato nell'elenco Available Elements delle altre due, con un avviso che indica quale zona lo possiede attualmente.
Se il calcolatore è in qualche modo attivo in più di una zona Single Vehicle, i pannelli corrispondenti mostrano un avviso di attivazione duplicata spiegando che solo un'istanza verrà visualizzata sul frontend.

Note operative

Ciascuna zona viene salvata nella propria opzione, pertanto le modifiche in una zona non influiscono sulle altre.
Le zone Search Filters e Car Archive Cards utilizzano il modello "solo attivi": la disattivazione di una riga la rimuove anche dall'elenco attivo, il che rispecchia la natura rigorosa on/off di quelle aree.
Le altre zone utilizzano un ordine stabile che conserva gli elementi disabilitati in posizione, in modo da poterli riattivare rapidamente in seguito.
Le impostazioni di visibilità dei campi configurate all'interno di un blocco (tramite Configure fields) sono memorizzate per vista (ad esempio compare, favorites) e sono indipendenti dallo stato abilitato del blocco.
Il layout personalizzato non ha alcun effetto sul frontend finché l'interruttore Use the custom block order non viene abilitato in Design & Styles → Layout Manager.
Dopo il salvataggio, la pagina si ricarica con la stessa zona selezionata (tramite il parametro URL lm_zone) in modo da poter continuare a lavorare nel contesto.

Risoluzione dei problemi

Le modifiche non vengono visualizzate sul frontend. Verifica che l'interruttore principale in Design & Styles → Layout Manager sia attivo e svuota le cache del frontend o della CDN.
Mancano le impostazioni Archive Layout Settings. Tali impostazioni appaiono solo nella zona Car Archive Cards.
Il campo "List excerpt length" è nascosto. È visibile solo quando Archive layout è List o Both (Grid & List).
Il Financing Calculator appare bloccato. È già attivo in un'altra zona Single Vehicle. Rimuovilo da lì per aggiungerlo qui.
Avviso di duplicato del Financing Calculator. Il calcolatore è abilitato in più di una zona Single Vehicle. Disabilitalo in tutte le zone tranne una per rimuovere l'avviso e garantire un rendering coerente.
L'elenco Available Elements è vuoto. Tutti gli elementi supportati da questa zona sono già presenti nel layout attivo.
Un riordinamento tramite trascinamento non è stato salvato. Verifica di aver salvato dopo aver trascinato. Alcuni browser richiedono inoltre di autorizzare la pagina per le operazioni di drag-and-drop al primo utilizzo.