Come contribuire al debug dei plugin di WordPress

Gli sviluppatori di JoomUnited lavorano sempre affinché i tuoi plugin funzionino nel modo più ottimale possibile; naturalmente, in alcuni casi può verificarsi qualche tipo di errore, ad esempio un'incompatibilità generata da un plugin di terze parti. E cosa vogliamo quando si verificano questi tipi di errori? Naturalmente, vengono risolti rapidamente ...    

In questo post ti insegneremo come fornire le informazioni corrette allo sviluppatore, in modo che possa comprendere e risolvere rapidamente l'errore. Questo post sarà suddiviso in 3 passaggi che seguiremo per fornire le informazioni giuste a uno sviluppatore quando si verifica un problema:

• Attiva il log di debug
• Installa il plugin Troubleshooting
• Controlla se ci sono errori JavaScript

Attiva il sistema di debug e log di WordPress

Prima di tutto, dobbiamo sapere cos'è WP_DEBUG ; Come possiamo vedere su Wikipedia, " WP_DEBUG è una costante PHP (una variabile globale permanente) che può essere utilizzata per attivare la modalità "debug" in tutto WordPress. Si presume che sia false per impostazione predefinita e di solito viene impostata su true nel file wp-config.php nelle copie di sviluppo di WordPress."

Come possiamo vedere WP_DEBUG è una costante che per impostazione predefinita è disattivata ma possiamo attivarla on per uno scopo di debug temporaneo. 

Inoltre, esiste un'altra costante PHP chiamata WP_DEBUG_LOG che ci aiuterà a creare automaticamente un file di testo con tutti gli errori dei tuoi plugin, ed è quello che invieremo agli sviluppatori.  

Ti insegneremo esattamente come possiamo attivarlo e come apparirà se c'è un errore con il tuo plugin, WP Meta SEO verrà utilizzato per questo esempio, ma puoi seguire gli stessi passaggi per tutti i nostri plugin. In questo caso abbiamo un problema con WP Meta SEO, potrebbe essere qualsiasi problema, quindi quello che faremo è aprire il file wp-config.php , si può fare con il tuo software di editor di testo preferito, con il Blocco note, Visual Studio Code, Brackets ad esempio, basta andare e aprire wp-config.php.

Il file si trova nella root del tuo server, dove è installato il tuo sito WordPress.

Aprilo con l'editor di testo, poi premi CTRL + F oppure fai clic su Modifica > Trova… vedrai una casella in cui puoi digitare la parola che vuoi trovare, in questo caso digitiamo "WP_DEBUG" e premi Invio finché non trovi:
"define( 'WP_DEBUG', false )"

Ora che siamo su quella riga, rimuovi “false” e digita true, premi Invio e nella riga successiva copia define( 'WP_DEBUG_LOG', true ); e salva il file, dovrebbe apparire come nell'immagine seguente.

Se queste due righe vengono modificate, apparirà un file chiamato “debug.php” in /wp-content/

E fatto… abbiamo completato il primo passaggio, questo è uno dei file di cui i nostri sviluppatori avranno bisogno per accelerare il processo di risoluzione del tuo problema. Tutti gli errori saranno monitorati e scritti proprio in questo file di testo.

Installa il plugin di risoluzione dei problemi di WordPress

Health Check & Troubleshooting è un plugin che consente di eseguire un controllo dei conflitti senza influire sui normali visitatori del tuo sito, è davvero facile da usare e installare, per questo esempio utilizzeremo ancora WP Meta SEO . Segui questi passaggi per installare ed eseguire un controllo dei conflitti con Health Check & Troubleshooting:  

• Accedi al tuo sito WordPress, ti troverai nella dashboard del tuo sito
• Fai clic su “Plugin” nella sezione sinistra della pagina
• Fai clic su “Aggiungi nuovo”
• Digita “Health Check & Troubleshooting” nella barra di ricerca, come mostrato di seguito

• Clicca su “Installa ora”, l'elenco dei plugin si caricherà automaticamente, cerca quello giusto e clicca su “Installa ora” e poi su “Attiva”

• Clicca su “Salute del sito”, nel menu a sinistra c'è una sezione chiamata “Strumenti” Clicca su di essa, e poi su “Salute del sito”

• Clicca sulla scheda "Risoluzione dei problemi" , leggi le informazioni di avviso e clicca su "Entra in modalità risoluzione dei problemi" 

