Condividere le informazioni di debug di WPML con il Supporto

Il team di supporto di WPML richiede le stesse informazioni per la maggior parte delle richieste di supporto: il blocco Informazioni di debug da WPML > Supporto > Controllo del sistema, una copia del sito o del suo database, l'output della console del browser e poche altre cose. Questa pagina descrive ciascuna di esse e dove trovarla, in modo da poter incollare fin da subito i dettagli corretti nel tuo ticket. Per tutto ciò che devi verificare prima di richiedere supporto (requisiti minimi, aggiornamenti, controlli dei conflitti, la checklist fai-da-te), vedi Prima di richiedere supporto.

Copia il blocco delle informazioni di debug dal Controllo del sistema

Apri WPML > Supporto > Controllo del sistema. La pagina mostra un blocco Informazioni di debug: versione di PHP, versione di WordPress, ogni plugin di WPML e la sua versione, ambiente del server, configurazione della lingua e i valori di configurazione che WPML legge da wp-config.php. Fai clic su Copia le informazioni di sistema negli appunti nella parte superiore del blocco, quindi incollale nel tuo ticket.

Questo blocco indica al Supporto quale versione di ogni componente stai eseguendo e qual è la configurazione attuale del sito. È il punto di partenza prima di qualsiasi indagine più approfondita.

Copia l'elenco dei plugin installati

Scorri fino in fondo a WPML > Supporto. La sezione Plugin installati elenca ogni plugin presente sul sito, la sua versione e se è attivo o inattivo. Fai clic su Copia elenco negli appunti e incollalo nel tuo ticket.

I conflitti tra plugin sono una delle cause più comuni dei problemi di WPML. Il Supporto utilizza questo elenco per individuare incompatibilità note e per porre le giuste domande di approfondimento.

Copia il log pertinente

Per i problemi che riguardano i servizi di traduzione, il WPML > Supporto > Registro delle comunicazioni acquisisce il traffico API tra il tuo sito e il backend di traduzione. Se le traduzioni falliscono in modo non ovvio, copiare le voci recenti del log nel ticket fornisce al Supporto l'esatta risposta lato server.

Per i problemi all'interno dell'Editor di traduzione avanzato, i Registri degli errori dell'Editor di traduzione avanzato acquisiscono gli errori lato server riscontrati dall'ATE.

Per i problemi con i lavori di traduzione (lavori che non si avviano, non si completano o scompaiono), i Log dei lavori di gestione delle traduzioni mostrano il ciclo di vita di ogni lavoro.

Vedi Log per sapere quale log consultare in ogni situazione.

La pagina WPML > Supporto presenta una casella di controllo Condividi le informazioni diagnostiche con il supporto WPML nella parte superiore. Selezionala per consentire al team di supporto di WPML di leggere direttamente le informazioni di debug del tuo sito. Non vengono condivise password o dati personali: solo il blocco delle informazioni di debug.

Questo è più veloce rispetto a incollare i blocchi in una richiesta di supporto, perché il Supporto può rileggere i dati aggiornati man mano che la conversazione procede. Puoi disattivare questa opzione in qualsiasi momento dalla stessa casella di controllo.

Quando il Supporto richiede i log di debug

Per problemi più complessi (strani comportamenti dell'ATE, race condition, errori intermittenti), a volte il Supporto richiede il log di debug completo di WPML, che è più dettagliato rispetto al blocco Informazioni di debug.

Per abilitare la registrazione di debug:

Aggiungi define( 'WP_DEBUG', true ); e define( 'WP_DEBUG_LOG', true ); a wp-config.php prima della riga “That’s all, stop editing!”. WordPress inizierà a scrivere gli errori e gli avvisi PHP in wp-content/debug.log.
Riproduci il problema sul sito.
Apri o scarica wp-content/debug.log e copia la sezione pertinente (filtra in base al timestamp in cui si è verificato il problema).
Incolla nella tua richiesta di supporto o allega come file.
Al termine, disattiva nuovamente WP_DEBUG. Lasciarlo attivo in produzione è un rischio per la sicurezza, poiché gli errori includono informazioni sui percorsi.

Per la procedura completa, incluso il filtraggio delle voci specifiche di WPML, vedi la guida al debug di WPML.

Quando il Supporto richiede una copia del sito

Per i problemi che il Supporto non riesce a riprodurre solo dai log, potrebbe richiedere una copia del sito per indagare. Il metodo standard consiste nell'utilizzare uno strumento di backup o di staging per pacchettizzare l'intero sito e condividerlo tramite il modulo di caricamento sicuro di WPML (il Supporto ti fornirà il link quando lo richiederà).

Strumenti consigliati per la fase di pacchettizzazione:

Duplicator. Pacchettizza il database e i file in un singolo archivio, più uno script di installazione.
All-in-One WP Migration. Pacchettizzazione simile, formato leggermente diverso.
Lo strumento di staging/clonazione integrato del tuo provider di hosting (se produce un archivio portatile).

Prima di condividere la copia:

Assicurati di condividere una copia del sito, non l'accesso al sito live stesso.
Rimuovi i dati personali dal database se il tuo sito contiene dati dei clienti (Duplicator e AIOWP hanno opzioni di esportazione per questo scopo).
Conferma di avere un backup funzionante della produzione prima di apportare modifiche basate su ciò che il Supporto trova nella copia.

WPML gestisce automaticamente il caso di spostamento del sito tra server; il caso di invio di una copia al Supporto è quello in cui pacchettizzi il sito per consentire a qualcuno al di fuori del tuo ambiente di hosting di avviarlo localmente.

Trovare le credenziali del tuo account WPML

Se il Supporto ti chiede su quale account WPML è registrato questo sito e non te lo ricordi:

La chiave del sito mascherata su WPML > Attiva e aggiorna identifica quale chiave utilizza il sito (ad es., ******abcd). Confrontala con i siti elencati nel tuo account WPML.
Se hai perso l'accesso all'email dell'account, cerca nella tua casella di posta i messaggi provenienti da accounts@wpml.org. L'email originale di creazione dell'account contiene le credenziali.