Documentazione · Riferimento amministratore

Riferimento delle impostazioni

Questo documento rappresenta un riferimento per la schermata Impostazioni del plugin ADP Car Market Hub (CMH Center → Settings). Spiega ogni scheda presente sulla pagina, cosa controlla ciascun campo e come i valori vengono convalidati e memorizzati.

Quando utilizzare questo documento

Utilizza questo riferimento quando configuri il plugin per la prima volta, quando hai bisogno di verificare la funzione di un'opzione specifica o quando stai risolvendo un problema relativo a un comportamento che dipende da un'impostazione.

Panoramica

La schermata delle Impostazioni è organizzata come una pila verticale di schede. Ogni scheda ha il proprio pulsante Salva impostazioni, ma l'invio di uno qualsiasi di essi salva l'intera pagina. La pagina è suddivisa nelle seguenti sezioni:

Licenza e attivazione (mostrata nella parte superiore della pagina)
Fonti di dati e connessioni API (un rimando alla pagina Connessioni)
Impostazioni generali (valuta predefinita)
Pagine predefinite e shortcode
SEO e integrazioni
Funzionalità frontend
Funzionalità amministratore
Zona di pericolo

Credenziali API spostate. Le versioni precedenti configuravano la connessione API di AutoScout24 qui. Tutte le credenziali delle fonti di dati (AutoScout24, mobile.de, carcuro, feed, e-mail) vengono ora inserite nella pagina Connessioni, dove ogni fonte mostra anche il proprio stato di connessione. Vedi Riferimento Connections. La schermata delle Impostazioni conserva solo le opzioni generali.

Requisiti o prerequisiti

Accesso a CMH Center → Impostazioni (richiede la funzionalità di gestione del plugin).
Per le credenziali delle fonti di dati: utilizza la pagina Connections, non questa schermata.
Per le pagine predefinite: autorizzazione a creare pagine WordPress.

Istruzioni passo dopo passo

Apri CMH Center → Impostazioni.
Scegli la Valuta predefinita nella scheda Impostazioni generali. Per connettere una fonte di dati o inserire le credenziali API, utilizza il pulsante Gestisci fonti di dati (apre la pagina Connections).
Salva e conferma che non vi siano errori di convalida nella parte superiore dello schermo.
Facoltativamente, abilita Crea pagine predefinite al salvataggio in modo che il plugin crei automaticamente le pagine Veicoli, Confronta e Preferiti. In caso contrario, inserisci manualmente i relativi shortcode nelle pagine di tua scelta.
Esamina le schede SEO e integrazioni, Funzionalità frontend e Funzionalità amministratore e attiva le funzionalità di cui hai bisogno.
Abilita gli elementi nella Zona di pericolo solo dopo aver letto attentamente gli avvisi e aver creato un backup, se opportuno.

Riferimento per la configurazione

Licenza e attivazione

La scheda Licenza è la prima scheda nella pagina Impostazioni. ADP Car Market Hub è un prodotto con licenza: la licenza sblocca le aree premium (come AI Assistant, Content Studio e Market Insights) e consente gli aggiornamenti e il supporto. La chiave di licenza viene fornita da AD Promotion.

Come funziona la gestione delle licenze, passo dopo passo:

Attivare la licenza. Incolla la chiave fornita da AD Promotion nel campo Chiave di licenza e fai clic su Attiva. Il plugin contatta il servizio di licenza, convalida la chiave rispetto al dominio di questo sito e la memorizza mascherata. Se inserisci nuovamente una chiave, il pulsante mostrerà la dicitura Riattiva.
Controllare lo stato in qualsiasi momento. Fai clic su Controlla licenza ora per richiedere lo stato più recente al servizio di licenza. La scheda aggiornerà quindi lo Stato (ad esempio Attiva, Non attiva, Sospesa o Scaduta), il piano, le date di scadenza/supporto e le funzionalità incluse. Lo stesso stato della licenza viene mostrato anche come riquadro KPI sulla Dashboard e nella schermata di Supporto, in modo da poterlo visualizzare senza aprire le Impostazioni.
Vedere quali funzioni sono sbloccate. Quando la licenza è attiva, la scheda mostra una riga Funzionalità incluse che elenca le aree premium coperte dalla tua licenza (ad esempio AI Assistant, Content Studio, Market Insights). Ogni schermata premium riflette direttamente questo stato: se un'area è inclusa mostra i suoi normali controlli, se non è inclusa mostra invece una scheda "non incluso in questa licenza".
Riattivare o rimuovere. Utilizza Riattiva dopo un cambio di piano per recuperare i nuovi diritti, oppure Rimuovi licenza per cancellare la chiave memorizzata da questo sito (le aree premium verranno quindi bloccate di nuovo).

