Shortcode

Questo documento elenca gli shortcode registrati dal plugin ADP Car Market Hub, i loro attributi e i casi d'uso tipici per incorporare l'output del plugin all'interno delle normali pagine WordPress.

Quando utilizzare questo documento

Leggi questo documento se hai bisogno di:

• Incorporare l'archivio dei veicoli, il filtro di ricerca o la vista di confronto all'interno di una landing page esistente, invece di affidarti all'archivio CPT.
• Aggiungere una pagina dei preferiti a una normale pagina WordPress.
• Inserire una scheda della sede o una scheda degli orari di apertura nelle pagine dei concessionari.
• Consultare gli attributi supportati per uno shortcode esistente.

Per il flusso di caricamento dei template sottostante, consulta Frontend Template System.

Panoramica

Il plugin registra i seguenti shortcode:

Tutti gli shortcode possono essere inseriti in pagine standard, articoli e nella maggior parte dei contenuti basati su blocchi. Utilizzano gli stessi template e asset delle pagine native del plugin.

Riferimento shortcode

[as24ci_archive]

Mostra l'archivio dei veicoli su qualsiasi pagina.

• Comportamento: Costruisce una query WP_Query dai parametri $_GET tramite la stessa logica utilizzata dall'archivio CPT (Archive_Filters::build_query_args_from_request()), scambia temporaneamente la query globale $wp_query e renderizza il template archive-as24ci_car.php incluso. La query originale viene ripristinata successivamente.
• Attributi (tutti opzionali, tutti sovrascrivibili tramite URL):
• make, model — marca / modello preimpostati.
• price_min, price_max — limiti dell'intervallo di prezzo (mappati su min_price, max_price).
• fuel, body — slug del tipo di carburante e della carrozzeria.
• order_by — price, mileage o date. Combinato con order per produrre il parametro sort.
• order — asc (predefinito) o desc.
• per_page — 12, 24, 48, 72 o all.
• I parametri URL sovrascrivono gli attributi in modo che i visitatori possano affinare la loro ricerca in modo interattivo.
• Impaginazione: legge ?paged= (preferito) o ?page= dall'URL.

[as24ci_search_filter]

Renderizza il modulo del filtro di ricerca (senza risultati) in modo che i visitatori possano scegliere i criteri prima di essere reindirizzati a una pagina dei risultati.

• Attributi:
• results_url — URL a cui il modulo invia i dati. Il valore predefinito è l'URL dell'archivio del custom post type as24ci_car, con un fallback finale a /cars/ quando non è disponibile alcun URL di archivio.
• Set di filtri: vengono renderizzati solo i filtri abilitati nella zona di layout Filtri di ricerca. Gestiscili nella configurazione Filtri dell'amministratore.
• Conteggi di stato: il modulo mostra i conteggi in tempo reale per tutti, nuovi e usati utilizzando la stessa query basata sulla tassonomia utilizzata dall'archivio, in modo che i conteggi e i risultati rimangano coerenti.

[as24ci_compare]

Renderizza la pagina di confronto dei veicoli (page-as24ci_compare.php).

• Selezione: i veicoli vengono selezionati tramite il parametro GET ids (ID dei post separati da virgola).
• Attributi: nessuno documentato nel codice sorgente corrente; verificare prima di pubblicare se si intende esporre attributi.

[as24ci_favorites]

Renderizza la pagina dei preferiti del visitatore. L'elenco dei preferiti è memorizzato lato client nel browser del visitatore; lo shortcode (e il relativo endpoint REST complementare) popola tale elenco con i dati correnti dei veicoli.

• Comportamento: accoda il foglio di stile dei preferiti su richiesta e popola i dati dei veicoli da POST /wp-json/as24ci/v1/favorites.
• Campi visibili: configurati dalla zona di layout Preferiti nella configurazione Filtri dell'amministratore.

[as24ci_location_box]

Renderizza una scheda riassuntiva della sede per un singolo post di tipo location.

• Attributi:
• post_id — ID del post della sede da renderizzare. Se omesso, lo shortcode tenta di determinare la sede dal contesto corrente.

[as24ci_hours_box]

Renderizza una scheda degli orari di apertura per un singolo post di tipo location.

• Attributi:
• post_id — ID del post della sede da renderizzare. Stesso comportamento di fallback di [as24ci_location_box].

Istruzioni passo dopo passo

1. Apri o crea la pagina in cui desideri incorporare lo shortcode.
2. Aggiungi il blocco shortcode (o incolla la stringa dello shortcode in un editor classico).
3. Imposta gli attributi necessari. Ad esempio: - [as24ci_archive make="audi" per_page="24"] - [as24ci_search_filter results_url="/inventory/"] - [as24ci_location_box post_id="42"]
4. Pubblica o visualizza in anteprima la pagina e verifica il rendering.
5. Se lo shortcode si trova su una pagina servita da una cache a pagina intera, svuota la cache dopo la modifica in modo che venga servito l'output più recente.

Note operative

• Il plugin imposta la variabile globale $as24ci_render_mode su 'shortcode' durante il rendering di un template di shortcode. Questo viene utilizzato da altre parti del plugin (caricamento degli asset, analytics) 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 mentre il loro template viene incluso e chiamano wp_reset_postdata() successivamente. Inseriscili all'interno dell'area del contenuto principale per evitare di interferire con i componenti del tema che leggono la query globale in anticipo.
• [as24ci_search_filter] costruisce 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 i permalink personalizzati che con quelli semplici.
• I template inclusi di archivio e filtro di ricerca utilizzano sempre i file del plugin stesso. Le sovrascritture del tema per archive-as24ci_car.php si applicano sia all'archivio CPT che allo shortcode [as24ci_archive], ma page-as24ci_compare.php e parts/search-filter.php non vengono caricati tramite locate_template() — non possono essere sovrascritti da un tema senza modificare il codice sorgente del plugin. Vedi Template Overrides.
• Tutti gli shortcode restituiscono stringhe (nessun output diretto tramite echo), quindi possono essere incorporati all'interno di didascalie, celle di tabelle o pattern di blocchi.

Risoluzione dei problemi

• Lo shortcode stampa testo non elaborato — controlla il nome dello shortcode per eventuali errori di battitura. I nomi fanno distinzione tra maiuscole e minuscole; usa la forma minuscola documentata sopra.
• [as24ci_archive] mostra i veicoli errati — verifica che l'URL non contenga già parametri di filtro da una pagina precedente; i parametri URL sovrascrivono sempre gli attributi dello shortcode.
• [as24ci_search_filter] non mostra campi — nessun filtro è abilitato nella zona Filtri di ricerca. Apri la configurazione Filtri dell'amministratore e abilita i filtri necessari.
• [as24ci_favorites] mostra un elenco vuoto — il visitatore non ha preferiti memorizzati nel browser corrente. Prova prima ad aggiungere un veicolo ai preferiti; i preferiti sono limitati al browser/dispositivo.
• I link di impaginazione da [as24ci_archive] restituiscono un errore 404 — la struttura dei tuoi permalink potrebbe non passare correttamente paged attraverso la pagina ospitante. Prova a utilizzare ?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.

Documenti correlati

• Frontend Template System
• Template Overrides
• REST API Endpoints
• Custom Post Types And Taxonomies
• Options And Settings Storage
• Analytics Tracking