Documentazione · Appendici

Riferimento Shortcode

Questa appendice è un riferimento rapido per gli shortcode registrati dal plugin ADP Car Market Hub.

Quando utilizzare questo documento

Utilizza questo riferimento quando hai bisogno di cercare il nome di uno shortcode, i suoi attributi supportati o un esempio da copiare e incollare. Per la spiegazione concettuale degli shortcode (quando utilizzare quale, come interagiscono con i template), consulta Shortcodes nella documentazione tecnica e Shortcodes Reference nella guida del frontend.

Panoramica

Tutti gli shortcode sono registrati dal bootstrap principale del plugin e sono disponibili su ogni pagina o articolo di WordPress (soggetti all'editor attivo e a eventuali restrizioni a livello di blocco). Restituiscono stringhe anziché stamparle direttamente a schermo (echo), in modo da poter essere incorporati all'interno di didascalie, celle di tabelle o pattern di blocchi.

Shortcode	Cosa renderizza	Note
`[as24ci_archive]`	L'archivio dei veicoli (filtrabile, ordinabile, impaginato).	I parametri URL sovrascrivono gli attributi dello shortcode.
`[as24ci_search_filter]`	Il modulo di filtro ricerca autonomo, senza risultati.	Invia i dati a un URL dei risultati a tua scelta.
`[as24ci_compare]`	La pagina di confronto dei veicoli.	Veicoli selezionati tramite il parametro URL `ids`.
`[as24ci_favorites]`	La pagina dei preferiti del visitatore.	Si popola tramite l'helper REST dei preferiti; i preferiti sono memorizzati lato client.
`[as24ci_location_box]`	Una scheda di localizzazione per un singolo articolo sede.	Risolve la sede da `post_id` o dal contesto.
`[as24ci_hours_box]`	Una scheda degli orari di apertura per un singolo articolo sede.	Stesso comportamento di fallback di `[as24ci_location_box]`.

Riferimento agli attributi

`[as24ci_archive]`

Tutti gli attributi sono facoltativi. I parametri URL con lo stesso nome sovrascrivono l'attributo dello shortcode, consentendo ai visitatori di affinare i risultati in modo interattivo.

Attributo	Valori consentiti	Effetto
`make`	Slug della marca	Pre-filtra per marca.
`model`	Slug del modello	Pre-filtra per modello.
`price_min`	Numero	Limite inferiore del filtro prezzo (mappato su `min_price`).
`price_max`	Numero	Limite superiore del filtro prezzo (mappato su `max_price`).
`fuel`	Slug del tipo di carburante	Pre-filtra per tipo di carburante.
`body`	Slug della carrozzeria	Pre-filtra per tipo di carrozzeria.
`order_by`	`price`, `mileage`, `date`	Campo di ordinamento. Combinato con `order` per produrre il parametro `sort`.
`order`	`asc`, `desc`	Direzione di ordinamento. Predefinito `asc`.
`per_page`	`12`, `24`, `48`, `72`, `all`	Elementi per pagina.

L'impaginazione utilizza ?paged= (preferito) o ?page= dall'URL.

Esempio:

[as24ci_archive make="bmw" price_max="40000" order_by="price" order="asc" per_page="24"]

`[as24ci_search_filter]`

Attributo	Valori consentiti	Effetto
`results_url`	URL assoluto o relativo	URL a cui il modulo invia i dati. Il valore predefinito è l'URL dell'archivio del post-type `as24ci_car`, con fallback a `/cars/` quando non è disponibile alcun URL di archivio.

Vengono renderizzati solo i filtri abilitati nella zona di layout Search filters. Gestiscili nella scheda di amministrazione Layout Manager.

Esempio:

[as24ci_search_filter results_url="/inventory/"]

`[as24ci_compare]`

Nessun attributo documentato nella sorgente corrente. La selezione è guidata dal parametro URL ids, un elenco separato da virgole di ID articolo dei veicoli.

Esempio di URL: /compare/?ids=123,456

`[as24ci_favorites]`

Nessun attributo documentato. I campi visibili sono configurati dalla zona di layout Favorites nel Layout Manager. I dati dei veicoli vengono recuperati da POST /wp-json/as24ci/v1/favorites per gli ID che il visitatore ha memorizzato localmente.

`[as24ci_location_box]`

Attributo	Valori consentiti	Effetto
`post_id`	Intero	ID dell'articolo sede da renderizzare. Se omesso, lo shortcode risolve la sede dal contesto corrente.

`[as24ci_hours_box]`

Attributo	Valori consentiti	Effetto
`post_id`	Intero	ID dell'articolo sede da renderizzare. Stesso comportamento di fallback di `[as24ci_location_box]`.

Note operative

Il plugin imposta la variabile globale $as24ci_render_mode su 'shortcode' durante il rendering di un template di shortcode. Il caricamento degli asset e gli analytics utilizzano questo flag in modo che le pagine basate su shortcode si comportino in modo coerente con l'archivio CPT nativo.
[as24ci_archive] e [as24ci_compare] scambiano la variabile globale $wp_query durante il rendering del loro template e chiamano wp_reset_postdata() successivamente. Includili nell'area del contenuto principale per evitare di interferire con i componenti del tema che leggono la query globale in anticipo.
[as24ci_search_filter] compila il suo URL action dall'URL dei risultati configurato (o predefinito) e conserva tutti i parametri di query presenti in quell'URL tramite campi modulo nascosti, in modo da funzionare sia con permalink personalizzati che semplici.
I template di archivio e di filtro ricerca inclusi utilizzano sempre i file del plugin stesso. Le sovrascritture del tema per archive-as24ci_car.php si applicano sia all'archivio CPT che a [as24ci_archive], ma page-as24ci_compare.php e parts/search-filter.php non vengono caricati tramite locate_template() e non possono essere sovrascritti da un tema senza modificare i sorgenti del plugin. Verifica con la versione corrente del plugin prima della pubblicazione.
Le pagine servite da una cache a pagina intera (full-page cache) devono essere svuotate dopo aver modificato una pagina che utilizza questi shortcode, in modo che venga servito l'output più recente.

Risoluzione dei problemi

Lo shortcode viene stampato come testo normale. Controlla il nome dello shortcode; i nomi fanno distinzione tra maiuscole e minuscole. Usa la forma minuscola documentata sopra.
[as24ci_archive] mostra i veicoli errati. È probabile che l'URL contenga già parametri di filtro da una pagina precedente; i parametri URL sovrascrivono sempre gli attributi dello shortcode.
[as24ci_search_filter] non mostra alcun campo. Nessun filtro è abilitato nella zona di layout Search filters. Apri il Layout Manager e abilita i filtri di cui hai bisogno.
[as24ci_favorites] mostra un elenco vuoto. Il visitatore non ha preferiti memorizzati nel browser corrente. I preferiti sono limitati al browser/dispositivo.
I link di impaginazione restituiscono un errore 404. La struttura dei tuoi permalink potrebbe non passare correttamente paged attraverso la pagina ospitante. Prova ?page=N o aggiorna la struttura dei permalink.
La pagina di confronto è vuota. Il parametro ids è mancante dall'URL. Aggiungi almeno due ID veicolo (?ids=123,456).

Quando utilizzare questo documento

Panoramica

Riferimento agli attributi

[as24ci_archive]

[as24ci_search_filter]

[as24ci_compare]

[as24ci_favorites]

[as24ci_location_box]

[as24ci_hours_box]