Documentazione · Risoluzione dei problemi

Panoramica sulla risoluzione dei problemi

Questo documento fornisce un punto di partenza strutturato per diagnosticare e risolvere i problemi con il plugin ADP Car Market Hub WordPress. Descrive l'ordine diagnostico raccomandato, dove trovare i log e le informazioni sullo stato, e le pratiche sicure quando si contatta il supporto.

Quando usare questo documento

Leggi questo documento per primo ogni volta che il plugin non si comporta come previsto. Ti guiderà verso la pagina specialistica corretta e ti aiuterà a raccogliere le informazioni necessarie prima di contattare il supporto.

Panoramica

Il plugin ADP Car Market Hub si connette all'API di AutoScout24, importa gli annunci di veicoli in WordPress, gestisce l'automazione pianificata e mostra gli annunci sul frontend. Possono verificarsi problemi in ognuno di questi livelli. Partire da un ordine diagnostico sistematico evita di perdere tempo sul livello sbagliato.

Ordine diagnostico consigliato

Analizza ogni livello in sequenza. Fermati e consulta il documento specialistico pertinente non appena identifichi l'area del problema.

Controlla il log del plugin – Il plugin scrive tutti gli eventi significativi, gli errori e i risultati dell'importazione in un file di log dedicato. Questo è sempre il primo posto in cui guardare.
Controlla la connessione API – Se il log mostra errori di autenticazione o HTTP, o se la pagina dello Stato del sistema segnala un problema di connessione, consulta Errori di connessione API.
Controlla i risultati dell'importazione – Se i veicoli mancano, sono importati parzialmente o mostrano dati non aggiornati, consulta Errori di importazione.
Controlla l'automazione pianificata – Se le importazioni automatiche non sono in esecuzione o l'orario dell'ultima esecuzione non avanza, consulta Errori di Cron.
Controlla l'importazione delle immagini – Se le immagini dei veicoli mancano o non sono state scaricate completamente, consulta Errori di importazione immagini.
Controlla la visualizzazione frontend – Se gli annunci appaiono nel backend ma non correttamente nel frontend, consulta Problemi di visualizzazione frontend.
Controlla i permessi – Se le schermate di amministrazione o le azioni di importazione restituiscono errori di accesso negato, consulta Errori di autorizzazione.

Dove trovare i log e le informazioni sullo stato

File di log del plugin

Il plugin scrive in un file di log nella directory uploads di WordPress:

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

La directory dei log è protetta dall'accesso web diretto tramite un file .htaccess e una barriera index.php. Accedi al file tramite SFTP, il file manager dell'hosting o uno strumento di visualizzazione dei log con accesso al server.

Il file di log ruota automaticamente quando supera i 10 MB. Gli archivi ruotati sono denominati adp-car-market-hub-YYYYMMDD-HHMMSS.log e vengono eliminati automaticamente dopo 7 giorni.

La registrazione dettagliata (voci per singolo veicolo e singola immagine) è abilitata per impostazione predefinita. È possibile disabilitarla nelle impostazioni del plugin per ridurre il volume dei log sui cataloghi di grandi dimensioni.

Pagina Stato del sistema

L'amministrazione del plugin include una scheda "Sistema & Aiuto" che mostra:

Stato della connessione API (testato l'ultima volta rispetto al Seller ID configurato)
Orario dell'ultima esecuzione dell'importazione e conteggio dei risultati (inseriti, aggiornati, saltati, errori)
Stato di WP-Cron o del cron del server e orario dell'ultima esecuzione
Stato della coda delle immagini (elementi in attesa, ultima esecuzione del worker)

Esamina questa pagina prima di controllare i log non elaborati.

Amministrazione di WordPress

Anche gli strumenti standard di WordPress forniscono informazioni utili:

Strumenti → Eventi pianificati (o un plugin per la visualizzazione di WP-Cron): verifica che gli eventi as24ci_scheduled_import e as24ci_image_queue_process siano presenti e abbiano un orario di esecuzione successiva realistico.
Libreria media: conferma che le immagini dei veicoli vengano allegate ai post corretti.
Articoli → Auto: controlla il numero di post di veicoli pubblicati e le eventuali bozze o voci in sospeso.

Prerequisiti per una risoluzione dei problemi efficace

Prima di indagare, conferma quanto segue:

Disponi dell'accesso come amministratore alla bacheca di WordPress.
Disponi dell'accesso al server (SFTP, SSH o file manager dell'hosting) per leggere il file di log.
Conosci la versione del plugin attualmente installata (visibile in Plugin → Plugin installati).
Conosci la versione di PHP e la versione di WordPress del sito (visibili in Strumenti → Stato del sito).

Pratiche sicure quando si contatta il supporto

Non condividere le credenziali API (Client ID, Client Secret o token di accesso) nei ticket di supporto o nei forum pubblici. Il log del plugin maschera automaticamente questi valori.
Fornisci la sezione pertinente del file di log (non l'intero file a meno che non venga richiesto).
Includi l'output della pagina Stato del sistema o uno screenshot.
Descrivi i passaggi esatti che hai compiuto prima che si presentasse il problema, incluse eventuali modifiche recenti alle impostazioni o aggiornamenti del plugin.
Se sospetti un problema relativo a WordPress o all'ambiente di hosting, includi l'output di Strumenti → Stato del sito → Informazioni.

Note operative

La maggior parte dei problemi è causata da credenziali errate, un endpoint API non raggiungibile o una pianificazione cron disabilitata o configurata in modo errato.
Il plugin utilizza blocchi transienti di WordPress per impedire l'esecuzione di importazioni sovrapposte. Se un'importazione è stata interrotta in modo anomalo, il blocco potrebbe persistere fino a 40 minuti prima di essere rimosso automaticamente.
Il plugin memorizza l'ultimo risultato dell'importazione (conteggi e timestamp) nelle opzioni di WordPress. Questi sono visibili nella bacheca di amministrazione e vengono anche scritti nel log.