Como diagnosticar página branca após atualização de plugin Print

Como diagnosticar página branca após atualização de plugin no WordPress

Olá, amigo(a) GeHost! 😊

Esse guia foi feito especialmente para você, que quer entender o que está acontecendo sem precisar de conhecimento técnico. Vamos juntos?

🔍 Primeiro: entenda o que é uma "página branca"

Uma página branca no WordPress geralmente significa que algo deu errado no código do seu site — especialmente após uma atualização. O erro pode estar em um plugin, no tema ou em um arquivo de configuração.

Por mais que pareça um problema grave, na maioria das vezes é algo simples de resolver. Vamos começar com os passos mais seguros e fáceis.

🔧 Passo a passo: diagnóstico e solução

1. Verifique se o problema está no seu site ou apenas no seu navegador

   Abra seu site em um navegador diferente ou em modo anônimo (como "navegação privada"). Se a página branca continuar, o problema é no servidor. Se aparecer o site normalmente, o problema está no cache do seu navegador.

2. Ative o modo de depuração do WordPress

   Esse é o passo mais importante. Ele vai mostrar mensagens de erro que normalmente estão escondidas.

   Para isso, vamos acessar o arquivo wp-config.php do seu site. Ele está na pasta principal do WordPress (geralmente dentro de public_html).

   Use o Gerenciador de Arquivos do cPanel para encontrar esse arquivo.

   

   Na pasta public_html, procure por um arquivo chamado wp-config.php. Clique nele com o botão direito e escolha "Editar".

3. Adicione as linhas de depuração

   Procure pela linha que diz:

   define('WP_DEBUG', false);

   Altere para:

   define('WP_DEBUG', true);

   Em seguida, adicione estas duas linhas logo abaixo:

   define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

   Isso vai fazer com que os erros sejam salvos em um arquivo chamado wp-content/debug.log, sem aparecer na tela.

   Salve as alterações e recarregue o site. Agora, se houver um erro, ele aparecerá no arquivo de log.

4. Verifique o arquivo de log

   Volte ao Gerenciador de Arquivos e acesse a pasta wp-content. Dentro dela, procure pelo arquivo chamado debug.log.

   Clique para abrir. Ele pode mostrar algo como:

   PHP Fatal error: Uncaught Error: Call to undefined function some_function() in /path/to/plugin-file.php on line 45

   Esse erro vai te dizer exatamente qual plugin ou arquivo está causando o problema.

5. Desative o plugin problemático

   Se o erro apontar para um plugin específico, o próximo passo é desativá-lo.

   Para isso, vá até a pasta wp-content/plugins no Gerenciador de Arquivos.

   Procure pelo nome do plugin que está causando o erro (por exemplo, nome-do-plugin). Renomeie a pasta — por exemplo, troque para nome-do-plugin-antigo.

   Isso desativa o plugin sem excluí-lo. Recarregue o site. Se ele voltar a funcionar, o problema era esse plugin.

6. Atualize ou substitua o plugin

   Se o plugin é essencial, tente:

   • Atualizá-lo novamente (vá ao painel do WordPress > Plugins > Atualizar).
   • Entrar em contato com o desenvolvedor do plugin.
   • Substituí-lo por uma versão mais estável ou alternativa.
7. Restaure o modo de segurança

   Quando o site estiver funcionando normalmente, volte ao arquivo wp-config.php e troque as linhas de depuração de volta:

   define('WP_DEBUG', false);
define('WP_DEBUG_LOG', false);
define('WP_DEBUG_DISPLAY', false);

   Isso garante que erros não sejam exibidos publicamente.

💡 Dicas do Sensei GeHost

• ✅ Antes de atualizar qualquer plugin ou tema, faça um backup do seu site. No cPanel, vá em Backup e gere um backup completo.
• ⚠️ Nunca atualize plugins críticos sem testar em um ambiente de desenvolvimento (se possível).
• 💡 Use plugins de segurança e monitoramento para evitar problemas como esse no futuro.

📞 Precisa de ajuda?

Se, mesmo após seguir todos os passos, o problema persistir, entre em contato com o nosso suporte. Nós estamos aqui para te ajudar com um sorriso no coração. 🌟

Seu site é importante — e você, como dono dele, merece tranquilidade. Com a GeHost, você não está sozinho.