La maggior parte di questo processo viene eseguita autonomamente in background: il plugin ricontrolla periodicamente la licenza e mantiene aggiornato lo stato, quindi il controllo manuale tramite Controlla licenza ora serve principalmente per confermare immediatamente una modifica.

Elemento	Note
Chiave di licenza	Inserisci la chiave fornita da AD Promotion e fai clic su Attiva (o Riattiva). La chiave viene memorizzata mascherata e associata al dominio di questo sito; la chiave completa non verrà mai più visualizzata.
Stato	Lo stato attuale della licenza, ad esempio Attiva, Non attiva, Sospesa o Scaduta.
Controlla licenza ora	Ricontrolla la licenza con il servizio di licenza e aggiorna lo stato, il piano e le funzionalità incluse. Disponibile una volta memorizzata una chiave.
Rimuovi licenza	Rimuove la chiave memorizzata da questo sito. Le funzionalità premium che dipendono dalla licenza verranno nuovamente bloccate.

Quando una chiave è attiva, la scheda mostra anche dettagli in sola lettura: Piano, Scadenza, Supporto fino al, Dominio, Ultimo controllo, Versione segnalata, il limite di importazione e l'elenco delle Funzionalità incluse. Lo stesso stato della licenza viene evidenziato anche come KPI sulla Dashboard e nella schermata di Supporto.

Le aree premium che non fanno parte della tua licenza mostrano una scheda "non incluso in questa licenza" sulla propria pagina invece dei normali controlli (vedi Riferimento AI Assistant, Riferimento Content Studio e Riferimento Market Insights). In questo stato non c'è nulla di rotto: contatta il supporto di ADP Car Market Hub per abilitare l'area.

Fonti dati e connessioni API

Questa scheda non contiene campi. Si tratta di un semplice rimando che spiega che le fonti di dati sono configurate centralmente e fornisce un pulsante Gestisci fonti dati che rimanda alla pagina Connessioni. Lì puoi connettere AutoScout24, mobile.de, carcuro, un feed automatico o una casella di posta elettronica, inserire le credenziali API e visualizzare lo stato di connessione di ciascuna fonte. I dati sensibili come il Client Secret di AutoScout24, la password API di mobile.de e il token di carcuro sono memorizzati crittografati a riposo.

Impostazioni generali

Campo	Tipo	Note
Valuta predefinita	Selezione	Scegli uno dei codici ISO 4217 supportati: BGN, CHF, CZK, DKK, EUR, GBP, HUF, NOK, PLN, RON, RUB, SEK, TRY, UAH. I valori sconosciuti utilizzeranno EUR come fallback.

Pagine predefinite e shortcode

Campo	Tipo	Note
Crea pagine predefinite al salvataggio	Interruttore	Se selezionato e salvato, vengono create le pagine mancanti Cars, Compare Cars e Favorites. Le pagine esistenti non vengono sovrascritte.

La scheda elenca anche gli shortcode pronti per essere copiati:

[as24ci_archive] — elenco veicoli.
[as24ci_compare] — pagina di confronto.
[as24ci_favorites] — pagina dei preferiti / lista dei desideri.
[as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"] — esempio di elenco pre-filtrato.

Parametri [as24ci_archive] supportati come documentato nell'amministrazione: make, model, price_min, price_max, fuel, body, order_by (price / mileage / date), order (asc / desc), per_page (12 / 24 / 48 / 72 / all).

SEO e integrazioni

Campo	Predefinito	Note
Schema.org e Open Graph	Attivo	Genera dati strutturati JSON-LD e meta tag Open Graph / Twitter Card sulle pagine dei singoli veicoli.
Integrazione XML Sitemap	Attivo	Aggiunge gli articoli dei veicoli alle sitemap principali di WordPress con le date `lastmod` corrette. L'etichetta di amministrazione indica la compatibilità con Yoast SEO e Rank Math.
Reindirizza veicoli rimossi	Attivo	Quando l'URL di un veicolo venduto/rimosso restituirebbe un errore 404, esegue un reindirizzamento 301 a una ricerca pre-filtrata per la stessa marca e modello (scendendo a solo marca, poi all'archivio, in modo da non atterrare mai su un risultato vuoto). Evita i 404 senza uscita per i link indicizzati/condivisi senza creare catene di reindirizzamento.
REST API	Disattivato	Se abilitato, registra `GET /wp-json/as24ci/v1/vehicles` e `GET /wp-json/as24ci/v1/vehicles/{id}` per l'accesso esterno.

