Documentazione · Riferimento amministratore

Riferimento a sistema e supporto

Questo documento è un riferimento per la schermata System & Help del plugin ADP Car Market Hub (Car Market Hub → System & Help). Spiega i pannelli relativi a connettività, attività in background, server, file di log e coda delle immagini mostrati da questa vista sullo stato di salute del sistema.

Quando utilizzare questo documento

Leggi questo documento se hai bisogno di:

Confermare che l'API di AutoScout24, l'endpoint REST del plugin e l'API di Market Hub siano raggiungibili.
Verificare se le attività pianificate (cron job) sono integre e quando verranno eseguite la volta successiva.
Avviare un'importazione, un'esecuzione della coda immagini o uno svuotamento della coda da un unico punto.
Verificare che il server soddisfi i requisiti del plugin (versione PHP, memoria, tempo di esecuzione).
Ispezionare la dimensione del file di log, lo stato di rotazione e lo stato di salute della coda di importazione delle immagini.

Panoramica

La schermata è una dashboard di stato in sola lettura. Una barra delle azioni superiore sopra le schede include un pulsante Download Diagnostics — etichettato Download Diagnostics ZIP, o Download Diagnostics JSON quando il supporto ZIP non è disponibile sul server — che scarica un pacchetto diagnostico da allegare a una richiesta di supporto.

La schermata è suddivisa nelle seguenti schede:

Connectivity & API — Stato dell'API di AutoScout24, stato del token OAuth2, controllo dell'endpoint REST del plugin e stato dell'API di Market Hub.
Private Update Diagnostics — Diagnostica degli aggiornamenti e delle versioni con un report JSON copiabile.
Background Tasks — Elenco degli eventi cron pianificati con la loro pianificazione e l'orario di esecuzione successivo, oltre a pulsanti di azione.
Plugin Requirements — Versioni minime e flag delle funzionalità.
Server & Storage — Configurazione PHP, ambiente server e stato di salute della directory dei caricamenti.
Log File Status — Dimensione attuale del file di log, stato di rotazione e percorso.
Image Queue Status — Immagini in attesa, statistiche dell'ultima esecuzione del worker.

Ogni riga utilizza badge a semaforo (ok, warn, bad) con tooltip che spiegano la soglia o il passaggio di risoluzione.

Requisiti o prerequisiti

Un utente con la capacità di gestione del plugin.
Per i controlli di connettività: accesso HTTPS in uscita dal server web verso gli endpoint API configurati.
Per il controllo delle API REST: permalink personalizzati di WordPress abilitati.
Per la sezione cron: il cron integrato di WordPress deve essere attivo, oppure un pianificatore lato server deve chiamare wp-cron.php.

Istruzioni passo dopo passo

Verificare la connettività

Apri Car Market Hub → System & Help.
In Connectivity & API, controlla: - AS24 API Endpoint Status e AS24 API Reachability per l'URL di base di AutoScout24. - Token Status (Valido / Scade presto / Scaduto / Nessun token). - REST API Status per l'endpoint as24ci/v1/cron-import del plugin. - Market Hub Reachability per l'API di Market Hub.
Passa il mouse su qualsiasi badge per visualizzare il tooltip con i dettagli sottostanti (stato HTTP, latenza o messaggio di errore).

Esaminare la diagnostica degli aggiornamenti

Apri la scheda Private Update Diagnostics nella colonna di destra.
Leggi le righe per confermare che il canale di aggiornamento del plugin sia integro: la versione installata, se gli hook di aggiornamento sono registrati, la nuova versione remota offerta, la coerenza del transient (dati di aggiornamento memorizzati nella cache), lo stato della licenza e il dominio normalizzato.
Se contatti il supporto per un problema di aggiornamento o di licenza, usa il report JSON copiabile in fondo alla scheda e incollalo nel tuo ticket.

Questa scheda è un modo rapido per confermare che il plugin può vedere e applicare gli aggiornamenti privati senza esporre credenziali sensibili.

Controllare le attività pianificate

Scorri fino a Background Tasks.
L'intestazione della scheda mostra un badge che indica se la pianificazione viene eseguita tramite WP-Cron o un Server Cron, insieme a una nota di heartbeat come Last import ran X ago o No recent import run detected.
Esamina la tabella: ogni riga mostra l'attività cron, la sua pianificazione, il timestamp dell'esecuzione successiva e un badge di stato. Le attività possono includere processi di importazione, coda immagini, analytics e Pricing Analysis.
Oltre al normale stato di esecuzione successiva, un'attività può segnalare Lock stuck, Handled by server cron o Not scheduled.
Se il cron integrato di WordPress è disabilitato (DISABLE_WP_CRON), viene visualizzato un avviso; in tal caso, configura un pianificatore lato server che chiami wp-cron.php.
Usa i pulsanti in linea per Run Import Now, Run Image Queue Now o Clear Image Queue quando necessario.

Verificare la compatibilità del server

Leggi Plugin Requirements per le versioni minime e i flag delle funzionalità, inclusa la disponibilità di ZipArchive e lo stato di ionCube Loader (con la sua Loader Version).
Leggi Server & Storage per la configurazione PHP: - memory_limit, WP Memory Limit, max_execution_time, upload_max_filesize, post_max_size, max_input_vars. - PHP SAPI e Server OS. - Stato della directory dei caricamenti e spazio libero su disco.

Ispezionare il file di log e la coda delle immagini

Log File Status mostra se il file di log esiste, la sua dimensione attuale, lo spazio rimanente prima della rotazione, l'orario dell'ultima rotazione e il percorso del file.
Image Queue Status mostra le importazioni di immagini in attesa e le statistiche dell'ultima esecuzione del worker (conteggio elaborati, errori, elementi rimanenti).

