Documentazione · Iniziare

Prima configurazione

Questa guida spiega cosa dovrebbe configurare un amministratore WordPress dopo aver attivato il plugin ADP Car Market Hub e in quale ordine. Seguire la sequenza consigliata evita i rifacimenti più comuni, come ad esempio l'esecuzione di un'importazione prima che la connessione API sia convalidata o la messa online prima che il frontend sia stato verificato su una pagina reale del veicolo.

Questo documento copre il flusso di configurazione. Il materiale di riferimento dettagliato per ciascuna scheda di amministrazione è disponibile nella sezione Riferimento amministratore. Un riferimento dedicato alla procedura guidata di Prima configurazione integrata nel plugin è fornito in Riferimento alla procedura guidata di configurazione.

Prima configurazione guidata

ADP Car Market Hub viene fornito con una Prima configurazione guidata che guida l'amministratore attraverso le scelte di configurazione più comuni in sette passaggi concisi. Il primo passaggio è l'attivazione della licenza, che è obbligatoria: finché non viene attivata una licenza valida, ogni passaggio operativo della procedura guidata (e ogni scheda di amministrazione del plugin diversa da Impostazioni) rimane bloccato. Una volta attiva la licenza, i passaggi rimanenti rappresentano il punto di ingresso consigliato sia per le valutazioni demo che per le distribuzioni live di AutoScout24, ma non sono obbligatori: ogni opzione che offrono può essere configurata anche manualmente utilizzando le normali schede di amministrazione documentate nel Riferimento amministratore.

Cosa fa la procedura guidata

Attiva la tua licenza come primo passaggio. La licenza sblocca le aree premium del plugin; senza di essa la procedura guidata non può procedere oltre la schermata della licenza e le altre schede di amministrazione mostrano una schermata "Licenza richiesta".
Consente all'amministratore di scegliere tra Configurazione demo (installa veicoli demo, applica le impostazioni predefinite demo e abilita l'analisi in modo che le pagine Dashboard e Analytics abbiano dati da visualizzare) e Configurazione live di AutoScout24 (salva le credenziali reali e le pagine selezionate senza installare dati demo).
Acquisisce il profilo del rivenditore (nome, indirizzo, dettagli di contatto, logo).
Acquisisce la connessione AutoScout24 (Client ID, Client Secret, Seller ID, API Base URL).
Facoltativamente, crea le pagine pubbliche Auto, Confronta auto e Preferiti con gli shortcode canonici.
Attiva o disattiva le funzionalità predefinite più comuni (condivisione social, PDF datasheet, codice QR PDF, costi di gestione per 100 km, Confronta, Preferiti, Avvisi di ricerca, tracciamento Analytics).
Contrassegna la configurazione come completata e reindirizza l'amministratore alla Dashboard.

Quando appare la procedura guidata

Dopo la prima attivazione del plugin, un avviso amministrativo intitolato Benvenuto in ADP Car Market Hub appare in cima a ogni pagina di amministrazione di WordPress.
L'avviso non è un reindirizzamento forzato: l'amministratore può continuare a navigare in WordPress e avviare la procedura guidata in un secondo momento.
L'avviso viene mostrato solo quando si verificano tutte le seguenti condizioni:
L'utente corrente ha la capacità di gestione del plugin.
È stato registrato un timestamp di prima attivazione.
La procedura guidata non è stata contrassegnata come completata.
La procedura guidata non è stata contrassegnata come saltata.
Gli aggiornamenti del plugin che non attivano una nuova attivazione non fanno apparire l'avviso sulle installazioni esistenti.

Come avviare la procedura guidata

Fai clic su Avvia configurazione guidata nell'avviso di benvenuto, oppure
Apri Car Market Hub → Dashboard e usa il link Esegui configurazione guidata in alto, oppure
Apri Car Market Hub → Strumenti e usa la scheda Configurazione guidata.

La procedura guidata è registrata come una pagina di amministrazione nascosta raggiungibile su wp-admin/admin.php?page=as24ci-setup-wizard. I controlli di capacità e nonce sono applicati a ogni passaggio.

Come saltare la procedura guidata