Funzionalità frontend

Campo	Predefinito	Note
Preferiti / Lista dei desideri	Attivo	Aggiunge le icone dei preferiti nell'archivio e la barra laterale mobile sulle singole pagine. La pagina dei preferiti può essere incorporata con `[as24ci_favorites]`. L'implementazione è basata su `localStorage`.
Confronta veicoli	Attivo	Aggiunge pulsanti di attivazione/disattivazione del confronto nell'archivio e nelle singole pagine. I veicoli selezionati possono essere visualizzati tramite `[as24ci_compare]`.
Calcolatore finanziario	Disattivato	Se abilitato, il calcolatore può essere posizionato tramite il Layout Manager in Singolo veicolo – Barra laterale, Contenuto principale singolo veicolo o Singolo veicolo – Sezione inferiore.
Tasso di interesse annuo (%)	3.9	Intervallo consentito 0–50, passo 0.1.
Durata del prestito (mesi)	48	Valori consentiti: 12, 24, 36, 48, 60, 72, 84.
Anticipo (%)	20	Intervallo consentito 0–100.

I valori di finanziamento sono predefiniti inseriti nel calcolatore sul frontend; i visitatori possono regolarli se il template del calcolatore lo consente.

Funzionalità di amministrazione

Campo	Predefinito	Note
Widget della dashboard	Attivo	Mostra il widget di panoramica delle statistiche dei veicoli sulla dashboard di WordPress.
Azioni di gruppo	Attivo	Aggiunge le azioni di gruppo Imposta come bozza, Imposta come pubblicato e Elimina con immagini alla tabella dell'elenco dei veicoli.
Esportazione veicoli	Attivo	Abilita l'esportazione CSV / JSON dei dati dei veicoli nella scheda Strumenti.

Zona di pericolo

Campo	Predefinito	Note
Elimina i veicoli importati e le immagini importate quando il plugin viene eliminato	Disattivato	Se abilitato, la disinstallazione del plugin rimuove le voci del custom post type Cars e i relativi allegati importati. Le pagine create dal plugin non vengono rimosse automaticamente.

Note operative

Ogni scheda ha il proprio pulsante di invio, ma ogni invio trasmette l'intero modulo. Il salvataggio di qualsiasi scheda rende persistente ogni campo della pagina.
Le credenziali API della sorgente dati non vengono inserite qui — si trovano nella pagina Connections. I segreti presenti in quella sezione (Client Secret AutoScout24, password API mobile.de, token carcuro, password feed/casella di posta) sono memorizzati crittografati a riposo.
L'attivazione del calcolatore di finanziamento non lo posiziona automaticamente sulla pagina — il posizionamento è controllato nel Layout Manager.
L'opzione REST API controlla solo gli endpoint pubblici dei veicoli. Gli endpoint AJAX di amministrazione interni utilizzati dal plugin non sono influenzati da questa opzione.
L'azione "Crea pagine predefinite al salvataggio" viene eseguita solo quando la casella di controllo è selezionata al momento del salvataggio. Deselezionarla in seguito non elimina le pagine create in precedenza.

Risoluzione dei problemi

Dove inserisco le credenziali API? Non qui. Apri la pagina Connections (o usa il pulsante Gestisci sorgenti dati) per connettere AutoScout24, mobile.de, carcuro, un feed o una casella di posta elettronica. La convalida delle credenziali e gli errori 401/403 sono trattati in quella sezione e in API Connection Errors.
Le pagine predefinite non sono state create. L'opzione agisce solo al momento del salvataggio. Assicurati che la casella sia selezionata quando fai clic su Salva e che l'utente WordPress disponga dei permessi per creare pagine.
La valuta non cambia nel frontend. Il campo memorizza un valore predefinito. Le valute specifiche per veicolo provenienti dal fornitore di dati possono sovrascrivere la visualizzazione a seconda dei template attivi. Verifica questo comportamento nella versione corrente del plugin prima della pubblicazione.
Il calcolatore di finanziamento è abilitato ma non è visibile. Aggiungi il blocco Calcolatore di finanziamento a una delle zone del Singolo Veicolo nel Layout Manager. La schermata delle Impostazioni non avvisa sul posizionamento; mostra solo una descrizione statica che rimanda al Layout Manager. Per evitare che il calcolatore appaia due volte, assicurati che sia aggiunto a una sola zona del Singolo Veicolo.