Documentazione · Manuale utente

Manuale dell'amministratore

Questo manuale documenta le responsabilità amministrative per il plugin ADP Car Market Hub WordPress. Copre la gestione della configurazione iniziale, i permessi utente, la configurazione dell'importazione, le operazioni pianificate, il monitoraggio dello stato del sistema e il coordinamento del supporto.

Quando utilizzare questo documento

Leggere questo documento se:

Si è un amministratore di WordPress responsabile dell'installazione, della configurazione e della manutenzione del plugin.
È necessario comprendere quali permessi sono richiesti e come gestirli.
Si è responsabili di garantire che le importazioni vengano eseguite in modo affidabile e di indagare su eventuali errori.
Ci si coordina con il supporto tecnico o con un partner di integrazione.

Per le attività operative quotidiane, come il controllo dello stato dell'importazione, la revisione dei lead e la convalida del frontend, consultare i Flussi di lavoro per l'uso quotidiano.

Panoramica

ADP Car Market Hub richiede un'attenta configurazione iniziale prima di poter importare qualsiasi veicolo. L'amministratore è responsabile di:

Inserire e mantenere credenziali API valide.
Configurare la pianificazione dell'importazione e scegliere tra WP-Cron e cron del server.
Impostare lo stato predefinito corretto dell'articolo, l'autore, la gestione delle immagini e la valuta.
Concedere o limitare l'accesso all'interfaccia di amministrazione del plugin.
Gestire i contatti di vendita della concessionaria mostrati ai clienti e utilizzati per l'instradamento dei lead (CMH Team).
Monitorare lo stato di salute del plugin, l'output dei log e il successo dell'importazione.
Coordinarsi con AutoScout24 o con il proprio partner di integrazione in caso di problemi con le API.

Requisiti o prerequisiti

È richiesto l'accesso come amministratore di WordPress per installare il plugin e gestire le funzionalità.
Sul server devono essere in esecuzione PHP 8.1 o versioni successive e WordPress 6.2 o versioni successive.
Le credenziali API valide di AutoScout24 (API Base URL, Seller ID, Client ID, Client Secret, Token URL, Audience) devono essere ottenute da AutoScout24 o dal proprio partner di integrazione prima della configurazione. Il plugin non può importare veicoli senza di esse.
Il server deve consentire connessioni HTTPS in uscita verso l'endpoint API configurato.
Se si preferisce il cron del server rispetto a WP-Cron, l'ambiente di hosting deve supportare le attività pianificate (crontab o equivalente).

Permessi e funzionalità

Funzionalità di gestione del plugin

Il plugin introduce una funzionalità personalizzata di WordPress: manage_as24_imports.

Questa funzionalità è richiesta per accedere al menu di amministrazione di ADP Car Market Hub, eseguire importazioni, modificare le impostazioni, visualizzare i lead e utilizzare tutti gli strumenti di amministrazione.
All'attivazione, agli amministratori di WordPress (ruolo administrator) viene assegnata automaticamente la funzionalità manage_as24_imports.
Gli altri ruoli utente (editore, gestore del negozio, ecc.) non ricevono questa funzionalità per impostazione predefinita. Un amministratore di WordPress deve concederla esplicitamente utilizzando un plugin per la gestione dei ruoli o del codice personalizzato se l'accesso è richiesto per utenti non amministratori.

Funzionalità dei post di WordPress

Il custom post type as24ci_car (il menu CMH Cars) utilizza le proprie funzionalità dedicate di WordPress (edit_as24ci_cars, publish_as24ci_cars e così via). I record dei veicoli appaiono sotto CMH Cars → All Cars, non nella schermata standard dei Post di WordPress. L'accesso alle pagine di amministrazione dedicate del plugin sotto CMH Center e CMH Team richiede inoltre la funzionalità manage_as24_imports.

Protezione delle impostazioni sensibili

