Documentazione · Guida del frontend
Archivio veicoli
Questo documento copre la pagina dell'archivio veicoli del plugin ADP Car Market Hub WordPress: come vengono elencati i veicoli, come funzionano i filtri e l'ordinamento e cosa possono fare i visitatori dall'archivio.
Quando usare questo documento
Leggere questo documento se si sta configurando l'archivio veicoli per la prima volta, se si sta risolvendo un problema con il comportamento dei filtri o dell'ordinamento, o se si sta aiutando un visitatore a capire come cercare e sfogliare l'inventario.
Panoramica
L'archivio veicoli mostra tutti i veicoli importati come un elenco sfogliabile e filtrabile. I visitatori possono restringere i risultati utilizzando i filtri di ricerca, ordinare l'elenco per prezzo o chilometraggio, passare dalla visualizzazione a griglia a quella a elenco e navigare verso le singole pagine di dettaglio del veicolo.
L'archivio viene renderizzato dal template di archivio integrato del plugin (archive-as24ci_car.php). Può essere visualizzato in due modi:
- Archivio CPT nativo: WordPress serve automaticamente l'archivio all'URL dell'archivio del custom post type. Il plugin registra il post type
as24ci_care intercetta il template dell'archivio tramite il filtroarchive_template. - Pagina con shortcode: Posizionare lo shortcode
[as24ci_archive]su qualsiasi pagina WordPress. Il plugin renderizza l'archivio completo, inclusi i filtri e la paginazione, su quella pagina. Questo è l'approccio consigliato quando si utilizzano permalink semplici (non-pretty) o quando si desidera controllare lo slug dell'URL dell'archivio.
Entrambi i metodi utilizzano lo stesso template e producono un output identico.
Requisiti o prerequisiti
- Il plugin deve essere installato e attivato.
- Almeno un veicolo deve essere stato importato e pubblicato.
- Se si utilizza il metodo dello shortcode, deve esistere una pagina con
[as24ci_archive]in WordPress. - La pagina dell'archivio o l'URL dell'archivio CPT deve essere accessibile pubblicamente.
Istruzioni passo-passo
Visualizzare l'archivio veicoli tramite shortcode
- Nell'amministrazione di WordPress, andare su Pagine → Aggiungi nuova.
- Assegnare alla pagina un titolo come "I nostri veicoli" o "Inventario auto".
- Nell'editor dei contenuti della pagina, aggiungere lo shortcode
[as24ci_archive]. - Pubblicare la pagina.
- Nelle impostazioni del plugin, confermare che l'ID della pagina dell'archivio sia impostato correttamente nella configurazione del plugin, in modo che i breadcrumb e i link di confronto puntino all'URL corretto.
Pre-filtrare l'archivio utilizzando gli attributi dello shortcode
È possibile pre-filtrare l'archivio dallo shortcode per mostrare solo un sottoinsieme di veicoli:
[as24ci_archive make="bmw" fuel="diesel" per_page="12"]Attributi dello shortcode supportati:
| Attributo | Descrizione | Valore di esempio |
|---|---|---|
make | Filtra per marca (slug) | bmw, volkswagen |
model | Filtra per modello (slug) | 3-series, golf |
price_min | Prezzo minimo | 5000 |
price_max | Prezzo massimo | 30000 |
fuel | Filtra per tipo di carburante (slug) | diesel, electric |
body | Filtra per tipo di carrozzeria (slug) | suv, sedan |
order_by | Campo di ordinamento: price, mileage, o date | price |
order | Direzione dell'ordinamento: asc o desc | asc |
per_page | Risultati per pagina: 12, 24, 48, 72, o all | 24 |
I visitatori possono comunque interagire con il modulo di filtro dopo il caricamento della pagina. I parametri GET del modulo di filtro sovrascrivono gli attributi dello shortcode.
Riferimento di configurazione
Controlli dei filtri
L'archivio include un modulo di filtro di ricerca. Quali filtri appaiono è controllato dalla zona Layout Manager → Search Filters del plugin. Sono supportati i seguenti campi di filtro:
Filtri standard (visibili per impostazione predefinita):
- Marca
- Modello (dipendente dalla selezione della Marca)
- Anno (intervallo min/max)
- Chilometraggio (intervallo min/max)
- Prezzo (intervallo min/max)
- Tipo di carburante
- Trasmissione
- Tipo di trazione
- Stato
- Colore esterno
Filtri avanzati (mostrati tramite un pulsante "Mostra altro"):
- Colore interno
- Cilindrata del motore (intervallo min/max)
- Etichetta energetica
- Sede
Filtri opzionali (disabilitati per impostazione predefinita, possono essere abilitati):
- Tipo di carrozzeria
- Porte (intervallo min/max)
- Posti (intervallo min/max)
Controlli della barra degli strumenti (configurabili):
- Ordinamento
- Risultati per pagina
- Ricerca per parola chiave (
q)
Ogni filtro può essere abilitato o disabilitato singolarmente nel Layout Manager. I filtri disabilitati sono nascosti ai visitatori ma non influiscono sui valori dei filtri attualmente attivi.
Parametri GET accettati dall'archivio
L'archivio elabora i seguenti parametri GET, che il modulo di filtro invia automaticamente:
| Parametro | Tipo | Descrizione |
|---|---|---|
make | string | Slug della marca del veicolo |
model | string | Slug del modello del veicolo |
body_type | string | Slug del tipo di carrozzeria |
drive_type | string | Slug del tipo di trazione |
condition | string | Slug dello stato (new o used) |
fuel_type | string | Slug del tipo di carburante |
transmission | string | Slug della trasmissione |
color_exterior | string | Slug del colore esterno (color è accettato come alias) |
color_interior | string | Slug del colore interno |
min_price | int | Prezzo minimo |
max_price | int | Prezzo massimo |
mileage_min | int | Chilometraggio minimo in km |
mileage_max | int | Chilometraggio massimo in km |
year_min | int | Anno minimo di immatricolazione |
year_max | int | Anno massimo di immatricolazione |
displacement_min | int | Cilindrata minima del motore in cc |
displacement_max | int | Cilindrata massima del motore in cc |
energy_label | string | Slug dell'etichetta energetica |
location | string | Nome della sede |
doors_min | int | Numero minimo di porte |
doors_max | int | Numero massimo di porte |
seats_min | int | Numero minimo di posti |
seats_max | int | Numero massimo di posti |
status | string | all, new, o used (scheda di stato) |
q | string | Ricerca per parola chiave (max 100 caratteri) |
sort | string | Ordinamento (vedere la sezione Ordinamento) |
per_page | string | Risultati per pagina: 12, 24, 48, 72, o all |
paged | int | Numero di pagina per la paginazione |
Ordinamento
L'archivio supporta le seguenti opzioni di ordinamento tramite il parametro GET sort:
| Valore | Descrizione |
|---|---|
| (vuoto) | Più recenti prima (data decrescente) |
price_asc | Prezzo: dal più basso |
price_desc | Prezzo: dal più alto |
mileage_asc | Chilometraggio: dal più basso |
mileage_desc | Chilometraggio: dal più alto |
L'ordinamento predefinito può essere configurato nelle impostazioni del plugin. Se non viene configurato alcun valore predefinito, l'archivio mostra per impostazione predefinita i più recenti prima.
Opzioni di layout e visualizzazione
Le seguenti impostazioni di visualizzazione sono disponibili nell'amministrazione del plugin:
| Impostazione | Opzioni | Descrizione |
|---|---|---|
| Layout dell'archivio | grid, list, both | Modalità di visualizzazione delle schede. both aggiunge un pulsante per cambiare visualizzazione. |
| Colonne della griglia | 1, 2, 3, 4 | Numero di colonne nella visualizzazione a griglia |
| Risultati per pagina | 12, 24, 48, 72, o intero personalizzato | Numero predefinito di veicoli per pagina |
| Lunghezza dell'estratto dell'elenco | 0–500 caratteri | Limite di caratteri per l'estratto mostrato nella visualizzazione a elenco |
| Badge | Nuovo, Usato, Offerta, Migliore offerta | Consente di scegliere quali badge mostrare sulle schede dei veicoli |
Contenuto della scheda dell'archivio
Ogni scheda veicolo nell'archivio mostra le seguenti informazioni. I singoli elementi possono essere riordinati o disabilitati tramite la zona Layout Manager → Archive Cards:
- Immagine in evidenza del veicolo (mostra un segnaposto se non è disponibile alcuna immagine)
- Titolo del veicolo
- Prezzo (formattato con la valuta)
- Badge dello stato (Nuovo, Usato, Offerta, Migliore offerta)
- Dati chiave: anno, chilometraggio, tipo di carburante, trasmissione, cavalli, tipo di carrozzeria, colore esterno, stato (configurabile)
- Pulsante Preferiti (icona a forma di cuore, se la funzionalità preferiti è abilitata)
- Pulsante Confronta (se la funzionalità di confronto è abilitata)
- Testo dell'estratto (solo visualizzazione a elenco, se la lunghezza dell'estratto è maggiore di zero)
Schede dello stato
L'intestazione dell'archivio include tre schede: Tutti, Nuovo e Usato. Ciascuna scheda mostra il numero di veicoli corrispondenti allo stato attuale del filtro. Facendo clic su una scheda si filtra per stato. Quando viene selezionato uno stato tramite il filtro a discesa dello stato, i conteggi delle schede e la selezione delle schede vengono sincronizzati con tale selezione.
Note operative
- I filtri categoriali (marca, modello, tipo di carburante, stato, ecc.) sono implementati utilizzando query di tassonomia di WordPress. I filtri numerici (prezzo, chilometraggio, anno, cilindrata) interrogano la tabella di database personalizzata
{prefix}as24_vehiclesdel plugin. - Il filtraggio per sede risolve il nome della sede in un set di ID venditore e quindi filtra i veicoli in base a tali venditori.
- Quando viene selezionata l'opzione
per_page=all, la paginazione viene nascosta e tutti i veicoli corrispondenti vengono restituiti in una singola richiesta. - Il template dell'archivio viene caricato tramite il filtro WordPress
archive_template. Il tema attivo può sovrascrivere il template fornendo un filearchive-as24ci_car.phpnella directory del tema. - Quando si utilizza lo shortcode, l'azione del modulo punta all'URL della pagina corrente anziché all'URL dell'archivio CPT. Ciò garantisce che l'invio dei filtri e la paginazione funzionino correttamente sulla pagina dello shortcode.
- Il plugin accoda i propri CSS e JavaScript solo sulle pagine di archivio, sulle singole pagine dei veicoli e sulle pagine che contengono uno shortcode del plugin riconosciuto.
Risoluzione dei problemi
La pagina dell'archivio non mostra alcun veicolo.
- Confermare che almeno un veicolo sia stato importato e sia pubblicato.
- Verificare che la pagina corretta sia configurata come pagina di archivio nelle impostazioni del plugin.
- Se si utilizza l'URL dell'archivio del CPT, verificare che i permalink personalizzati siano abilitati in WordPress Impostazioni → Permalink.
I filtri non vengono visualizzati.
- Controllare la zona Layout Manager → Search Filters e confermare che i filtri desiderati siano abilitati.
- Se il modulo di filtro appare ma manca un filtro specifico, potrebbe essere stato disabilitato nel Layout Manager.
L'ordinamento per prezzo o chilometraggio non funziona correttamente.
- L'ordinamento per prezzo e chilometraggio si basa sulla tabella personalizzata dei veicoli del plugin. I veicoli importati prima della creazione di questa tabella potrebbero non essere ordinati correttamente finché non vengono reimportati o finché non viene eseguito lo strumento di migrazione.
Il shortcode [as24ci_archive] non viene visualizzato.
- Confermare che il plugin sia attivo e che lo shortcode sia inserito correttamente nel contenuto della pagina.
- Verificare la presenza di conflitti con temi o plugin che potrebbero sopprimere l'output dello shortcode.
La paginazione non funziona su una pagina con shortcode.
- I parametri GET
pagedepagesono entrambi supportati. Verificare che i link di paginazione del tema generino uno di questi parametri.