Como recuperar o site após uma atualização de plugin do WordPress que gerou tela branca

Como recuperar o site após uma atualização de plugin do WordPress que gerou tela branca

Olá, amigo(a) do mundo digital! Se você está lendo este guia, é porque seu site no WordPress parou de funcionar após uma atualização de plugin — e apareceu aquela famosa tela branca. Não se preocupe: isso é mais comum do que parece, e temos um caminho claro para resolver isso juntos. Sou a Sensei da GeHost, e estou aqui para te ajudar com calma, paciência e um toque de cuidado humano.

Antes de tudo: seu site ainda está lá. A tela branca não significa que ele sumiu — apenas que algo deu errado no momento da atualização. Vamos restaurá-lo com segurança, passo a passo.

Passo 1: Acesse o painel da sua hospedagem

Para começar, faça login no seu painel de controle da GeHost:

• Abra o navegador e vá para painel.gehost.com.br.
• Digite seu usuário e senha (os mesmos da sua conta de hospedagem).

Passo 2: Acesse o Gerenciador de Arquivos

Uma vez logado, procure pela ferramenta chamada Gerenciador de Arquivos. Ela está no painel principal, dentro da seção "Arquivos".

• Clique em Gerenciador de Arquivos.
• Selecione a pasta principal do seu site: public_html.

Passo 3: Encontre o arquivo wp-config.php

Dentro da pasta public_html, procure pelo arquivo chamado wp-config.php. Ele geralmente está no topo da lista, ao lado de arquivos como index.php, wp-content, wp-includes etc.

Este arquivo é o coração da configuração do WordPress. Vamos usá-lo para ativar o modo de depuração.

Passo 4: Ative o modo de depuração (modo debug)

Para entender o que está causando a tela branca, vamos ativar o modo de depuração. Para isso:

1. Clique com o botão direito sobre o arquivo wp-config.php.
2. Selecione a opção Editar (ou "Editar com o editor de texto").
3. Procure pela linha que diz: define('WP_DEBUG', false);
4. Altere para: define('WP_DEBUG', true);
5. Acrescente também estas linhas abaixo, se não estiverem presentes:

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

Isso fará com que o WordPress salve os erros em um arquivo de log, sem exibi-los na tela — mantendo o site seguro, mas nos mostrando o que está errado.

Dica sensata: Não deixe o WP_DEBUG_DISPLAY como true em produção. Isso pode expor informações sensíveis. Só use enquanto estiver corrigindo.

Passo 5: Atualize o arquivo e verifique o erro

Após editar o arquivo:

• Clique em Salvar (ou "Salvar Arquivo").
• Volte ao seu site no navegador.
• Atualize a página.

Se a tela branca persistir, o erro já está sendo gravado. Agora, vamos ver o que está no log.

Passo 6: Acesse o arquivo de log (debug.log)

O arquivo de erro será salvo como debug.log. Ele fica dentro da pasta wp-content do seu site.

1. No Gerenciador de Arquivos, vá até a pasta wp-content.
2. Procure por debug.log.
3. Clique para abrir e leia o conteúdo.

Nele, você verá mensagens como:

PHP Fatal error: Uncaught Error: Call to undefined function my_plugin_function() in /home/usuario/public_html/wp-content/plugins/meu-plugin/meu-arquivo.php on line 45

Essa mensagem é sua chave de ouro. Ela mostra exatamente qual plugin ou arquivo está causando o problema.

Passo 7: Desative o plugin problemático

Com o nome do plugin ou arquivo identificado, agora vamos desativar o culpado:

1. Volte ao Gerenciador de Arquivos.
2. Vá até a pasta wp-content/plugins.
3. Procure pelo nome do plugin listado no erro (ex: meu-plugin).
4. Renomeie a pasta do plugin: adicione .disabled no final (ex: meu-plugin.disabled).

Isso desativa o plugin sem excluí-lo. Se o site voltar a funcionar, você sabe que era ele o problema.

Passo 8: Restaure o modo de segurança

Depois de resolver o problema:

1. Volte ao arquivo wp-config.php.
2. Volte as configurações para o padrão:

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

Salve o arquivo. Isso mantém seu site seguro e sem exibir erros para visitantes.

Passo 9: Atualize o plugin com cuidado

Se o plugin for essencial:

• Volte à pasta wp-content/plugins.
• Renomeie a pasta de volta (remova o .disabled).
• Atualize o plugin com cuidado: vá ao painel do WordPress, vá em Plugins e atualize apenas o que precisa.
• Se possível, faça isso em horários de baixa visitação.

Dica sensata: Sempre faça um backup antes de atualizar plugins ou o WordPress. Você pode usar o recurso de backup no cPanel (em "Backup") — é simples e seguro.

Resumo do que você aprendeu hoje

Quando o site fica branco após uma atualização, não é o fim do mundo. É só um sinal de que algo falhou — e temos um caminho claro para descobrir e resolver:

• Ative o modo debug no wp-config.php.
• Verifique o debug.log para encontrar o erro.
• Desative o plugin problemático renomeando sua pasta.
• Restaure o modo de segurança.
• Atualize com cuidado e sempre faça backups.

Se ainda tiver dúvidas, ou se o problema persistir, entre em contato com o suporte da GeHost. Estamos aqui para ajudar, com um coração de dono e um espírito de parceiro. Afinal, seu site é uma extensão da sua história — e merece cuidado.

Com carinho,
Sensei da GeHost
*Grupo G e Soluções e Eventos LTDA – CNPJ: 46.647.904/0001-04*