Documentazione · Appendici

Lista di controllo per le informazioni di supporto

Questa lista di controllo elenca le informazioni da raccogliere prima di aprire una richiesta di supporto per il plugin ADP Car Market Hub.

Quando utilizzare questo documento

Utilizza questa lista di controllo quando segnali un problema al tuo contatto di supporto. Fornire in anticipo gli elementi indicati di seguito riduce i tempi di attesa e aiuta a riprodurre il problema in un ambiente comparabile.

Non includere dati che non vorresti venissero memorizzati al di fuori dei tuoi sistemi. In particolare, non incollare i client secret delle API, il token cron o i segreti condivisi dei webhook in un ticket di supporto. Oscurali con un segnaposto come ***REDACTED***.

Panoramica

Una tipica richiesta di supporto richiede tre tipi di informazioni:

Cosa hai osservato — i sintomi, i passaggi che li hanno causati e gli screenshot dove utili.
Cosa ti aspettavi — il comportamento che desideravi ottenere e da dove deriva tale aspettativa (pagina della documentazione, etichetta dell'interfaccia di amministrazione, ecc.).
Contesto dell'ambiente — le versioni, l'hosting e la configurazione rilevanti per il sintomo.

Dettagli del plugin e dell'ambiente

Raccogli le seguenti informazioni dall'amministrazione di WordPress:

[ ] Nome e versione del plugin (schermata Plugin, o Car Market Hub → System & Help).
[ ] Versione di WordPress (Bacheca → Aggiornamenti, o Strumenti → Stato del sito → Informazioni).
[ ] Versione PHP, versione MySQL/MariaDB, server web (sempre sotto Strumenti → Stato del sito → Informazioni).
[ ] Nome e versione del tema attivo e del tema child.
[ ] Elenco dei plugin attivi (rilevanti: SEO, caching, sicurezza, gestione dei ruoli, mailer, page builder).
[ ] Multisite: sì/no. Se sì, l'ID del sito interessato.
[ ] Lingua del sito e fuso orario (Impostazioni → Generali).

Ove possibile, allega l'esportazione delle Informazioni sullo stato del sito dal core di WordPress.

Istantanea dello stato del plugin

Dalla scheda Car Market Hub → System & Help:

[ ] Badge di stato (OK / avviso / errore) e quali controlli sono rossi.
[ ] Risultato del test di connessione API.
[ ] Timestamp dell'ultima esecuzione dell'importazione e conteggi (as24ci_last_run_time, as24ci_last_run_status).
[ ] Statistiche dell'ultima esecuzione della coda immagini (as24ci_image_queue_last_run).
[ ] Ultimo ping del cron esterno (as24ci_last_external_cron_run).

Se il plugin offre un'azione "Scarica diagnostica" nella scheda System & Help o Strumenti, allega il file risultante. Esaminalo per verificare la presenza di valori sensibili prima dell'invio.

Contesto di configurazione

Per l'area che stai segnalando:

[ ] Importazioni / pianificazione. Modalità cron (wp-cron o server-cron), as24ci_cron_schedule, ora di inizio e intervallo personalizzato, limite veicoli, attivazione/disattivazione della coda immagini, valore as24ci_full_sync. Se DISABLE_WP_CRON è impostato in wp-config.php.
[ ] Connessione / API. URL di base dell'API (senza segreti), Seller ID (o un conteggio segnaposto), se le credenziali sono state modificate di recente.
[ ] Visualizzazione frontend. L'URL esatto della pagina interessata, se il problema si verifica sull'archivio del CPT, su una pagina con shortcode o su un singolo veicolo, le zone di layout in uso, l'eventuale page builder attivo.
[ ] Lead / modulo di contatto. Se la casella di controllo del consenso è abilitata, l'indirizzo del destinatario configurato (puoi descriverlo come "la casella di posta delle vendite" invece di incollare l'e-mail), l'eventuale plugin mailer attivo.
[ ] Avvisi di ricerca. Stato dell'iscrizione della voce interessata (pending, active, inactive, paused), se le e-mail di Double-Opt-In raggiungono il visitatore.
[ ] AI Assistant. Se l'intelligenza artificiale è abilitata, lingua e tono, se l'automazione è attiva. L'AI utilizza la configurazione gestita di Google Gemini in ADP Car Market Hub — nessun campo per provider, modello o chiave API viene mostrato nel backend di WordPress.
[ ] Content Studio. Se il modulo è in uso, la lingua e il tono predefiniti e se è configurata una chiave API Google del cliente (sì/no — non incollare mai la chiave).
[ ] Licenza / attivazione. Lo stato della licenza (as24ci_license_status), l'etichetta del piano, l'ora dell'ultimo controllo andato a buon fine e l'eventuale ultimo codice di errore. Non incollare la chiave di licenza stessa.
[ ] Webhook / REST API. Se l'evento interessato è new_lead, new_import o una rotta REST. URL del ricevitore (puoi sostituire l'host con example.com). Se è configurato un segreto di firma (sì/no).
[ ] Analytics. Se il tracciamento è abilitato, la finestra di conservazione configurata, se il blocco del consenso è attivo.

Passaggi per la riproduzione

[ ] Passaggi numerati che riproducono il problema, partendo da uno stato noto.
[ ] Se il problema è riproducibile (sempre / a volte / una volta).
[ ] Quando è iniziato il problema (dopo un aggiornamento, dopo una modifica della configurazione, dopo una data specifica).
[ ] Se il problema si verifica per tutti gli utenti o solo per un ruolo / browser / localizzazione specifici.

Log e prove

[ ] Voci recenti da Car Market Hub → Logs che coincidono con il sintomo.
[ ] Righe rilevanti dal log di debug di WordPress (wp-content/debug.log) quando WP_DEBUG_LOG è abilitato.
[ ] Righe del log degli errori del server web per la richiesta interessata, se accessibili.
[ ] Output della console del browser e scheda di rete per problemi relativi al frontend. Salva un file HAR se possibile.
[ ] Screenshot o una breve registrazione dello schermo che mostri il sintomo.

Per problemi relativi a REST o webhook, includi l'URL completo della richiesta (con i segreti oscurati), gli header della richiesta, lo stato della risposta e il corpo della risposta.

Cosa escludere

Client secret delle API, token OAuth, il token cron e i segreti condivisi dei webhook. Oscurali con ***REDACTED***.
Dati personali di lead o visitatori (nomi, indirizzi e-mail, numeri di telefono) a meno che il contatto di supporto non ne abbia esplicitamente bisogno e la tua politica sulla privacy ne consenta la condivisione. In caso di dubbio, oscurali.
Dump del database che includono account utente o dati dei visitatori, a meno che non sia esplicitamente richiesto.

Invia la richiesta

Quando invii la richiesta, includi:

Un oggetto breve che descriva il sintomo (ad esempio "L'importazione Cron non viene eseguita come pianificato").
Il riepilogo raccolto sopra, organizzato sotto le intestazioni di questa lista di controllo.
Eventuali allegati (log, screenshot, esportazione dello Stato del sito, esportazione della diagnostica).