Fai clic su Salta per ora nell'avviso di benvenuto. L'avviso non riapparirà ai successivi caricamenti delle pagine di amministrazione.
La procedura guidata rimane raggiungibile dalla Dashboard e dalla scheda Strumenti in modo da poter essere ripresa in qualsiasi momento.

Passaggi della procedura guidata

Licenza — inserisci e attiva la tua chiave di licenza. Questo passaggio è obbligatorio per primo; la procedura guidata non può continuare con nessun passaggio operativo finché la licenza non è attiva. La chiave di licenza è di sola scrittura e non viene mai precompilata sullo schermo.
Modalità — scegli Configurazione demo o Configurazione live di AutoScout24; seleziona il paese del rivenditore, la valuta e la lingua dell'amministratore.
Profilo rivenditore — nome, via, codice postale, città, paese, telefono, email, sito web, logo.
AutoScout24 — Client ID, Client Secret, Seller ID e API Base URL. Il campo Client Secret viene intenzionalmente renderizzato vuoto (vedi Configurazione delle credenziali API).
Pagine — per ciascuna pagina pubblica (Auto, Confronta auto, Preferiti) scegli Crea automaticamente, Usa pagina esistente o Salta.
Funzionalità — abilita o disabilita le funzionalità predefinite elencate sopra.
Fine — rivedi il riepilogo e conferma. In modalità Demo, il passaggio finale avvia anche l'installatore dei dati demo esistenti; in modalità Live, salva solo le impostazioni della procedura guidata.

Sicurezza dell'installazione esistente

L'attivazione del plugin inserisce solo valori predefiniti non distruttivi; non sovrascrive mai i valori delle opzioni esistenti.
La disattivazione e la riattivazione del plugin non riaprono automaticamente la procedura guidata e non sovrascrivono le impostazioni.
La procedura guidata modifica solo le impostazioni i cui campi del modulo vengono effettivamente inviati dall'amministratore.
La configurazione Demo è l'unico percorso che installa dati demo e ripristina le opzioni controllate dalla demo; si tratta di un'operazione esplicita di ripristino e inserimento dati. La configurazione Live non è distruttiva rispetto ai veicoli e alle impostazioni del cliente.

Per tutti i dettagli su flag, capacità, URL della pagina di amministrazione nascosta e comportamento di memorizzazione dei passaggi, vedi Riferimento alla procedura guidata di configurazione.

Quando utilizzare questo documento

Usa questo documento se stai:

Configurando ADP Car Market Hub su un'installazione appena attivata.
Riconfigurando il plugin dopo una migrazione del server, una ricostruzione dell'ambiente o un passaggio da staging a produzione.
Documentando un processo di onboarding ripetibile per il sito di un nuovo cliente.

Il pubblico di riferimento è un amministratore WordPress che ha già completato la Guida all'installazione e ha accesso alle credenziali API di AutoScout24 fornite dall'account del rivenditore o dal loro partner di integrazione.

Prima di iniziare

Conferma quanto segue prima di iniziare la configurazione:

Il plugin è installato e attivato e il menu Car Market Hub appare nell'amministrazione di WordPress.
Il sito soddisfa tutte le voci della Lista di controllo pre-installazione.
Hai la tua chiave di licenza di ADP Car Market Hub. La licenza è necessaria per sbloccare le aree premium del plugin: finché non viene attivata, ogni scheda di amministrazione eccetto Impostazioni mostra una schermata "Licenza richiesta" e le importazioni, il cron e le altre funzionalità rimangono bloccati.
Hai le credenziali API di AutoScout24 richieste dal tuo account: API Base URL, Seller ID, Client ID e Client Secret. Questi dati provengono dall'account AutoScout24 del rivenditore o dal partner di integrazione che gestisce l'accesso alle API. Il plugin non li fornisce.
Hai deciso le impostazioni aziendali predefinite che influenzeranno la configurazione: valuta predefinita, quale testo legale/di consenso il rivenditore desidera sui moduli di contatto e quali funzionalità (prenotazione Test Drive, Avvisi di ricerca, AI Assistant, Analytics) devono essere abilitate al lancio.
È presente un backup del sito WordPress e, idealmente, la configurazione viene eseguita su un ambiente di staging che rispecchia la produzione.

Ordine di configurazione consigliato