Le credenziali API (Client ID e Client Secret) sono memorizzate nella tabella delle opzioni di WordPress. L'accesso alla scheda Impostazioni è protetto dalla funzionalità manage_as24_imports. Assicurarsi che solo gli amministratori fidati dispongano di questa funzionalità.

Configurazione iniziale

Seguire questi passaggi quando si configura il plugin per la prima volta:

Installare e attivare il plugin tramite Amministrazione di WordPress → Plugin → Aggiungi nuovo o caricando l'archivio del plugin.
Navigare su ADP Car Market Hub → Settings.
Inserire l'API Base URL per il proprio ambiente AutoScout24. Gli URL di base comuni includono gli host API regionali di AutoScout24 (verificare l'URL corretto con AutoScout24 o con il proprio partner di integrazione).
Inserire uno o più Seller ID (separati da virgole) corrispondenti ai propri account rivenditore AutoScout24.
Inserire il Client ID e il Client Secret forniti da AutoScout24.
Inserire il Token URL e l'Audience se differiscono da quelli predefiniti derivati dall'URL di base.
Impostare la Valuta predefinita in modo che corrisponda alla valuta utilizzata nei propri annunci.
Configurare lo Stato predefinito dell'articolo (publish per rendere i veicoli visibili immediatamente, draft per esaminarli prima della pubblicazione).
Impostare l'Autore predefinito dell'articolo sull'utente di WordPress che deve essere indicato come autore dei post dei veicoli.
Configurare le impostazioni di importazione delle immagini: se importare le immagini, il numero massimo di immagini per veicolo e le opzioni di conversione WebP.
Selezionare l'opzione Crea pagine predefinite per fare in modo che il plugin crei automaticamente l'archivio dei veicoli e le pagine di confronto.
Fare clic su Salva impostazioni.
Utilizzare il test di connessione nella scheda System & Help o Tools per confermare che le credenziali API funzionino.
Navigare su Import & Limits ed eseguire l'importazione completa iniziale utilizzando il Batch-Wizard.

Configurazione della pianificazione dell'importazione

WP-Cron (predefinito)

WordPress ha un sistema cron integrato (WP-Cron) che si attiva al caricamento delle pagine. Questo è sufficiente per molti siti, ma potrebbe subire ritardi sui siti a basso traffico.

Navigare su ADP Car Market Hub → Import & Limits.
Abilitare l'Importazione automatica.
Scegliere l'intervallo: ogni ora, ogni 6 ore, due volte al giorno, giornaliero o un intervallo personalizzato (minimo 15 minuti).
Per le pianificazioni giornaliere e due volte al giorno, impostare l'orario di inizio preferito.
Salvare le impostazioni di automazione.

Cron del server (consigliato per la produzione)

Per una pianificazione affidabile, configurare un cron del server esterno per chiamare l'endpoint REST del plugin:

Navigare su ADP Car Market Hub → Import & Limits.
Impostare la Modalità Cron su Cron del server.
Copiare l'URL dell'endpoint cron visualizzato (include un token di sicurezza).
Aggiungere un processo cron sul proprio server (ad esempio, utilizzando crontab) per chiamare questo URL all'intervallo desiderato utilizzando curl o wget.
Se è necessario rigenerare il token (ad esempio, dopo un incidente di sicurezza), fare clic su Rigenera token nella stessa scheda e aggiornare il processo cron del server con il nuovo URL.

Blocco dell'importazione

Il plugin utilizza un blocco basato su transient (circa 40 minuti) per evitare l'esecuzione di importazioni sovrapposte. Se un'importazione è già in corso e arriva un secondo avvio (da WP-Cron, cron del server o un avvio manuale), la seconda esecuzione viene saltata. Questo è un comportamento normale.

Gestione dell'importazione delle immagini

