Documentazione · Riferimento amministratore
Riferimento a shortcode e widget
Questo documento rappresenta il riferimento per la schermata Shortcodes & Widgets del plugin ADP Car Market Hub (Car Market Hub → Shortcodes & Widgets). Documenta ogni shortcode registrato dal plugin, gli attributi e i parametri URL supportati, le integrazioni con l'editor e i page-builder, nonché i widget della bacheca forniti con il plugin.
Quando utilizzare questo documento
Leggi questo documento se sei un editor, un creatore di siti o uno sviluppatore e hai bisogno di:
- Incorporare in una pagina l'elenco dei veicoli, i moduli di ricerca, le tabelle di confronto, i preferiti, i box delle sedi o i box degli orari di apertura.
- Pre-filtrare l'inventario al momento dell'inserimento utilizzando gli attributi dello shortcode.
- Inviare traffico pre-filtrato alla pagina dell'inventario utilizzando i parametri URL.
- Sovrascrivere un template del plugin nel tuo tema attivo.
- Capire quali widget della bacheca fornisce il plugin.
Panoramica
Il plugin registra sei shortcode pubblici:
| Shortcode | Scopo |
|---|---|
[as24ci_archive] | Inventario completo dei veicoli con filtri, ordinamento e paginazione. |
[as24ci_search_filter] | Modulo di ricerca autonomo, pensato per landing page o home page. |
[as24ci_compare] | Tabella di confronto dei veicoli per i veicoli selezionati dal visitatore. |
[as24ci_favorites] | Pagina dei preferiti del visitatore (le voci sono memorizzate lato client in localStorage). |
[as24ci_location_box] | Scheda di contatto per la sede del concessionario collegata a un veicolo. |
[as24ci_hours_box] | Scheda degli orari di apertura per la sede del concessionario collegata a un veicolo. |
Ogni shortcode è anche elencato nella schermata come una voce a sé stante con un pulsante Copia dedicato e una sezione espandibile Attributi ed esempi che mostra gli attributi supportati e gli esempi pronti all'uso per quel determinato shortcode.
Nella parte superiore della schermata, cinque riquadri KPI riassumono a colpo d'occhio l'utilizzo degli shortcode:
| Riquadro KPI | Mostra |
|---|---|
| Shortcode disponibili | Quanti shortcode pubblici registra il plugin. |
| Shortcode in uso | Occorrenze totali di shortcode trovate nelle pagine e negli articoli scansionati. |
| Integrazioni builder | Quante famiglie di integrazione supportate per editor / page-builder sono disponibili. |
| Pagine che usano il plugin | Numero di pagine e articoli pubblicati che contengono almeno uno shortcode del plugin. |
| Sovrascritture dei template | Numero di template del plugin attualmente sovrascritti dal tuo tema attivo. |
Sotto i riquadri, una scheda introduttiva offre pulsanti di copia rapida con un clic per i quattro shortcode più utilizzati — [as24ci_archive], [as24ci_search_filter], [as24ci_compare] e [as24ci_favorites] — in modo da poterli copiare negli appunti senza doverli digitare.
La schermata presenta anche una tabella di Panoramica sull'utilizzo degli shortcode che elenca le pagine e gli articoli pubblicati contenenti qualsiasi shortcode del plugin (fino ai 100 risultati più recenti) e una scheda Note per gli sviluppatori che documenta le sovrascritture dei template e i parametri URL supportati.
Requisiti o prerequisiti
- Un utente con un ruolo (capability) che consenta di modificare pagine o articoli.
- Per
[as24ci_compare]e[as24ci_favorites], la corrispondente opzione di attivazione della funzionalità deve essere abilitata inCar Market Hub → Settings. Quando una funzionalità è disabilitata, la schermata contrassegna lo shortcode con un badge Disabilitato. - Per
[as24ci_location_box]e[as24ci_hours_box], deve essere configurata almeno una sede in Locations e gli ID venditore devono corrispondere al veicolo.
Istruzioni passo dopo passo
Incorporare uno shortcode in una pagina
- Apri la pagina o l'articolo nel tuo editor.
- Inserisci lo shortcode utilizzando il controllo nativo dell'editor: - Editor a blocchi (Gutenberg): aggiungi un blocco Shortcode. - Elementor: aggiungi un widget Shortcode. - Divi, Beaver Builder, WPBakery: usa lo shortcode o il modulo di testo. - Editor classico: digita lo shortcode direttamente nel contenuto.
- Incolla lo shortcode desiderato (con gli attributi se necessario).
- Salva e visualizza l'anteprima.
Il plugin carica i propri stili e script solo sulle pagine che contengono uno shortcode del plugin, in modo che le pagine non correlate non vengano influenzate.
Pre-filtrare l'archivio al momento dell'inserimento
Utilizza gli attributi dello shortcode su [as24ci_archive], ad esempio:
[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"]
[as24ci_archive fuel="electric" body="suv" per_page="12"]Gestire il filtraggio dinamico da link o moduli esterni
Aggiungi i parametri GET all'URL dell'archivio (i parametri URL sovrascrivono gli attributi dello shortcode):
/inventory/?make=BMW&max_price=20000
/inventory/?condition=new&sort=price_ascRiferimento di configurazione
Attributi di [as24ci_archive]
Tutti gli attributi sono opzionali. I parametri URL sovrascrivono gli attributi dello shortcode.
| Attributo | Descrizione | Esempio |
|---|---|---|
make | Pre-filtra per marca. | make="BMW" |
model | Pre-filtra per modello (utilizzare insieme a make). | model="3 Series" |
price_min | Prezzo minimo (numerico). | price_min="10000" |
price_max | Prezzo massimo (numerico). | price_max="40000" |
fuel | Tipo di carburante, ad esempio petrol, diesel, electric. | fuel="electric" |
body | Tipo di carrozzeria, ad esempio suv, sedan, coupe. | body="suv" |
order_by | Campo di ordinamento: price, mileage, o date (predefinito). | order_by="price" |
order | Direzione di ordinamento: asc (predefinito) o desc. | order="asc" |
per_page | Elementi per pagina: 12, 24 (predefinito), 48, 72, all. | per_page="12" |
Attributi di [as24ci_search_filter]
| Attributo | Descrizione | Esempio |
|---|---|---|
results_url | URL della pagina dei risultati. Il valore predefinito è l'URL dell'archivio veicoli del plugin. | results_url="/inventory/" |
[as24ci_compare]
Nessun attributo. Posizionalo su una pagina di confronto dedicata. La schermata delle impostazioni può creare questa pagina automaticamente.
[as24ci_favorites]
Nessun attributo. Posizionalo su una pagina dedicata ai preferiti o alla lista dei desideri. I preferiti vengono memorizzati nel browser del visitatore tramite localStorage — non è richiesto alcun account e nessun dato viene inviato al server.
Attributi di [as24ci_location_box] e [as24ci_hours_box]
| Attributo | Descrizione | Esempio |
|---|---|---|
post_id | ID dell'articolo del veicolo. Il valore predefinito è l'articolo corrente nel loop. | post_id="123" |
La sede collegata al veicolo viene risolta tramite il Seller ID di AutoScout24. Se non viene trovata alcuna corrispondenza, viene utilizzata la prima sede (predefinita) da Locations.
Parametri URL supportati
Questi parametri possono essere aggiunti all'URL dell'archivio. I parametri URL sovrascrivono gli attributi dello shortcode.
| Parametro | Descrizione | Esempio |
|---|---|---|
make | Filtra per marca. | ?make=BMW |
model | Filtra per modello (richiede make). | ?model=3+Series |
min_price / max_price | Filtra per fascia di prezzo. | ?min_price=5000&max_price=20000 |
mileage_max | Chilometraggio massimo. | ?mileage_max=80000 |
condition | all, new, o used. | ?condition=new |
sort | price_asc, price_desc, mileage_asc, mileage_desc. | ?sort=price_asc |
per_page | Elementi per pagina (12, 24, 48, 72, all). | ?per_page=12 |
q | Ricerca per parola chiave. | ?q=diesel |
Supporto per Builder ed Editor
Controlli nativi per gli shortcode in Editor a blocchi (Gutenberg), Elementor, Divi / Beaver Builder / WPBakery e nell'Editor classico. La barra dei KPI sullo schermo segnala quattro famiglie di integrazione supportate.
Widget della bacheca
Il plugin aggiunge i seguenti widget alla bacheca standard di WordPress:
| Widget | Contenuto |
|---|---|
| CMH – Company Overview | Conteggio dei veicoli, tempi di importazione, totali dei lead e valore del portafoglio. |
| CMH – AI and SEO Monitor | Coda dei testi AI, coda SEO delle immagini e stato della connessione API. |
| CMH – Current Leads | Attività recente dei lead in entrata per i tuoi veicoli. |
| CMH – Car Performance | Veicoli più visualizzati e panoramica del coinvolgimento. |
| CMH – Price Information | Istantanea dell'analisi dei prezzi per il tuo inventario. |
Tabella di panoramica sull'utilizzo degli shortcode
La tabella di panoramica sull'utilizzo elenca ogni pagina o articolo pubblicato che contiene uno shortcode del plugin, con le seguenti colonne:
| Colonna | Mostra |
|---|---|
| Titolo del contenuto | Titolo della pagina o dell'articolo. |
| Tipo di contenuto | Indica se la voce è una pagina o un articolo. |
| Shortcode utilizzati | Quale/i shortcode del plugin contiene il contenuto. |
| Conteggio | Quante occorrenze di shortcode del plugin sono presenti in quel contenuto. |
| Ultimo aggiornamento | Quando la pagina o l'articolo è stato modificato l'ultima volta. |
| Azioni | Un link Modifica che apre la pagina o l'articolo nell'editor. |
Sovrascritture dei template
L'output dello shortcode utilizza gli stessi template del CPT nativo del veicolo. Per sovrascrivere un template, copia il file nella radice del tuo tema attivo; WordPress caricherà automaticamente la tua versione.
| Template | Utilizzato per |
|---|---|
archive-as24ci_car.php | Output dell'archivio veicoli e dell'elenco dello shortcode. |
single-as24ci_car.php | Pagina di dettaglio del singolo veicolo. |
page-as24ci_compare.php | Pagina di confronto dei veicoli. |
Note operative
- La Panoramica sull'utilizzo degli shortcode scansiona fino alle 100 pagine e articoli pubblicati modificati più di recente che contengono qualsiasi shortcode del plugin. I tipi di contenuto personalizzati (CPT) non sono inclusi per impostazione predefinita.
- Il riquadri KPI Shortcode in uso conta le occorrenze totali all'interno della stessa scansione.
- Il riquadro KPI Sovrascritture dei template conta i template del plugin attualmente sovrascritti dal tuo tema attivo.
- La disattivazione di Confronto o Preferiti in Settings non rimuove lo shortcode dal tuo contenuto; lo contrassegna solo come disabilitato in questo riferimento e potrebbe sopprimerne l'output sul frontend. Riabilita la funzionalità per rendere nuovamente attivo lo shortcode.
Risoluzione dei problemi
- Uno shortcode viene visualizzato come testo normale. WordPress non ha eseguito l'analisi dello shortcode su quel campo. Inserisci lo shortcode nel contenuto della pagina principale o dell'articolo, in un blocco Shortcode o in un modulo del builder che supporti gli shortcode.
- L'archivio mostra tutto nonostante un attributo. Un parametro URL sovrascrive gli attributi dello shortcode. Rimuovi il parametro URL o allinealo con il filtro desiderato.
[as24ci_compare]o[as24ci_favorites]appare vuoto. Verifica che la funzionalità corrispondente sia abilitata in Settings. In questo caso, la schermata mostra anche un badge Disabilitato.- La sede e gli orari tornano alla filiale predefinita. Il Seller ID del veicolo non è assegnato ad alcuna sede; aggiungilo in Locations.
- Una sovrascrittura del tema non viene rilevata. Il file deve trovarsi nella radice della directory del tema attivo (o del tema child) e deve utilizzare l'esatto nome file sopra elencato.