I seguenti dieci passaggi rappresentano la sequenza consigliata. Ogni passaggio si basa sul precedente. Non saltare passaggi in avanti; ad esempio, non abilitare le importazioni automatiche prima che il test di connessione sia andato a buon fine.

Attivazione della licenza
Prontezza del sistema
Credenziali API
Test di connessione
Impostazioni di importazione
Impostazioni di layout e frontend
Impostazioni legali, sulla privacy e sul consenso
Importazione di prova
Validazione del frontend
Controlli pre-messa online

Istruzioni passo dopo passo

Passo 1 — Attivazione della licenza

Apri Car Market Hub → Settings e completa la scheda License Activation nella parte superiore della pagina. Inserisci la tua chiave di licenza e fai clic su Activate. Un'attivazione riuscita sblocca le aree premium del plugin; le schede di amministrazione di Car Market Hub diverse da Settings smetteranno di mostrare la schermata "License required" e diventeranno disponibili le importazioni, il cron e l'elaborazione in background.

La chiave di licenza è di sola scrittura: non viene mai mostrata nuovamente dopo il salvataggio. La stessa scheda offre anche Check license (convalida nuovamente la chiave memorizzata) e Remove license (cancella la chiave mantenendo i veicoli importati, le pagine e i media). Se hai iniziato con il First Setup Wizard, l'attivazione della licenza è il primo passo, quindi questa operazione è già stata completata.

Non continuare finché la licenza non è attiva. Senza di essa, le restanti schede di configurazione rimangono bloccate.

Passo 2 — Idoneità del sistema

Apri Car Market Hub → System & Help e controlla le verifiche dell'ambiente. La pagina segnala lo stato di PHP, JSON, OpenSSL, cURL, GD/Imagick, della directory dei caricamenti, della pianificazione del cron, della cache dei token, del file di log e della coda delle immagini, con badge di stato in stile semaforo.

Risolvi eventuali badge rossi prima di continuare. Le azioni tipiche includono l'abilitazione di un'estensione PHP mancante, la correzione dei permessi sulla directory dei caricamenti o la risoluzione di un WP-Cron non funzionante.

Per un esame più approfondito dell'ambiente, consulta Technical System Requirements e API, Network and SSL Requirements.

Passo 3 — Credenziali API

Apri Car Market Hub → Settings e completa la scheda API Connection & General Settings:

API Base URL — l'URL HTTPS completo per il tuo ambiente AutoScout24 o endpoint di integrazione, incluso https://.
Seller ID — uno o più Seller ID, separati da virgole se gestisci più account venditore.
Client ID e Client Secret — le credenziali rilasciate per l'accesso alle tue API.
Default currency — la valuta utilizzata quando un annuncio importato non ne fornisce una.

Fai clic su Save Settings in fondo alla scheda.

Una guida completa di ogni campo delle credenziali, da dove proviene e come gestirlo in sicurezza è fornita in Configurazione delle credenziali API. Per informazioni preliminari sull'ottenimento dell'accesso alle API, consulta AutoScout24 API Setup e External API Credentials.

Passo 4 — Test di connessione

Dopo aver salvato le credenziali, convalidale prima di qualsiasi importazione. Apri Car Market Hub → Tools e utilizza la scheda API Connection Test. Fai clic su Test Connection. Un test riuscito conferma che il plugin può autenticarsi con l'endpoint del token configurato e raggiungere l'API degli annunci AutoScout24 per il primo Seller ID configurato.

Non procedere alle impostazioni di importazione finché il test di connessione non ha esito positivo. La procedura completa, compreso come interpretare il risultato e come reagire agli errori comuni, è documentata nel Test di connessione.

Passo 5 — Impostazioni di importazione

Una volta che la connessione funziona, configura il modo in cui i veicoli vengono importati. Le impostazioni pertinenti si trovano in due punti:

Car Market Hub → Settings — opzioni per le immagini (se importare le immagini, numero massimo di immagini per veicolo, conversione WebP opzionale e qualità), stato predefinito dell'articolo e autore dell'articolo per i veicoli appena creati, e l'opzione Default pages che può creare le pagine Cars, Compare Cars e Favorites al momento del salvataggio.
Car Market Hub → Import & Limits — pianificazione e comportamento in fase di esecuzione: l'intervallo di WP-Cron (orario, ogni 6 ore, due volte al giorno, giornaliero o personalizzato), l'ora di inizio per le pianificazioni giornaliere/due volte al giorno, la modalità opzionale Full Sync (che elimina i veicoli locali non più presenti su AutoScout24) e le impostazioni di robustezza del cron (numero massimo di veicoli per esecuzione del cron, attivazione/disattivazione della coda delle immagini).