Modalità coda immagini: Durante le importazioni cron pianificate, solo la prima immagine per veicolo viene scaricata immediatamente. Le immagini rimanenti vengono elaborate da un gestore della coda in background circa ogni 5 minuti. Ciò evita errori di timeout PHP durante importazioni di grandi dimensioni.
Monitoraggio della coda immagini: La scheda System & Help mostra la dimensione corrente della coda delle immagini e un avviso se la coda supera i 1.000 elementi.
Elaborazione manuale della coda: Utilizzare il pulsante Esegui coda immagini ora nella scheda System & Help per elaborare immediatamente la coda.
Svuota coda immagini: Il pulsante Svuota coda immagini nella stessa scheda rimuove tutte le voci di immagini in sospeso senza elaborarle. Usare con cautela.
Conversione WebP: Se abilitata, le immagini scaricate vengono convertite nel formato WebP utilizzando GD o Imagick. La scheda System & Help mostra se queste estensioni sono disponibili.

Sincronizzazione completa (Full Sync)

La sincronizzazione completa (Full Sync) è un'impostazione presente nella scheda Import & Limits che, se abilitata, elimina in modo permanente qualsiasi post di veicolo in WordPress che non è più presente nell'elenco attivo di AutoScout24 per i Seller ID configurati.

Utilizzare la sincronizzazione completa solo quando si desidera che WordPress rispecchi esattamente l'inventario attivo di AutoScout24. Quando è abilitata:

Qualsiasi post di veicolo locale non trovato nell'elenco remoto corrente viene eliminato in modo permanente, incluse tutte le immagini allegate.
Ciò include i veicoli che sono stati modificati manualmente, arricchiti con contenuti aggiuntivi o impostati sullo stato di bozza.
L'eliminazione viene registrata nel file di log del plugin.

Disabilitare la sincronizzazione completa se si desidera conservare i veicoli in WordPress anche dopo la loro rimozione da AutoScout24.

Monitoraggio dello stato del sistema

La scheda System & Help fornisce una panoramica completa dell'ambiente server e dello stato del plugin. Esaminarla regolarmente per identificare potenziali problemi prima che influiscano sulle importazioni.

Controlli chiave:

Controllo	Valore consigliato	Note
Versione PHP	8.1 o successiva	Richiesto
Limite di memoria	256 MB o superiore	Valori inferiori possono causare fallimenti dell'importazione
Tempo massimo di esecuzione	60 secondi o superiore	Consigliato per importazioni di grandi dimensioni
Directory dei caricamenti	Scrivibile	Richiesto per l'importazione delle immagini
GD o Imagick	Presente	Richiesto per la conversione WebP
cURL	Presente	Richiesto per le chiamate API
OpenSSL	Presente	Richiesto per le connessioni API HTTPS
Connessione API	OK	Conferma che le credenziali funzionino
Dimensione coda immagini	Inferiore a 1.000	Code di grandi dimensioni indicano un ritardo nell'elaborazione
Stato pianificazione cron	Attivo	Conferma che WP-Cron o il cron esterno siano in esecuzione

Gli indicatori di stato utilizzano un sistema a semaforo: verde (OK), giallo (avviso), rosso (problema).

Monitoraggio dei log

La scheda Logs mostra il registro delle attività del plugin.

Il log registra le chiamate API, le richieste di token, le azioni di importazione, i download di immagini, gli errori e gli avvisi.
I pannelli Errori recenti e Avvisi recenti nella parte superiore della scheda Logs evidenziano le ultime voci di errore e avviso tra le ultime 2.000 righe di log.
Il Visualizzatore log mostra le ultime N righe del file di log completo (configurabile, 100–2.000 righe).
Il file di log viene ruotato automaticamente quando raggiunge i 10 MB.
Per cancellare manualmente il file di log, fare clic sul pulsante Svuota file di log. Questa azione è irreversibile.
La Registrazione dettagliata (se abilitata nelle impostazioni) scrive nel log i dettagli per singolo veicolo e singola immagine. Disabilitare la registrazione dettagliata in produzione se il log cresce troppo rapidamente.

Esportazione della diagnostica

