Documentazione · Guida del frontend
Sede e orari di apertura
Questo documento copre la funzionalità relativa alla sede e agli orari di apertura del plugin ADP Car Market Hub WordPress: come vengono visualizzate le sedi dei concessionari sulle pagine di dettaglio del veicolo, come gli shortcode possono incorporare i dati della sede altrove e come viene configurata la funzionalità.
Quando utilizzare questo documento
Leggi questo documento se stai configurando le sedi per la prima volta, se stai aggiungendo gli orari di apertura alla pagina di dettaglio del veicolo o se stai utilizzando gli shortcode per la sede e gli orari su altre pagine.
Panoramica
Il plugin include una funzionalità Locations (Sedi) che memorizza i dati della sede del concessionario o della filiale (indirizzo, telefono, posizione su Google Maps e orari di apertura) insieme a uno o più ID venditore AutoScout24. Quando l'ID venditore di un veicolo corrisponde a una sede configurata, il plugin mostra automaticamente il box dell'indirizzo della sede corrispondente e il box degli orari di apertura dopo il modulo di contatto nella pagina di dettaglio del veicolo.
Le stesse informazioni possono anche essere renderizzate su qualsiasi pagina WordPress utilizzando shortcode dedicati.
Requisiti o prerequisiti
- Almeno una sede deve essere configurata nell'amministrazione del plugin (impostazioni del plugin → scheda Locations).
- Ogni sede deve avere almeno un ID venditore associato che corrisponda al valore del post meta
_as24ci_seller_idmemorizzato nei post dei veicoli. - Affinché la sede e gli orari appaiano automaticamente sulle pagine di dettaglio del veicolo, il plugin deve essere attivo e l'ID venditore del veicolo deve essere impostato.
Istruzioni passo-passo
Configurare una sede
- Nell'amministrazione di WordPress, apri le impostazioni del plugin e naviga nella scheda Locations.
- Fai clic su Add Location o modificane una esistente.
- Compila i dettagli della sede: - Name: Il nome del concessionario o della filiale. - Street: L'indirizzo stradale. - ZIP code: Il codice postale. - City: Il nome della città. - Phone: Il numero di telefono di contatto. - Google Maps Location: URL opzionale di Google Maps per un pulsante "Calcola percorso". Generato automaticamente dal nome della sede e dall'indirizzo quando vuoto. Puoi anche incollare un URL personalizzato di Google Maps. - Seller IDs: Uno o più ID venditore AutoScout24 associati a questa sede. - Opening hours: Una o più categorie, ciascuna con righe di coppie di intervalli di giorni e intervalli di orari.
- Salva la sede.
Una volta salvata, l'indirizzo e gli orari della sede appariranno automaticamente sulla pagina di dettaglio di qualsiasi veicolo il cui ID venditore corrisponda a uno degli ID venditore configurati per quella sede.
Incorporare le informazioni sulla sede in qualsiasi pagina utilizzando gli shortcode
- Apri la pagina o il post di WordPress in cui desideri mostrare le informazioni sulla sede.
- Aggiungi uno dei seguenti shortcode nell'editor dei contenuti:
Box della sede (indirizzo, telefono, pulsante calcola percorso):
[as24ci_location_box post_id="123"]Box degli orari di apertura:
[as24ci_hours_box post_id="123"]
Sostituisci 123 con l'ID del post WordPress del veicolo di cui desideri mostrare la sede associata.
- Se ometti l'attributo
post_id, lo shortcode utilizza l'ID del post corrente nel loop. Questo è utile quando si inserisce lo shortcode all'interno di un template di post del veicolo.
Riferimento di configurazione
Campi della sede
Ogni sede è memorizzata come voce nell'opzione delle sedi del plugin (as24ci_locations). Sono supportati i seguenti campi:
| Campo | Descrizione |
|---|---|
name | Nome della sede o del concessionario (mostrato come intestazione nel box della sede) |
street | Indirizzo stradale |
zip | Codice postale |
city | Nome della città |
phone | Numero di telefono (visualizzato in grassetto nel box della sede) |
url | URL opzionale della posizione su Google Maps utilizzato per il pulsante "Calcola percorso". Quando è vuoto, viene generato automaticamente un URL di ricerca di Google Maps dal nome della sede e dall'indirizzo. |
seller_ids | Array di stringhe di ID venditore AutoScout24 associate a questa sede |
hours | Array di categorie di orari di apertura (vedi sotto) |
Struttura degli orari di apertura
Gli orari di apertura sono organizzati come un elenco di categorie. Ogni categoria ha un'etichetta e una o più righe:
| Campo | Descrizione |
|---|---|
category | Etichetta della categoria (es. "Vendite", "Assistenza", "Ricambi") |
rows | Array di voci { days, time } (es. Mon–Fri, 08:00–18:00) |
Esempio di struttura per una singola categoria:
Category: Sales
Row 1: Mon–Fri / 08:00–18:00
Row 2: Sat / 09:00–16:00
Entrambi i campi days e time sono stringhe di testo libero. Il plugin non convalida né analizza il loro contenuto.
Shortcode
| Shortcode | Descrizione |
|---|---|
[as24ci_location_box post_id="…"] | Renderizza il box dell'indirizzo per la sede del veicolo |
[as24ci_hours_box post_id="…"] | Renderizza il box degli orari di apertura per la sede del veicolo |
Entrambi gli shortcode accettano un attributo post_id. Se omesso, viene utilizzato l'ID del post corrente nel loop. Se non viene trovata alcuna sede corrispondente per l'ID venditore del veicolo, lo shortcode restituisce un output vuoto.
Note operative
- La ricerca della sede viene eseguita confrontando il valore del post meta
_as24ci_seller_iddel veicolo con l'arrayseller_idsdi ciascuna sede configurata. Viene utilizzata la prima sede corrispondente. - I box della sede e degli orari vengono renderizzati dopo la sezione del modulo di contatto tramite l'hook di azione
as24ci_after_contact_form. Entrambi i box sono racchiusi in un div contenitore (as24ci-location-hours-wrapper). Se nessuno dei due ha contenuti, non viene renderizzato nulla. - Il box degli orari di apertura viene renderizzato solo quando la sede corrispondente ha almeno una categoria di orari non vuota.
- I dati della sede sono memorizzati come array serializzato nella tabella delle opzioni di WordPress con l'autoload disabilitato. Vengono caricati solo sulle pagine di dettaglio del veicolo e nell'amministrazione del plugin, non su ogni richiesta di pagina.
- Il box della sede include un pulsante "Calcola percorso" ogni volta che è disponibile un URL di Google Maps, sia che il campo
urlsia impostato, sia che possa essere generato automaticamente dal nome della sede e dall'indirizzo. Non vengono effettuate chiamate API esterne; l'URL generato automaticamente utilizza il formato semplicehttps://www.google.com/maps/search/?api=1&query=…. - Se un veicolo non ha un valore meta
_as24ci_seller_id, non vengono renderizzati né il box della sede né il box degli orari.
Risoluzione dei problemi
Il box della sede non appare nella pagina di dettaglio di un veicolo.
- Verifica che il veicolo abbia un valore meta
_as24ci_seller_id. Questo viene impostato durante l'importazione. Apri il veicolo nell'amministrazione di WordPress e controlla i campi meta del veicolo. - Conferma che una sede sia configurata nelle impostazioni del plugin con un ID venditore corrispondente.
- Controlla che il modulo di contatto sia visibile sulla pagina. I box della sede e degli orari vengono renderizzati dopo la sezione del modulo di contatto tramite un hook su
as24ci_after_contact_form. Se il blocco del modulo di contatto è disabilitato nel Layout Manager, l'hook potrebbe non attivarsi.
Il box degli orari di apertura non appare anche se è configurata una sede.
- Conferma che la sede abbia almeno una categoria di orari di apertura con almeno una riga.
- Se la categoria e le righe sono presenti ma il box continua a non apparire, verifica che i dati vengano salvati correttamente nella scheda di amministrazione Locations.
Lo shortcode restituisce un output vuoto.
- Verifica che l'attributo
post_idpunti a un veicolo pubblicato con un_as24ci_seller_idvalido. - Conferma che sia presente una sede nelle impostazioni del plugin con un ID venditore corrispondente.
- Lo shortcode restituisce un output vuoto quando non viene trovata alcuna sede corrispondente o quando il veicolo non ha un ID venditore. Questo è il comportamento previsto.
Il pulsante "Calcola percorso" non appare.
- Il pulsante viene renderizzato ogni volta che la sede ha un URL di Google Maps o dati di indirizzo sufficienti (nome, via, CAP, città) per generarne uno automaticamente. Se nessuno dei due è disponibile, compila il campo Google Maps Location o i campi dell'indirizzo nella scheda di amministrazione Locations.