Riferimento di configurazione

La schermata System & Help non memorizza impostazioni proprie. Legge dalla configurazione attuale di WordPress, dalle opzioni del plugin e dallo stato di runtime.

Badge di Connectivity & API

Riga	Stati possibili
AS24 API Endpoint Status	`ok` (configurato e raggiungibile), `bad` (nessun URL di base o non raggiungibile).
AS24 API Reachability	Risultato in stile latenza con `ok` / `warn` / `bad`; etichette come Connection active, Host reachable, API endpoint not verified, o Server error (HTTP n). Memorizzato in cache per 60 secondi.
Token Status	`Valid`, `Valid — expires <time>`, `Expires soon` (meno di 5 minuti), `Expired`, `No token`.
REST API Status	Endpoint raggiungibile, ad es. Active, token protection works (l'endpoint rifiuta un token di controllo integrità non valido con HTTP 403); REST endpoint not found (HTTP 404); o non raggiungibile.
Market Hub Reachability	Modello simile al controllo dell'API di AS24.

La formulazione esatta delle etichette può differire leggermente tra le versioni del plugin; fai affidamento sul colore del badge e sui dettagli del tooltip piuttosto che sul testo preciso.

La riga REST API viene controllata completamente solo quando è stato generato un token cron in Riferimento a importazione e limiti. Altrimenti mostra Not checked — no cron token configured.

Private Update Diagnostics

Questa scheda evidenzia lo stato di salute degli aggiornamenti e delle licenze del plugin. Le sue righe includono tipicamente la versione installata, se gli hook di aggiornamento sono registrati, la nuova versione remota offerta, la coerenza del transient (dati di aggiornamento memorizzati nella cache), lo stato della licenza e il dominio normalizzato. Un report JSON copiabile in fondo raggruppa questi valori per il supporto.

Soglie del server

Impostazione	`ok`	`warn`	`bad`
`memory_limit`	≥ 256 MB o illimitato	128–255 MB	< 128 MB
`max_execution_time`	> 60 s o illimitato	30–60 s	< 30 s

Gli altri valori PHP (upload_max_filesize, post_max_size, max_input_vars, scrivibilità della directory dei caricamenti, spazio libero su disco) sono presentati con i loro valori attuali e un badge contestuale.

Azioni per le attività in background

Pulsante	Effetto
Run Import Now	Attiva l'importazione regolare una volta, immediatamente.
Run Image Queue Now	Elabora il lotto successivo dalla coda delle immagini.
Clear Image Queue	Svuota la coda delle immagini in attesa. Azione distruttiva.

Note operative

I controlli di connettività utilizzano un timeout breve e un user agent personalizzato e memorizzano il loro risultato in cache per circa un minuto per evitare di sovraccaricare i servizi a monte. Non utilizzano tutti lo stesso metodo HTTP: il controllo di AutoScout24 invia una richiesta HEAD, mentre l'autoverifica REST del plugin e la sonda di integrità di Market Hub utilizzano GET (la sonda di Market Hub punta a un endpoint /v1/health).
Il pulsante Download Diagnostics nella barra delle azioni superiore produce un pacchetto diagnostico (uno ZIP dove supportato, altrimenti un file JSON) da allegare a una richiesta di supporto.
Il tooltip di scadenza del token utilizza il fuso orario del sito WordPress per la visualizzazione, ma il valore memorizzato nella cache è salvato come timestamp UNIX.
Il controllo delle API REST utilizza intenzionalmente un token non valido — un'installazione integra risponde con HTTP 403. HTTP 404 indica che l'endpoint non è raggiungibile (in genere un problema di permalink o di riscrittura).
Se DISABLE_WP_CRON è attivo, le attività pianificate non verranno eseguite a meno che l'host non sia configurato per chiamare wp-cron.php autonomamente. Senza di esso, le importazioni e l'elaborazione delle immagini appariranno bloccate.
Il badge di avviso della coda immagini appare quando la dimensione della coda supera la soglia interna del plugin (attualmente 1.000 elementi in attesa).
Lo spazio libero su disco viene segnalato come stima approssimativa. Alcuni host nascondono questo dato; in tal caso il badge mostra Unable to determine.

Risoluzione dei problemi

AS24 API Reachability è bad. L'URL di base in Settings è mancante, non valido o il servizio a monte è offline. Controlla il tooltip per l'errore sottostante.
Token Status è No token. Salva un Client ID e un Secret validi in Settings, quindi esegui Test Connection su Tools.
REST API Status segnala che l'endpoint non è stato trovato (HTTP 404). I permalink personalizzati sono disattivati o un altro plugin sta sovrascrivendo il routing REST. Salva nuovamente i permalink sotto Settings → Permalinks.
La riga REST API indica "Not checked — no cron token configured." Apri Riferimento a importazione e limiti e genera un token cron.
Le attività in background hanno un "Next Run" non aggiornato. Il cron di WordPress è disabilitato o non c'è traffico sul sito. Usa il pulsante Run Import Now per confermare che l'attività stessa venga eseguita, quindi pianifica un trigger lato server.
memory_limit contrassegnato come bad. Aumenta memory_limit in php.ini o wp-config.php (define('WP_MEMORY_LIMIT', '256M');) — richiesto per importazioni di grandi dimensioni.
La coda delle immagini continua a crescere. Fai clic su Run Image Queue Now per elaborare un lotto. Se il conteggio continua a salire, riduci il numero di immagini importate per veicolo in Settings o aumenta la frequenza di esecuzione del worker in Riferimento a importazione e limiti.
File di log contrassegnato come bad o No log file yet. Conferma che la directory dei log sia scrivibile. Verifica nella versione corrente del plugin prima di pubblicare.