Documentazione · Risoluzione dei problemi
FAQ sulla risoluzione dei problemi
Questo documento risponde alle domande più frequenti sulla risoluzione dei problemi per il plugin ADP Car Market Hub. Per guide dettagliate passo-passo, segui i link ai relativi documenti di risoluzione dei problemi.
Generale
Il menu del plugin è assente dall'amministrazione di WordPress dopo l'attivazione.
L'amministrazione del plugin è accessibile solo agli utenti WordPress con la funzionalità manage_as24_imports, che viene assegnata al ruolo administrator durante l'attivazione. Accedi come amministratore WordPress. Se il menu è ancora assente, disattiva e riattiva il plugin per eseguire nuovamente l'assegnazione delle funzionalità. Vedi Errori di autorizzazione.
Riesco a vedere l'amministrazione del plugin ma tutti i pulsanti restituiscono "Accesso negato".
Tutte le azioni AJAX e gli invii di moduli del plugin verificano la funzionalità manage_as24_imports. Se al tuo account utente è stato concesso lo stato di amministratore dopo l'attivazione del plugin, la funzionalità potrebbe non essere stata assegnata. Disattiva e riattiva il plugin, oppure chiedi a un super amministratore di verificare il tuo ruolo. Vedi Errori di autorizzazione.
Come posso verificare cosa sta facendo il plugin?
Apri la scheda Logs nell'amministrazione del plugin. Il registro registra tutte le esecuzioni di importazione, gli errori, i download di immagini e gli eventi di sistema. Per un'esportazione diagnostica scaricabile (JSON o ZIP), utilizza la scheda System & Help. Vedi Errori di Cron e Errori di importazione.
Licenza
Una funzionalità mostra "non attiva per questa licenza" o un'intera scheda è sostituita da una schermata di blocco.
Diverse funzionalità (tra cui Market Insights, AI Assistant e Content Studio) sono regolate dalla licenza del plugin ADP Car Market Hub. Quando la licenza non include una funzionalità, quest'ultima mostra un avviso amichevole "non inclusa in questa licenza" e le sue azioni non vengono eseguite. Quando la licenza stessa non è operativa (ad esempio scaduta o non verificata), le azioni operative come le importazioni vengono messe in pausa e le aree amministrative interessate mostrano una schermata di blocco della licenza. In nessun caso le pagine e i dati dei veicoli esistenti vengono eliminati. Contatta il supporto di ADP Car Market Hub per abilitare una funzionalità o per ripristinare una licenza scaduta o sospesa. Vedi Problemi di Market Insights.
Le importazioni hanno smesso di funzionare e il registro menziona la licenza.
Quando la licenza è scaduta, sospesa o non può essere verificata oltre il periodo di tolleranza, le azioni operative come le importazioni e l'analisi giornaliera dei prezzi vengono messe in pausa (si bloccano per sicurezza). Di conseguenza, nessun articolo, meta dato o elemento multimediale viene eliminato. Ripristina o rinnova la licenza per riprendere il normale funzionamento.
Configurazione guidata
L'avviso di configurazione "Benvenuto in ADP Car Market Hub" non viene visualizzato.
L'avviso viene mostrato solo quando è stato registrato un timestamp di prima attivazione e la procedura guidata non è stata completata o saltata, e l'utente corrente deve disporre della funzionalità di gestione del plugin. Gli aggiornamenti del plugin che non attivano una nuova attivazione non mostrano l'avviso sulle installazioni esistenti. Puoi sempre aprire la procedura guidata manualmente da Car Market Hub → Tools → Setup Wizard o dal link Esegui configurazione guidata sulla Dashboard. Vedi Riferimento alla configurazione guidata.
Ho saltato la procedura guidata. Come posso riaprirla?
Apri Car Market Hub → Tools e fai clic sulla scheda Configurazione guidata, oppure utilizza il link Esegui configurazione guidata nella parte superiore di Car Market Hub → Dashboard. La procedura guidata rimane raggiungibile su wp-admin/admin.php?page=as24ci-setup-wizard anche dopo essere stata saltata o completata.
La procedura guidata non ha creato le mie pagine.
In alternativa, è stata selezionata l'opzione Salta per quella pagina al passaggio 4, è stata riutilizzata una pagina esistente con lo stesso titolo (la procedura guidata elimina i duplicati in base al titolo per evitare di crearne di nuovi), oppure l'opzione corrispondente (as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id) puntava già a una pagina pubblicata. Apri l'elenco WordPress Pages per confermare. La procedura guidata non elimina mai le pagine esistenti.
Il campo Client Secret è vuoto quando riapro il passaggio 3.
Questo comportamento è intenzionale. Il Client Secret memorizzato non viene mai visualizzato nuovamente nell'HTML dell'amministrazione, né nella procedura guidata né nella scheda Impostazioni. L'invio del modulo lasciando il campo vuoto conserva il segreto memorizzato esistente. L'invio di un valore non vuoto lo sostituisce.
Analytics non è abilitato dopo una configurazione Live.
In modalità Live, l'interruttore di analytics è deselezionato per impostazione predefinita e deve essere abilitato esplicitamente. Riapri la procedura guidata e seleziona l'interruttore di analytics al passaggio 5, oppure abilita analytics nella scheda Analytics. Verifica prima i requisiti di consenso sui cookie e sulla privacy. Vedi Conservazione di Analytics.
I dati demo non sono stati installati.
I dati demo vengono installati solo quando si seleziona Configurazione demo al passaggio 1 e la procedura guidata viene completata con Installa dati demo e termina al passaggio 6. La configurazione Live non installa i dati demo. I dati demo possono anche essere installati in qualsiasi momento dalla scheda Dati demo su Car Market Hub → Tools.
Le pagine Confronta o Preferiti sono vuote dopo un'installazione demo.
Confronta e Preferiti sono funzionalità basate sullo stato del client che leggono dal localStorage del browser del visitatore. L'installatore demo fornisce un fallback che popola il localStorage al primo caricamento della pagina. Apri la pagina Veicoli, Confronta o Preferiti una volta nella stessa sessione del browser per attivare il popolamento.
La procedura guidata sovrascriverà le mie impostazioni esistenti se la eseguo di nuovo?
No. La procedura guidata scrive solo le opzioni i cui campi del modulo vengono effettivamente inviati dall'amministratore. Eseguirla nuovamente parzialmente non cancella mai un'impostazione che non era presente nel modulo inviato. Il Client Secret viene conservato quando il campo viene lasciato vuoto. Anche l'attivazione e la riattivazione del plugin non sono distruttive.
API e connessione
Il test di connessione fallisce con "Credenziali API mancanti".
L'URL di base dell'API, il Client ID o il Client Secret sono vuoti o errati. Apri la scheda Impostazioni del plugin, conferma che tutti e tre i campi siano compilati e salva. Vedi Errori di connessione API.
Il token di accesso continua a scadere e le importazioni falliscono.
Il plugin memorizza nella cache il token di accesso nel transient as24ci_access_token. Se l'endpoint del token restituisce un valore expires_in molto breve, il token potrebbe scadere prima del completamento dell'importazione. Elimina il transient tramite WP-CLI (wp transient delete as24ci_access_token) e riprova. Se il problema persiste, contatta il tuo fornitore di API per confermare il periodo di validità del token. Vedi Errori di connessione API.
L'importazione restituisce zero veicoli anche se il mio account AutoScout24 contiene annunci.
Le cause più comuni sono: il Seller ID è errato, gli annunci non sono attivi o online su AutoScout24, oppure le credenziali API non hanno accesso al Seller ID configurato. Verifica tutte e quattro le impostazioni (URL di base, Client ID, Client Secret, Seller ID) e controlla il registro del plugin per messaggi di errore specifici. Vedi Errori di connessione API e Errori di importazione.
Importazione
I veicoli vengono importati come bozze invece di essere pubblicati automaticamente.
Lo stato predefinito dell'articolo è configurabile. Apri la scheda Importatore o Impostazioni del plugin e controlla l'impostazione Stato predefinito dell'articolo. Modificalo da draft a publish se desideri che i veicoli appaiano sul sito immediatamente dopo l'importazione. Nota che l'importazione come draft è l'impostazione predefinita prudente sulle nuove installazioni. Vedi Errori di importazione.
Alcuni campi del veicolo sono vuoti dopo l'importazione.
L'importazione mappa i campi di risposta dell'API ai meta dati dell'articolo WordPress utilizzando la configurazione di mappatura dei campi del plugin. Se un campo è vuoto, l'annuncio AutoScout24 non contiene un valore per quel campo oppure la mappatura dei campi è stata modificata. Controlla la scheda Mappatura dei campi nell'amministrazione del plugin e verifica che i campi pertinenti siano mappati correttamente. Vedi Errori di importazione.
L'importazione automatica non viene eseguita.
Le importazioni automatiche richiedono che l'opzione Importazione automatica sia abilitata e che WP-Cron funzioni correttamente. Apri la scheda Importazione e limiti → Automazione per confermare che l'importazione automatica sia attiva e che sia configurata una pianificazione. Quindi controlla la scheda System & Help per confermare che l'evento as24ci_scheduled_import sia pianificato. Se DISABLE_WP_CRON è impostato su true in wp-config.php, WP-Cron non si avvierà e sarà necessario configurare un trigger cron esterno. Vedi Errori di Cron.
Immagini
I veicoli vengono importati ma non hanno immagini.
L'importazione delle immagini è controllata dall'interruttore Importa immagini nelle impostazioni dell'Importatore. Conferma che sia abilitato. Se è abilitato ma le immagini continuano a mancare, apri il registro del plugin e cerca Image download failed o media_handle_sideload failed per identificare l'errore specifico. Le cause comuni includono spazio su disco insufficiente, permessi di scrittura mancanti su wp-content/uploads e limiti di memoria PHP. Vedi Errori di importazione delle immagini.
Alcune immagini mancano e altre sono state importate con successo.
Il plugin elabora le immagini tramite una coda in background (il worker della coda di immagini). Le immagini che non è stato possibile scaricare durante l'esecuzione dell'importazione principale vengono riprovate in modo asincrono. Controlla la scheda System & Help per verificare la dimensione della coda delle immagini e l'ora dell'ultima esecuzione. Puoi anche avviare la coda manualmente utilizzando il pulsante Esegui coda immagini. Vedi Errori di importazione delle immagini.
Le immagini WebP convertite non vengono generate.
La conversione WebP richiede l'estensione GD con supporto imagewebp o l'estensione Imagick. Conferma che una di queste sia disponibile sul tuo server (controlla Strumenti → Stato del sito → Informazioni → Server in WordPress). La conversione WebP è disabilitata per impostazione predefinita. Abilitala nelle impostazioni dell'Importatore se il tuo server la supporta. Vedi Errori di importazione delle immagini.
Visualizzazione frontend
La pagina dell'archivio dei veicoli mostra un errore 404.
La causa più comune è che le regole di riscrittura dei permalink di WordPress devono essere rigenerate. Vai su Impostazioni → Permalink e fai clic su Salva le modifiche senza apportare alcuna modifica. Questo rigenera le regole di riscrittura. Vedi Problemi di visualizzazione frontend.
La pagina dell'elenco dei veicoli non mostra alcun veicolo anche se i veicoli sono stati importati.
I veicoli devono avere lo stato publish per apparire nell'archivio. Controlla se i veicoli sono in stato di bozza e pubblicali. Conferma inoltre che nessun filtro attivo o query di ricerca stia nascondendo i risultati e che nessun plugin di cache stia servendo una pagina obsoleta. Vedi Problemi di visualizzazione frontend.
Le pagine dell'archivio o dei dettagli del veicolo appaiono danneggiate o prive di stile.
Il plugin carica i suoi CSS e JavaScript solo sulle pagine in cui è presente uno shortcode del veicolo in post_content, o sui template standard di archivio e singoli del CPT. Se il tuo tema utilizza un page builder o un template personalizzato che non esegue direttamente il rendering di post_content, le risorse potrebbero non essere caricate. Aggiungi lo shortcode [as24ci_archive] direttamente nel campo del contenuto della pagina. Vedi Problemi di visualizzazione frontend e Problemi con gli shortcode.
Shortcode
Uno shortcode viene visualizzato come testo normale sulla pagina.
L'elaborazione degli shortcode è disabilitata in alcuni contesti (ad esempio, page builder, aree widget o file di template personalizzati che non chiamano do_shortcode). Verifica che lo shortcode sia inserito nel campo standard Contenuto di WordPress di una pagina o di un articolo, e non in un widget, in un campo personalizzato o in un template PHP. Vedi Problemi con gli shortcode.
Lo shortcode [as24ci_archive] non produce alcun output.
Se lo shortcode si trova nella posizione corretta ma non produce alcun output, la causa più probabile è che non esistano veicoli pubblicati. Verifica che i veicoli siano importati e pubblicati. Conferma inoltre che i valori degli attributi dello shortcode siano validi — ad esempio, per_page deve essere un intero positivo. Vedi Problemi con gli shortcode.
Email e Lead
Non arriva alcuna email quando un visitatore invia un modulo di richiesta.
Il plugin invia le email di notifica utilizzando wp_mail(). Se non arriva alcuna email, verifica se il tuo sito WordPress è configurato correttamente per l'invio delle email. Molti ambienti di hosting richiedono un plugin SMTP per inviare la posta in modo affidabile. Verifica anche che l'indirizzo del destinatario configurato nelle impostazioni del plugin sia corretto e non venga filtrato da una cartella spam. Vedi Errori di email e lead.
Il lead viene salvato nella sezione di amministrazione Leads ma non viene inviata alcuna notifica via email.
I dati dei lead vengono salvati nel custom post type as24ci_lead indipendentemente dall'invio dell'email. L'invio dell'email è un processo separato. Controlla la configurazione dell'indirizzo del destinatario (impostazione di sovrascrittura globale → email del profilo del venditore → email dell'autore del post → email di fallback dell'amministratore di WordPress) e fai un test con un semplice plugin per l'invio SMTP. Vedi Errori di email e lead.
Il modulo di contatto restituisce un errore di validazione ma tutti i campi sembrano essere compilati.
Il modulo convalida lato server il nome, l'indirizzo email, il messaggio e la casella di controllo del consenso. Anche un campo antispam honeypot deve essere vuoto. Se l'errore persiste, la compilazione automatica del browser potrebbe aver compilato il campo honeypot, oppure un conflitto JavaScript potrebbe interferire con il modulo. Prova a inviare il modulo in una finestra di navigazione in incognito senza estensioni attive. Vedi Errori di email e lead.
Market Insights
Tutti i veicoli mostrano no_data nella colonna Market Score.
Lo stato no_data viene restituito quando un veicolo non ha un prezzo memorizzato (_as24ci_price è vuoto o pari a zero). Verifica che i veicoli siano stati importati con un prezzo. In caso affermativo, esegui nuovamente l'importazione o avvia manualmente l'analisi dei prezzi disattivando e riattivando il plugin. Vedi Problemi di Market Insights.
I giorni nel parco veicoli (Days on Lot) mostrano 0 o un numero insolitamente alto.
Un valore pari a 0 può significare che il veicolo è stato pubblicato oggi o ha una pubblicazione programmata con data futura. Valori molto grandi indicano una data del post corrotta (ad esempio, importata da un record con data zero). Controlla la data di pubblicazione del veicolo nella tabella dell'elenco dei post. Vedi Problemi di Market Insights.
PDF Datasheet
L'URL della scheda tecnica (?as24ci_pdf=123) restituisce un errore 404.
La funzionalità PDF Datasheet non è abilitata, l'ID del post è errato o il veicolo non è nello stato publish. Abilita la funzionalità nelle impostazioni del plugin, aggiorna i permalink e conferma che il veicolo sia pubblicato. Vedi Problemi relativi al PDF Datasheet.
La scheda tecnica non mostra immagini.
Conferma che le immagini siano state importate per il veicolo e che l'opzione Mostra Galleria sia abilitata nelle impostazioni del PDF Manager. La scheda tecnica mostra un massimo di 5 immagini. Vedi Problemi relativi al PDF Datasheet.