La scheda Tools include una funzione di Esportazione della diagnostica. Questa genera un file JSON contenente:

Versione del plugin
Versione di WordPress
Versione PHP
URL del sito
Dimensione e percorso del file di log
Riepilogo dell'ambiente di sistema

Quando si contatta il supporto, esportare questo file e condividerlo con il team di supporto. Non condividere pubblicamente il file di log non elaborato, poiché potrebbe contenere URL API e identificatori degli annunci.

Gestione delle funzionalità

La maggior parte delle funzionalità opzionali viene abilitata o disabilitata dalla schermata Settings (Impostazioni) anziché da una scheda dedicata "Funzionalità". Apri Car Market Hub → Settings e usa le schede Frontend Features e Admin Features per attivare o disattivare le singole funzionalità. Le modifiche hanno effetto immediato dopo il salvataggio. Le opzioni disponibili includono:

Dati strutturati Schema.org e meta tag Open Graph
Pulsanti di condivisione social
Preferiti / Lista dei desideri
Confronto veicoli
PDF datasheet
Integrazione con la sitemap
Widget della bacheca
Lazy loading
Azioni di massa
Esportazione
REST API
Monitoraggio analitico
Calcolatore di finanziamento (con tasso di interesse, durata del prestito e anticipo configurabili)
Prenotazione del test drive
AI Assistant

La disattivazione di una funzionalità ne rimuove la funzionalità sia dal frontend che dall'amministrazione senza eliminare i dati memorizzati. Consulta la Guida di riferimento alle impostazioni per l'elenco completo delle opzioni.

Gli URL dei webhook in uscita (nuovo lead, nuovo import) e il segreto del webhook sono configurati nella schermata Leads — vedi la Guida di riferimento ai lead. L'opzione per abilitare la funzionalità PDF datasheet si trova in Settings, mentre i relativi modelli e il branding sono gestiti in PDF Manager (vedi la Guida di riferimento a PDF Manager).

L'AI Assistant e il Content Studio non sono semplici opzioni di attivazione/disattivazione allo stesso modo. L'AI Assistant si configura nella propria schermata CMH Center → AI Assistant, mentre il Content Studio è un'area di lavoro separata in CMH Center → Content Studio. Queste aree operative potrebbero inoltre richiedere una licenza del plugin attiva prima di poter essere utilizzate; se il plugin non dispone della licenza per queste aree, la schermata viene sostituita da un avviso di "licenza richiesta" e i dati esistenti rimangono inalterati.

Gestione del CMH Team

CMH Team è un menu di primo livello separato per i contatti di vendita della concessionaria gestiti dal plugin. I membri del team sono memorizzati interamente all'interno del plugin (non è richiesto alcun account utente WordPress) e possono essere mostrati nelle pagine di dettaglio del veicolo e utilizzati come destinatari preferiti per i lead.

Il menu CMH Team offre le seguenti schermate:

Schermata	Scopo
Overview	Riepilogo della configurazione del team con collegamenti rapidi.
Members	Elenco di tutti i contatti di vendita; aggiungi, modifica o rimuovi membri.
New	Crea o modifica un singolo membro (nome, foto, email, telefono, ruolo).
Locations	Imposta un contatto predefinito per sede del concessionario / Seller ID.
Assignment	Assegna un contatto ai singoli veicoli (manuale, automatico, contatto generale della concessionaria o nessuno).
Standards	Contatto di fallback globale e dettagli di contatto generali della concessionaria.
Rules	Comportamento di assegnazione automatica, incluso se inviare una copia di ciascuna richiesta anche all'email generale della concessionaria.

Come viene risolto un contatto per un determinato veicolo: un contatto assegnato manualmente per singolo veicolo ha la precedenza, seguito dal contatto predefinito per sede/venditore, e infine dal contatto predefinito globale. Le scelte manuali (manuale, generale, nessuno) non vengono mai sovrascritte dall'importatore; le assegnazioni automatiche possono essere aggiornate durante l'importazione. Consulta CMH Team e instradamento dei contatti per la guida di riferimento completa, e Flusso di lavoro per la gestione dei lead per informazioni su come CMH Team influisce sull'instradamento delle notifiche dei lead.