Per la configurazione iniziale, scegli valori prudenti:

Lascia la pianificazione automatica disabilitata per ora. Pianificala dopo un'importazione di prova riuscita.
Mantieni la coda delle immagini abilitata in modo che le esecuzioni del cron non superino i timeout di PHP.
Lascia Full Sync disabilitato finché non avrai verificato che tutti i veicoli previsti arrivino correttamente. Full Sync elimina in modo permanente gli articoli locali, comprese le immagini, per qualsiasi annuncio non restituito dall'API.

Per il cron esterno (a livello di server), incluso l'endpoint REST protetto da token, consulta Server Cron Setup.

Passo 6 — Impostazioni di layout e frontend

Configura il modo in cui i veicoli verranno presentati sul frontend prima di mostrarli ai visitatori:

Car Market Hub → Design & Styles — colori, font, layout dell'archivio e del singolo veicolo, layout della galleria, lightbox, badge delle condizioni e testo introduttivo/piè di pagina nelle pagine di archivio.
Car Market Hub → Layout Manager — abilita/disabilita i singoli filtri che appaiono nell'archivio auto (marca, modello, anno, prezzo, chilometraggio, carburante, cambio, colore, carrozzeria e altri).
Car Market Hub → Mapping — controlla le etichette leggibili e la visibilità di ciascun campo dati AutoScout24 nelle pagine di dettaglio. I valori predefiniti sono sensati; modifica solo le etichette o la visibilità che desideri effettivamente cambiare.
Car Market Hub → Shortcodes & Widgets — il riferimento per gli shortcode utilizzati nei layout di pagina personalizzati (ad esempio le pagine di confronto e dei preferiti). Se hai abilitato l'opzione Default pages in Settings, le pagine corrispondenti esistono già; in caso contrario, inserisci gli shortcode manualmente.

Passo 7 — Impostazioni legali, privacy e consenso

ADP Car Market Hub elabora i dati dei lead e, facoltativamente, le iscrizioni agli avvisi di ricerca. Configura le impostazioni corrispondenti prima di andare online:

Car Market Hub → Leads — configura l'indirizzo email del destinatario, i campi visibili del modulo, la casella di controllo del consenso (etichetta e stato obbligatorio) e i messaggi di notifica. Il testo del consenso e i campi visibili devono riflettere l'informativa sulla privacy del concessionario.
Car Market Hub → Leads — configura anche le opzioni di prenotazione del Test Drive (giorni feriali disponibili, fascia oraria giornaliera, durata dello slot, date di esclusione) in questa scheda. Car Market Hub → Search Alerts — se la funzionalità Search Alerts è abilitata nella scheda Settings (o nel Setup Wizard), gestisci qui le iscrizioni. Search Alerts utilizza la conferma email Double-Opt-In conforme al GDPR; i modelli di email per le notifiche al concessionario e al cliente sono configurati rispettivamente nella scheda Search Alerts e nella scheda Leads.
Informativa sulla privacy del sito — il sito WordPress deve avere un'informativa sulla privacy pubblicata che copra i dati raccolti dal plugin (dati del modulo di contatto, eventi di analisi opzionali, iscrizioni opzionali agli avvisi di ricerca).

Le informazioni di base sono disponibili in Lead Data and Consent, Search Alerts Double Opt-In, GDPR / DSGVO Notes e nella Data Storage Overview.

Passo 8 — Importazione di prova

Esegui un'importazione limitata e controllata prima di abilitare la pianificazione automatica.

Due opzioni sicure:

