Ao resolver problemas com plug-ins, temas ou código personalizado do WordPress, poderá ser necessário ativar a depuração do WordPress. Esta funcionalidade regista todos os erros detectados no seu site, ajudando-o a identificar a origem dos problemas ou a reunir mais detalhes sobre potenciais problemas.
Este guia irá mostrar-lhe como ativar a depuração de forma segura no seu site WordPress.
Ativar a depuração no WordPress
Para ativar a depuração no seu site, siga os passos abaixo.
1) Localização do wp-config.php ficheiro
Por predefinição, a depuração do WordPress estará desactivada. Para o ativar, terá de aceder aos ficheiros do seu site através de um FTP (File Transfer Protocol) ou do cPanel do seu servidor.
Para saber mais sobre o FTP, consulte este artigo do WPBeginner. Em alternativa, os nossos amigos do WPBeginner também têm um artigo sobre informações do cPanel, que pode ver aqui.
Em alternativa, pode também instalar um plugin como o WP File Manager para aceder facilmente aos ficheiros do seu servidor através da área de administração do WordPress. Para saber mais sobre esse plugin , consulte o seu plugin em WordPress.org.
2) Editar o wp-config.php ficheiro
Quando os ficheiros do seu site estiverem abertos, terá de abrir wp-config.php para edição.
Este ficheiro estará localizado na pasta raiz do seu servidor. Para saber mais sobre as instruções de localização e diretório, consulte este artigo.
Localize o ficheiro wp-config.php no diretório raiz do seu site. Este ficheiro contém as definições de configuração principais do seu site.
Encontre esta linha perto do fim do ficheiro:
('WP_DEBUG', false);
3) Ativar a depuração
Substitua-o por este trecho de código com a configuração de depuração:
// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );
// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );
// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
// Use dev versions of core JS and CSS files (only needed if you are modifying these core files)
define( 'SCRIPT_DEBUG', true );
Isto permitirá a depuração e, o que é importante, evitará que quaisquer dados registados sejam apresentados no seu site. Em vez disso, será guardado um registo de depuração nos ficheiros do seu site.
4) Replicar o problema
Depois de guardar estas alterações no wp-config.phpSe o problema for resolvido, terá de voltar ao seu sítio e reproduzir o problema que viu anteriormente. Isto garantirá que o problema é registado no novo registo de erros.
5) Ver o registo de depuração
Em seguida, pode regressar aos ficheiros do seu sítio e abrir https://yoursitename.com/wp-content/debug.log
O conteúdo de um registo de erros pode variar muito, dependendo da causa e do número de problemas, mas agora deve poder ver detalhes adicionais, como um caminho de ficheiro para a origem de um erro de código, para o ajudar a localizar melhor o problema.
Para obter informações mais detalhadas sobre a depuração do WordPress, consulte a documentação oficial sobre depuração do WordPress.