La modalità di risoluzione dei problemi disattiva automaticamente tutti i plugin e passa a un tema predefinito. La modalità di risoluzione dei problemi non influisce sui normali visitatori del tuo sito.  

• Riproduci il problema che hai riscontrato

In un ambiente predefinito senza plugin attivi e con un tema predefinito, se il problema si verifica, significa che il nostro plugin non è la causa del comportamento inaspettato.

• Clicca su “Plugin” > “Plugin installati”

  Il menu "Plugin" si espanderà fornendoti opzioni aggiuntive. Clicca su "Plugin installati"

• Clicca su "Abilita durante la risoluzione dei problemi" accanto a WP Meta SEO

• Riproduci il problema che stavi riscontrando con solo WP Meta SEO attivo e un tema predefinito, se il problema si verifica, è causato dal nostro plugin.

In un certo senso è una buona notizia perché hai già identificato una parte del problema. Ora è necessario che lo sviluppatore acceda al tuo sito web e risolva il problema prima che rilasciamo una nuova versione! In caso contrario, ripeti i passaggi per attivare il prossimo plugin disattivato con cui riesci a riprodurre l'errore.

Controllo e debug degli errori JavaScript nei plugin di WordPress

Cercheremo gli errori JavaScript con la console di Chrome o Firefox. A seconda del browser, il nome è leggermente diverso, ma seguendo Chrome e Firefox, la chiameremo “Console”. Per aprire la console, segui semplicemente questi passaggi:  

• Clicca con il tasto destro su ispeziona, nel frontend in qualsiasi parte del sito

• Seleziona console, Si apriranno gli strumenti per sviluppatori sul lato destro della pagina, fai clic su “Console”

Controlla se ci sono errori, con la console aperta, riproduci l'errore che stavi riscontrando e dai un'occhiata alla console: gli errori sono testi rossi che descrivono dove si trova il conflitto JavaScript

Se hai trovato un errore JavaScript, fai uno screenshot della versione espansa dell'errore per includerlo nel tuo ticket/post.

Invia / Condividi la tua segnalazione del problema

Ora che hai tutte queste informazioni, aiuterai lo sviluppatore a velocizzare il processo, basta andare su tutte le informazioni che hai raccolto e aggiungerle al tuo ticket/post, ricordiamo, gli elementi sono:  

• debug.log
• Nota sui plugin che causano conflitti
• Una cattura della console JavaScript con l'errore

Se segui questi passaggi e ci invii le informazioni corrette, lo sviluppatore potrà eseguire un debug più rapido e ti ringraziamo molto in anticipo :)    

Crea e condividi un nuovo account utente WordPress per scopi di supporto

Creare un nuovo utente amministratore è talvolta un modo rapido per mostrare al team di supporto qual è il tuo problema. Prima di iniziare con questa procedura, un breve promemoria:

• Non conserviamo le vecchie credenziali dopo che il problema è stato risolto (per motivi di sicurezza)
• Ti consigliamo di rimuovere gli account utente amministratore creati per scopi di supporto
• Tutte le informazioni condivise con il nostro team sono protette e rimarranno private

Per creare un nuovo utente, innanzitutto devi accedere al tuo sito di amministrazione. Dopo aver effettuato l'accesso con successo, ti trovi nella dashboard di WordPress.

Poi, dovresti andare al Menu > Utenti a sinistra.

Successivamente, vai alla parte superiore dello schermo, fai clic sul pulsante Aggiungi nuovo oppure spostati sul pulsante Aggiungi nuovo nel menu a sinistra.

Poi, apparirà sul tuo schermo il modulo Aggiungi nuovo utente . Ci sono 2 campi obbligatori da compilare: Nome utente, Email.

Nel campo Password puoi usare il generatore di password casuali o impostarne una tua. E puoi selezionare l'opzione Invia notifica all'utente se vuoi inviare al nuovo utente un'email relativa al suo account.

Successivamente, scegli un Ruolo per l'utente nella casella a discesa. Questo è un passaggio importante per impostare i permessi degli utenti sul tuo sito. "Amministratore" è il livello più alto e dà all'utente accesso a tutte le funzionalità del tuo sito web. Puoi impostare altri ruoli se vuoi limitare l'accesso dell'utente.

Infine, clicca sul pulsante Aggiungi nuovo utente in basso. È già fatto, buona fortuna!