Dry run. Apri Car Market Hub → Tools e utilizza la scheda Dry Run. Recupera un'anteprima degli annunci per i Seller ID configurati senza scrivere alcun articolo di veicolo. Questo convalida che le credenziali raggiungano i dati reali senza modificare il sito.
Importazione manuale tramite Car Importer. Apri Car Market Hub → Car Importer. Visualizza l'anteprima degli annunci restituiti dall'API e avvia un'importazione per uno o due singoli veicoli. Questo crea veri articoli as24ci_car e allega le immagini, rappresentando quindi il modo più rapido per convalidare l'intero percorso di importazione end-to-end.

Una volta che una piccola importazione ha esito positivo, esegui un'importazione manuale completa tramite il Batch-Wizard su Car Market Hub → Import & Limits. Il Batch-Wizard viene eseguito in lotti adattivi con una barra di avanzamento e può essere messo in pausa, ripreso o interrotto.

Controlla successivamente la scheda Logs per confermare che non vi siano stati avvisi o errori.

Passo 9 — Validazione del frontend

Dopo l'importazione di prova, convalida il frontend con dati reali:

Apri la pagina di archivio Cars (o la pagina in cui è incorporato l'archivio dei veicoli). Conferma che le schede dei veicoli vengano visualizzate correttamente, che le immagini vengano caricate, che i filtri funzionino come configurato e che la paginazione si comporti come previsto.
Apri almeno una pagina del singolo veicolo. Conferma la galleria, la tabella dei dettagli del veicolo, l'elenco degli equipaggiamenti, la formattazione del prezzo, il modulo di contatto (e la casella di controllo del consenso) e tutte le funzionalità opzionali abilitate (calcolatore di finanziamento, modulo di Test Drive, condivisione social).
Invia un modulo di contatto di prova dalla pagina del singolo veicolo. Conferma che il lead appaia sotto Car Market Hub → Leads e che l'email del destinatario venga recapitata.
Se gli avvisi di ricerca sono abilitati, completa un'iscrizione di prova inclusa l'email di conferma Double-Opt-In.
Se l'AI Assistant è abilitato, verifica su almeno un veicolo che la descrizione generata dall'intelligenza artificiale (e altri output AI abilitati) sia accettabile per la pubblicazione.

Risolvi eventuali problemi — etichette, campi mancanti, layout — regolando la scheda pertinente (Mapping, Design & Styles, Layout Manager, Leads, Settings) e convalidando nuovamente.

Passo 10 — Controlli per la messa online

Solo dopo aver completato i passaggi precedenti, prepara il sito per la messa online:

Abilita le importazioni automatiche su Car Market Hub → Import & Limits con un intervallo sensato (per molti concessionari è appropriata una pianificazione oraria; i cataloghi più piccoli possono utilizzare quella giornaliera). Sugli hosting che limitano WP-Cron, configura un vero processo cron di sistema che punti all'endpoint REST protetto da token del plugin, come descritto in Server Cron Setup.
Decidi se abilitare Full Sync in modo che gli annunci rimossi su AutoScout24 vengano rimossi anche dal sito. Abilita questa opzione solo dopo aver verificato che tutti i veicoli previsti appaiano costantemente nell'importazione.
Esegui nuovamente il Test di connessione come controllo finale di integrità.
Segui la Go Live Checklist per verificare ogni restante elemento trasversale (DNS, caching, visibilità sui motori di ricerca, monitoraggio).

Note di configurazione

La pagina Settings salva solo le schede visibili. La pagina Settings raggruppa le opzioni in schede (API Connection & General Settings, Default Pages & Shortcodes, ecc.) ciascuna con il proprio pulsante Save. Salva la scheda che hai modificato prima di navigare altrove.
Pagine predefinite. Se l'opzione Default pages è abilitata e le pagine corrispondenti non esistono ancora, il salvataggio di Settings crea automaticamente le pagine Cars, Compare Cars e Favorites. Se gestisci queste pagine manualmente, lascia l'opzione disabilitata e inserisci gli shortcode dalla scheda Shortcodes & Widgets.
Valuta predefinita. La valuta predefinita influisce solo sulle importazioni nuove o aggiornate per le quali l'API non restituisce alcun valore di valuta. Gli articoli esistenti mantengono la valuta memorizzata.
Mappatura vs. tassonomie. La scheda Mapping controlla le etichette e la visibilità dei campi solo nelle tabelle di dettaglio. Non modifica le tassonomie WordPress sottostanti che memorizzano i valori degli attributi importati. Rinomina un'etichetta di mappatura non sposta i termini delle tassonomie esistenti.
Coda delle immagini. Quando la coda delle immagini è abilitata, le importazioni cron scaricano in modo sincrono solo la prima immagine per veicolo; le restanti immagini vengono elaborate in modo asincrono da un worker in background. Questa è l'impostazione predefinita consigliata e previene i timeout di PHP su cataloghi di grandi dimensioni.
Full Sync è distruttivo. Full Sync elimina in modo permanente gli articoli delle auto locali (comprese le immagini) per gli annunci non più restituiti dall'API. Trattala come un'opzione di livello di produzione e abilitala solo quando le importazioni sono stabili.

Note operative

Prima in staging, poi in produzione. Tutti i passaggi di configurazione descritti in questo documento devono essere eseguiti prima su una copia di staging. Una volta che la concessionaria ha approvato il comportamento in staging, replica la configurazione in produzione. Non esportare e importare l'intero database WordPress tra staging e produzione, a meno che tu non comprenda l'impatto su URL, opzioni e ID.
Operatività quotidiana. Dopo la configurazione, le responsabilità quotidiane (monitoraggio delle importazioni, gestione dei lead, revisione dei log) sono trattate in Operatività quotidiana e nel Manuale utente.
Funzionalità e delega. La configurazione iniziale richiede un amministratore WordPress completo. Per le operazioni correnti, il plugin fornisce una funzionalità e un ruolo delegati, in modo che gli utenti quotidiani non abbiano bisogno dei diritti completi di amministrazione di WordPress. Vedi Controllo degli accessi e funzionalità.
Registrazione dei log. Tutte le chiamate API, le richieste di token, le azioni di importazione e gli errori vengono registrati nei file di log del plugin in wp-content/uploads/as24ci-logs/ con rotazione. La registrazione dettagliata (verbose) aggiunge dettagli per singolo veicolo e singola immagine e dovrebbe essere abilitata temporaneamente solo per la risoluzione dei problemi.

Risoluzione dei problemi

Sintomo	Causa probabile	Cosa verificare
Sistema & Supporto mostra badge rossi subito dopo l'attivazione.	L'ambiente di hosting non soddisfa i requisiti del plugin (estensione PHP mancante, directory di upload non scrivibile, WP-Cron non funzionante).	Risolvi ogni badge rosso con il tuo fornitore di hosting prima di continuare. Vedi Requisiti tecnici di sistema.
La pagina delle impostazioni non salva le credenziali o i campi appaiono vuoti dopo il salvataggio.	Modulo inviato dalla scheda errata, pagina memorizzata nella cache del browser o un plugin di sicurezza che blocca la richiesta.	Salva la scheda corretta. Ricarica la pagina. Disabilita temporaneamente altri plugin che filtrano le richieste `POST`.
Il test di connessione fallisce.	URL di base API errato, credenziali errate, HTTPS in uscita bloccato, problemi di SSL/firewall.	Segui Test di connessione e Errori di connessione API.
L'importazione di prova importa zero veicoli.	Il Seller ID configurato non ha annunci, le credenziali si autenticano su un account diverso o l'API ha restituito un risultato vuoto.	Ricontrolla il Seller ID con l'account AutoScout24 del rivenditore; conferma tramite la Simulazione in Strumenti.
Le pagine dei veicoli vengono visualizzate senza immagini o le immagini appaiono in un secondo momento.	La coda delle immagini è abilitata (comportamento previsto) e il processo in background non ha ancora elaborato la coda, oppure i timeout di PHP stanno interrompendo i download.	Usa lo stato della coda delle immagini in Sistema & Supporto; avvia Esegui coda immagini ora. Vedi Errori di importazione immagini.
Le importazioni tramite cron non vengono eseguite automaticamente dopo aver abilitato la pianificazione.	WP-Cron è disabilitato o limitato dall'host.	Configura un cron server esterno che punti all'endpoint REST del plugin. Vedi Configurazione del cron del server e Errori di cron.
Le email dei lead non vengono ricevute.	Il sito non può inviare email o l'indirizzo del destinatario è errato.	Verifica l'email del destinatario sotto Lead e la configurazione della posta in uscita del sito. Vedi Errori di email e lead.