Per chiedere assistenza con i log WooCommerce, parti dall’orario del problema e dalla funzione coinvolta. Seleziona il registro pertinente, conserva messaggio e contesto e prepara una copia da condividere dopo aver rimosso dati personali e segreti. Inviare tutta la cartella dei log rende più difficile capire l’accaduto e può esporre informazioni che al tecnico non servono.
Un log registra gli eventi che un componente ha deciso di scrivere. Non è la registrazione completa di ogni azione del negozio e non dimostra, da solo, quale intervento risolverà il guasto. Questa guida propone una procedura di raccolta: non descrive un collaudo eseguito su un negozio cliente.
Scrivi prima che cosa è successo
Prima di aprire un registro, annota la data, l’ora e il fuso orario osservati. Descrivi il passaggio esatto: aggiunta al carrello, conferma dell’ordine, invio di una notifica o aggiornamento di un prodotto. Distingui ciò che hai visto da ciò che stai ipotizzando. «È comparso un errore dopo la conferma» è un fatto; «il gateway ha cancellato l’ordine» richiede altre prove.
Registra anche il risultato atteso, quello effettivo e le modifiche recenti note. Un aggiornamento avvenuto poco prima è un’informazione da confrontare, non la prova della causa. Se il problema riguarda una transazione, evita nuovi tentativi di pagamento soltanto per far comparire un errore: prima bisogna ricostruire lo stato dell’operazione.
Dove trovare i log WooCommerce pertinenti
Nella Bacheca del negozio apri WooCommerce → Stato → Log. La documentazione del sistema di logging WooCommerce descrive una vista che cambia in base all’archiviazione configurata. Nei file, origine e data aiutano a scegliere il registro; usa i filtri disponibili per restringere la ricerca all’intervallo dell’incidente.
Non modificare l’archiviazione, la soglia dei livelli o la conservazione soltanto per leggere gli eventi esistenti. Queste impostazioni influenzano la raccolta: chiedi al tecnico se occorre cambiarle e per quanto tempo. L’assenza di una voce può dipendere dal componente, dalle impostazioni, dall’intervallo o da dati già rimossi; non equivale automaticamente all’assenza del problema.
Errori fatali e registri delle estensioni
Per un’interruzione PHP cerca gli eventuali registri fatal-errors. La guida ufficiale agli errori PHP spiega quali informazioni possono contenere. Per pagamenti, spedizioni o altre integrazioni, verifica invece il registro dell’estensione coinvolta e la sua documentazione: nomi e opzioni non sono uguali per tutti i plugin.
Se WooCommerce non contiene informazioni sufficienti, il tecnico può dover consultare i log del server con l’hosting. Non pubblicare pagine con informazioni di configurazione per cercarli. Conserva separati i registri raccolti da sistemi diversi, indicando sempre la loro origine.
Conserva il contesto che rende leggibile l’errore
Una singola riga ritagliata può perdere il collegamento con gli eventi precedenti. Seleziona un estratto limitato ma comprensibile, mantenendo timestamp, livello, origine, messaggio e le righe necessarie a capire la sequenza. Quando presente, conserva anche il riferimento tecnico della richiesta; verifica prima che non contenga un segreto.
Segnala se l’orario del registro differisce da quello della Bacheca o del servizio esterno. Non correggere silenziosamente le ore nel testo: indica il fuso originale e l’eventuale conversione. Per i pagamenti, un identificativo di transazione può servire al supporto autorizzato, mentre non serve esporlo in un forum pubblico.
Un riferimento coerente per collegare le prove
In una copia dimostrativa puoi sostituire lo stesso ordine con ORDINE-A in tutti gli allegati. Mantieni una corrispondenza privata soltanto se necessaria al lavoro del tecnico. Questo accorgimento riduce l’esposizione, ma non rende automaticamente anonimo il documento: altri dettagli possono ancora ricondurre a una persona.
Prepara una copia da condividere e rileggila
Lavora su una copia dell’estratto e conserva l’originale in un’area ad accesso limitato per la diagnosi. Rimuovi nomi, email, indirizzi, telefoni e dettagli degli acquisti quando non indispensabili. Controlla anche URL e parametri, intestazioni delle richieste, percorsi, campi JSON e schermate: le informazioni possono comparire in punti diversi dal messaggio principale.
Password, chiavi API, token, cookie di sessione e dati della carta non vanno inclusi nella segnalazione. Una schermata richiede lo stesso controllo di un file di testo. Dopo l’oscuramento verifica il documento esportato: il contenuto deve essere rimosso dalla copia, non soltanto coperto da un riquadro che lascia il testo recuperabile.
| Informazione | Che cosa mantenere | Che cosa controllare prima dell’invio |
|---|---|---|
| Evento | Ora, fuso, passaggio e risultato osservato | Dati del cliente nelle descrizioni |
| Estratto del log | Origine, livello, errore e contesto utile | Token, URL con segreti e campi personali |
| Ambiente | Versioni e componenti pertinenti | Informazioni interne non necessarie |
| Allegati | Solo file utili alla segnalazione | Contenuto effettivo della copia esportata |
La tabella è una checklist originale da compilare, non una certificazione della sicurezza dei file. Concorda con l’assistenza il canale e i destinatari prima di trasferire allegati. Un link accessibile pubblicamente non è una buona scorciatoia per consegnare registri del negozio.
Non attivare il debug generale senza un piano
I log WooCommerce disponibili e il debug generale di WordPress sono strumenti distinti. La documentazione WordPress sul debug descrive opzioni pensate per sviluppo e staging e sconsiglia il loro uso sui siti live. Non attivare la visualizzazione degli errori ai visitatori per raccogliere una prova.
Se serve una raccolta aggiuntiva, falla definire al tecnico: ambiente di prova, backup, informazioni da registrare, accessi consentiti e momento di disattivazione. Non installare un plugin di diagnostica o cambiare configurazioni alla cieca. La guida già pubblicata sui fatal error WooCommerce affronta un caso diverso; qui l’obiettivo è preparare materiale leggibile per la diagnosi.
Invia una segnalazione che permetta di iniziare il controllo
Riunisci in un messaggio la sequenza per osservare il problema, gli orari, il comportamento atteso e quello effettivo. Aggiungi l’elenco degli allegati e spiega quali informazioni hai oscurato. Se un dato non è disponibile, scrivilo; non riempire i vuoti con una ricostruzione presunta.
La guida WooCommerce per chiedere supporto richiama anche rapporto di stato, schermate e passaggi di riproduzione. Rileggi ciascun materiale prima della condivisione. Chi gestisce il negozio deve sapere a chi è stato consegnato e quali controlli restano da svolgere.
Hai un’anomalia nel negozio e non sai quali prove preparare? Richiedi assistenza SOS WP descrivendo il passaggio coinvolto e l’orario del problema. Concordiamo i dati tecnici necessari prima dell’invio degli allegati, senza inserire credenziali o dati di pagamento nel primo messaggio.
