Documentazione · Guida del frontend
Riferimento Shortcode
Questo documento è un riferimento completo per tutti gli shortcode WordPress forniti dal plugin ADP Car Market Hub WordPress.
Quando utilizzare questo documento
Utilizza questo documento quando hai la necessità di incorporare l'output del plugin in una pagina WordPress e desideri conoscere la sintassi esatta dello shortcode, gli attributi supportati e il comportamento previsto per ciascuno di essi.
Panoramica
Il plugin registra i seguenti shortcode:
| Shortcode | Descrizione |
|---|---|
[as24ci_archive] | Mostra l'archivio completo dei veicoli con filtri, ordinamento e paginazione |
[as24ci_search_filter] | Mostra solo il modulo dei filtri di ricerca, senza i risultati |
[as24ci_compare] | Mostra la tabella di confronto dei veicoli |
[as24ci_favorites] | Mostra l'elenco dei preferiti salvati dal visitatore |
[as24ci_location_box] | Mostra il box con l'indirizzo della sede del concessionario per un veicolo |
[as24ci_hours_box] | Mostra il box con gli orari di apertura del concessionario per un veicolo |
[as24ci_archive]
Mostra l'archivio completo dei veicoli, inclusi il modulo dei filtri di ricerca, la griglia o l'elenco dei risultati, le schede delle condizioni, i controlli di ordinamento, i controlli per pagina e la paginazione. Produce lo stesso output dell'URL dell'archivio del custom post type nativo.
Attributi
Tutti gli attributi sono opzionali. Se nell'URL è presente un parametro GET con lo stesso nome, questo sovrascrive l'attributo dello shortcode.
| Attributo | Tipo | Descrizione | Esempio |
|---|---|---|---|
make | string | Pre-filtra per lo slug della marca del veicolo | bmw |
model | string | Pre-filtra per lo slug del modello del veicolo | 3-series |
price_min | int | Pre-filtro sul prezzo minimo | 5000 |
price_max | int | Pre-filtro sul prezzo massimo | 30000 |
fuel | string | Pre-filtra per lo slug del tipo di carburante | diesel |
body | string | Pre-filtra per lo slug del tipo di carrozzeria | suv |
order_by | string | Campo di ordinamento: price, mileage, o date | price |
order | string | Direzione di ordinamento: asc o desc. Utilizzato con order_by. | asc |
per_page | string | Risultati per pagina: 12, 24, 48, 72, o all | 24 |
Esempi
Mostra tutti i veicoli:
[as24ci_archive]Mostra solo i SUV diesel ordinati per prezzo crescente:
[as24ci_archive fuel="diesel" body="suv" order_by="price" order="asc"]Mostra i veicoli in una fascia di prezzo con 12 risultati per pagina:
[as24ci_archive price_min="10000" price_max="50000" per_page="12"]Note
- I visitatori possono interagire con il modulo dei filtri dopo il caricamento della pagina. Qualsiasi selezione di filtro da parte del visitatore sovrascrive gli attributi di pre-filtro dello shortcode tramite i parametri GET.
- La paginazione utilizza il parametro GET
pagedopage. - Lo shortcode utilizza l'URL stesso della pagina come azione del modulo dei filtri. Assicurati che la pagina abbia un URL pulito e accessibile.
[as24ci_search_filter]
Mostra solo il modulo dei filtri di ricerca, senza i risultati dei veicoli. Utilizzalo su una homepage o su una landing page per consentire ai visitatori di impostare i propri criteri prima di essere indirizzati alla pagina dei risultati.
Attributi
| Attributo | Tipo | Descrizione | Esempio |
|---|---|---|---|
results_url | string | URL della pagina dei risultati a cui inviare il modulo. Il valore predefinito è l'URL dell'archivio CPT o /cars/. | /inventory/ |
Esempi
Modulo dei filtri che reindirizza all'archivio CPT predefinito:
[as24ci_search_filter]Modulo dei filtri che reindirizza a una pagina dei risultati personalizzata:
[as24ci_search_filter results_url="/car-inventory/"]Note
- Il modulo dei filtri viene visualizzato con gli stessi campi e la stessa configurazione del Layout Manager del filtro della pagina di archivio.
- Eventuali parametri GET già presenti sulla pagina corrente si riflettono nei valori preselezionati del modulo dei filtri.
- Quando sono in uso permalink semplici (non-pretty), l'URL dell'archivio CPT potrebbe non essere raggiungibile. In tal caso, imposta esplicitamente
results_urlsu una pagina contenente lo shortcode[as24ci_archive].
[as24ci_compare]
Mostra la tabella di confronto dei veicoli. Carica gli ID dei veicoli dal parametro GET ids (un elenco di ID post separati da virgole) e visualizza ciascun veicolo come una colonna in una tabella affiancata.
Attributi
Questo shortcode non ha attributi configurabili. Gli ID dei veicoli vengono passati tramite l'URL.
Formato URL
/compare-page/?ids=123,456,789Il codice JavaScript di confronto crea questo URL automaticamente quando il visitatore fa clic sul pulsante Confronta.
Esempio
[as24ci_compare]Inserisci questo shortcode in una pagina dedicata "Confronta veicoli". Le impostazioni del plugin dovrebbero fare riferimento all'ID di questa pagina come pagina di confronto.
Note
- La tabella di confronto mostra solo i veicoli pubblicati del custom post type del plugin.
- Viene visualizzato un massimo di 4 veicoli, indipendentemente dal numero di ID passati. Gli ID oltre i primi 4 vengono ignorati silenziosamente.
- Se non è presente alcun parametro
idso se tutti gli ID specificati non sono validi, la pagina mostra "Nessun veicolo selezionato per il confronto." - I campi mostrati in ciascuna colonna sono configurati nel Layout Manager → zona Confronta.
[as24ci_favorites]
Mostra l'elenco dei preferiti salvati dal visitatore. L'elenco viene popolato dinamicamente tramite JavaScript utilizzando gli ID dei veicoli memorizzati nel localStorage del browser. Il plugin chiama un endpoint REST interno per recuperare i dati correnti del veicolo per ciascun ID salvato.
Attributi
Questo shortcode non ha attributi configurabili.
Esempio
[as24ci_favorites]Inserisci questo shortcode in una pagina dedicata "I miei preferiti".
Note
- La pagina richiede JavaScript per funzionare. Senza JavaScript, l'elenco non può essere popolato.
- Se non ci sono veicoli salvati nel browser del visitatore, la pagina mostra "Non hai ancora preferiti salvati."
- L'API REST deve essere accessibile pubblicamente. I plugin di sicurezza che bloccano gli endpoint REST pubblici impediranno il caricamento dell'elenco dei preferiti.
- I campi mostrati su ciascuna scheda dei preferiti sono configurati nel Layout Manager → zona Preferiti.
- Vengono recuperati fino a 50 ID di veicoli salvati per richiesta.
[as24ci_location_box]
Mostra il box con l'indirizzo della sede del concessionario per un veicolo. Il box mostra il nome del concessionario, il telefono, l'indirizzo e, facoltativamente, un pulsante "Visita la sede" se è configurato un URL del sito web.
La sede viene determinata associando il Seller ID AutoScout24 del veicolo alle sedi configurate nel plugin.
Attributi
| Attributo | Tipo | Descrizione | Esempio |
|---|---|---|---|
post_id | int | ID del post WordPress del veicolo. Il valore predefinito è il post corrente nel loop. | 456 |
Esempi
Box della sede per un veicolo specifico:
[as24ci_location_box post_id="456"]Box della sede per il post corrente (quando utilizzato all'interno di un template di pagina del veicolo):
[as24ci_location_box]Note
- Restituisce un output vuoto se il veicolo non ha un Seller ID o se nessuna sede configurata corrisponde al Seller ID.
- Nelle pagine di dettaglio del veicolo, queste informazioni vengono visualizzate automaticamente anche sotto il modulo di contatto, pertanto l'uso manuale dello shortcode sulla stessa pagina comporterebbe un output duplicato.
[as24ci_hours_box]
Mostra il box con gli orari di apertura del concessionario per un veicolo. Il box mostra una colonna per ciascuna categoria di orari configurata, ognuna contenente le righe con l'intervallo di giorni e l'intervallo di ore.
La sede viene determinata associando il Seller ID AutoScout24 del veicolo alle sedi configurate nel plugin.
Attributi
| Attributo | Tipo | Descrizione | Esempio |
|---|---|---|---|
post_id | int | ID del post WordPress del veicolo. Il valore predefinito è il post corrente nel loop. | 456 |
Esempi
Box degli orari per un veicolo specifico:
[as24ci_hours_box post_id="456"]Box degli orari per il post corrente:
[as24ci_hours_box]Note
- Restituisce un output vuoto se il veicolo non ha un Seller ID, se non viene trovata alcuna sede corrispondente o se la sede corrispondente non ha orari di apertura configurati.
- Nelle pagine di dettaglio del veicolo, queste informazioni vengono visualizzate automaticamente anche sotto il modulo di contatto.