Documentazione · Riferimento amministratore
Riferimento impostazioni
Questo documento rappresenta il riferimento per la schermata delle Impostazioni del plugin ADP Car Market Hub (Car Market Hub → 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 serie di schede verticali. Ogni scheda ha il proprio pulsante Salva impostazioni, ma l'invio di una qualsiasi di esse salva l'intera pagina. La pagina è suddivisa nelle seguenti sezioni:
- Licenza e attivazione (mostrata nella parte superiore della pagina)
- Connessione API e impostazioni generali
- Pagine predefinite e shortcode
- SEO e integrazioni
- Funzionalità frontend
- Funzionalità di amministrazione
- Zona di pericolo
Requisiti o prerequisiti
- Accesso a Car Market Hub → Impostazioni (richiede la funzionalità di gestione del plugin).
- Per la connessione API: credenziali valide rilasciate dal tuo fornitore di dati (AutoScout24 o un endpoint di integrazione compatibile). Queste non sono fornite dal plugin e devono essere ottenute separatamente.
- Per le pagine predefinite: autorizzazione a creare pagine WordPress.
Istruzioni passo dopo passo
- Apri Car Market Hub → Impostazioni.
- Compila la scheda Connessione API e impostazioni generali con l'URL, il Seller ID e le credenziali fornite dal tuo provider, quindi scegli la valuta predefinita.
- 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à di amministrazione 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 di configurazione
Licenza e attivazione
La scheda Licenza è la prima scheda nella pagina delle 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 è fornita da AD Promotion.
Come funziona la licenza, passo dopo passo:
- Attiva 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.
- Verifica lo stato in qualsiasi momento. Fai clic su Verifica 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 un riquadro KPI sulla Dashboard e nella schermata di Supporto, in modo da poterlo visualizzare senza aprire le Impostazioni.
- Visualizza 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). Anche ogni schermata premium riflette direttamente questo stato: se un'area è inclusa mostrerà i suoi controlli normali, mentre se non è inclusa mostrerà invece una scheda "non inclusa in questa licenza".
- Riattiva o rimuovi. Utilizza Riattiva dopo una modifica del piano per applicare i nuovi diritti, oppure Rimuovi licenza per cancellare la chiave memorizzata da questo sito (le aree premium verranno quindi bloccate nuovamente).
La maggior parte di questo processo viene eseguita automaticamente in background: il plugin ricontrolla periodicamente la licenza e mantiene aggiornato lo stato, pertanto la verifica manuale tramite Verifica 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 corrente della licenza, ad esempio Attiva, Non attiva, Sospesa o Scaduta. |
| Verifica 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 visualizzato anche come KPI sulla Dashboard e nella schermata di Supporto.
Le aree premium che non fanno parte della tua licenza mostrano una scheda "non inclusa in questa licenza" sulla propria pagina invece dei controlli normali (vedi Riferimento AI Assistant, Riferimento Content Studio e Riferimento Market Insights). In questo stato non vi è alcuna anomalia: contatta il supporto di ADP Car Market Hub per abilitare l'area.
Connessione API e impostazioni generali
| Campo | Tipo | Note |
|---|---|---|
| URL di base dell'API | URL | URL completo inclusivo di https://. Convalidato lato server; gli slash finali vengono rimossi. Gli URL non validi vengono rifiutati e viene mantenuto il valore precedente. |
| Seller ID | Testo | Uno o più Seller ID separati da virgole, spazi o punti e virgola. Dopo la sanificazione vengono mantenuti solo lettere, cifre, trattini bassi e trattini. |
| Client ID | Testo | Identificatore client in stile OAuth fornito dal tuo provider. |
| Client Secret | Campo password | Memorizzato come testo opzione in chiaro nel database; tratta il campo di conseguenza. L'input viene visualizzato come un campo password per impedire la lettura da parte di terzi. |
| 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 tornano a EUR. |
Quando le credenziali cambiano, il plugin cancella il token di accesso memorizzato nella cache e lo stato della connessione API memorizzato nella cache, in modo che il caricamento successivo della pagina rifletta la nuova configurazione.
Pagine predefinite e shortcode
| Campo | Tipo | Note |
|---|---|---|
| Crea pagine predefinite al salvataggio | Interruttore | Se selezionato e salvato, vengono create le pagine mancanti per Veicoli, Confronta veicoli e Preferiti. Le pagine esistenti non vengono sovrascritte. |
La scheda elenca anche gli shortcode pronti per essere copiati:
[as24ci_archive]— elenco dei 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 & 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 i post 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. |
| 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. |
| Confronto 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 di finanziamento | 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, intervallo di incremento 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 e precompilati nel calcolatore sul frontend; i visitatori possono modificarli se il template del calcolatore lo consente.
Funzionalità di amministrazione
| Campo | Predefinito | Note |
|---|---|---|
| Widget della bacheca | Attivo | Mostra il widget panoramica delle statistiche dei veicoli sulla bacheca 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 dei Veicoli 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 memorizza ogni campo della pagina.
- Le credenziali API sono memorizzate nella tabella delle opzioni di WordPress. Chiunque abbia accesso al database o all'esportazione dell'amministratore può leggerle; proteggi il sito di conseguenza.
- L'attivazione del calcolatore di finanziamento non lo posiziona automaticamente sulla pagina: il posizionamento è controllato nel Layout Manager.
- L'interruttore REST API controlla solo gli endpoint pubblici dei veicoli. Gli endpoint AJAX interni di amministrazione utilizzati dal plugin non sono interessati da questo interruttore.
- L'azione "Crea pagine predefinite al salvataggio" viene eseguita solo quando la casella è selezionata al momento del salvataggio. Deselezionarla in seguito non elimina le pagine create in precedenza.
Risoluzione dei problemi
- Errore "L'URL di base dell'API non è un URL valido". Il valore non ha superato
FILTER_VALIDATE_URL. Inserisci l'URL completo includendo il protocollo (https://) e senza caratteri aggiuntivi. Il valore precedente viene mantenuto fino a quando non viene fornito un URL valido. - Le importazioni restituiscono errori 401 / 403 dopo il salvataggio delle credenziali. Verifica il Client ID, il Client Secret e il Seller ID con il tuo provider. La cache dei token viene cancellata al salvataggio, quindi la richiesta successiva utilizzerà i nuovi valori.
- Le pagine predefinite non sono state create. L'interruttore agisce solo al momento del salvataggio. Assicurati che l'interruttore sia selezionato quando fai clic su Salva e che l'utente WordPress disponga dell'autorizzazione per creare pagine.
- La valuta non cambia nel frontend. Il campo memorizza un valore predefinito. Le valute per singolo 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.