Gestione dei lead

I contatti dei clienti e le richieste di test drive sono memorizzati come custom post di WordPress (as24ci_lead) e visualizzati nella scheda Leads.

Responsabilità dell'amministratore:

Configurare l'indirizzo email del destinatario per le notifiche dei lead (scheda Leads).
Esaminare periodicamente gli stati dei lead e aggiornarli a Contattato, Chiuso o Spam a seconda dei casi.
Esportare i lead in formato CSV per l'importazione nel CRM o per l'archiviazione.
Eliminare i lead obsoleti o di spam dalla scheda Leads.

Nota: i record dei post dei lead sono memorizzati in WordPress. Se l'opzione Delete data on uninstall (Elimina i dati all'arresto) è abilitata nelle impostazioni, questi record verranno rimossi in modo permanente quando il plugin viene disinstallato.

Disinstallazione e pulizia

La scheda Settings include l'opzione Delete data on uninstall. Quando questa opzione è abilitata:

La disinstallazione del plugin tramite Amministrazione WordPress → Plugin eliminerà in modo permanente tutti i post dei veicoli importati, i post dei lead, le immagini importate e le opzioni del plugin.

Quando questa opzione è disabilitata (impostazione predefinita), la disinstallazione del plugin lascia tutti i dati in WordPress. È quindi possibile reinstallare il plugin e riprendere il funzionamento senza perdita di dati.

Abilita questa opzione solo se intendi effettuare una rimozione completa. L'azione non può essere annullata una volta completata la disinstallazione.

Coordinamento del supporto

Quando un problema richiede l'escalation a AutoScout24 o al tuo partner di integrazione:

Controlla la scheda Logs per verificare la presenza di messaggi di errore pertinenti e annota la marca temporale.
Esporta il file di Diagnostica dalla scheda Tools (Strumenti).
Annota la versione del plugin (visualizzata nell'elenco dei plugin e nella scheda System & Help) e le versioni di WordPress e PHP.
Conferma se il test di connessione API ha esito positivo (System & Help → test di connessione).
Fornisci tutte le informazioni sopra indicate al tuo contatto di supporto. Non condividere il Client Secret in chiaro.

Risoluzione dei problemi

Sintomo	Causa probabile	Verifica
La scheda Settings mostra "invalid API Base URL"	URL inserito senza uno schema o formato valido	Inserisci un URL completo che includa `https://`
Il test di connessione fallisce	Credenziali errate, Base URL errato o blocco di rete	Verifica le credenziali con il tuo partner di integrazione; controlla le regole del firewall
L'importazione pianificata non viene eseguita	WP-Cron è disabilitato o il sito non ha traffico	Passa al cron del server; verifica che l'endpoint cron sia raggiungibile
Funzionalità manageas24imports non assegnata	L'attivazione del plugin non ha completato l'aggiornamento delle funzionalità	Disattiva e riattiva il plugin; oppure assegna la funzionalità manualmente
La sincronizzazione completa (Full Sync) ha eliminato veicoli in modo imprevisto	La sincronizzazione completa era abilitata e i veicoli sono stati rimossi da AutoScout24	Esamina i log per verificare le voci di eliminazione; disabilita la sincronizzazione completa se non necessaria
L'importazione viene eseguita ma non appare alcun veicolo	Lo stato predefinito del post è `draft`	Cambia lo stato predefinito del post in `publish` nelle impostazioni
La conversione in WebP fallisce	GD o Imagick non sono disponibili	Controlla lo stato delle estensioni in System & Help; contatta il provider di hosting
L'esportazione della diagnostica fallisce	Permessi PHP insufficienti per leggere i dati dell'ambiente	Esamina il log degli errori PHP sul server