Kaksi Media

O terror do ecrã branco no WordPress

homem com olhar de pânico

Se usas WordPress há algum tempo é provável que já tenhas deparado com o famoso “ecrã branco da morte” (uma tradução literal de white screen of death). É um erro assustador. Equivalente aos momentos de pânico dos escritores, quando confrontados com a triste página em branco.

O browser diz que estamos no nosso domínio, na nossa página na internet, mas onde deveríamos encontrar conteúdos, textos, fotos, vemos apenas o triste branco de uma página vazia. Não há nada para ver, nada para navegar.

Primeiro é o pânico. Como aconteceu, porquê, onde está aquilo que não está na página mas deveria estar?

Agora que já tudo lhe passou pela cabeça, é tempo de acalmar. Respire fundo. Vamos ver aquilo que pode ter acontecido.

Assim, de repente, vemos duas possibilidades.

Primeira. Se a página em branco ocorre em diferentes websites que utilizam a mesma empresa de alojamento, podemos supor que o problema está neste serviço. É muito provável que seja uma falha momentânea, como um reinício de servidores. Para despistar, é melhor contactar com o suporte da entidade que aloja os teus websites.

Segunda. Não se verificando a primeira hipótese, o problema estará na tua instalação. Há várias possibilidades.

O ecrã branco no WordPress acontece quando ocorre um erro de PHP ou na base de dados. Ou quando a memória disponível atingiu o limite, algo que é frequente num site alojado num servidor partilhado com muitos outros sites.

Uma questão de memória

É um erro de Exhausted Memory. Em alojamentos partilhados, não é difícil que o teu website atinja o limite de memória que lhe foi dedicado. Para resolveres o problema, podes tentar aumenta-lo.

Usa o o gestor de ficheiros do teu serviço de alojamento ou um aplicação de FTP para visitares os ficheiros do teu website. Procura o wp-config.php. Abre o ficheiro num editor de texto (nunca o Word) acrescenta uma linha de código.

define('WP_MEMORY_LIMIT', '64M');

É possível ir além dos 64M de memória a utilizar mas isso depende do servidor onde está alojado o teu site. Podes sempre tentar os 128M ou 256M.

Em qualquer caso, se este problema ocorrer com frequência, o teu site pode estar a enfrentar ‘dores de crescimento’. Isto é, os recursos são insuficientes para responder ao número de visitantes. Procura confirmar com o serviço de alojamento. Se assim for, talvez esteja na hora de considerar uma mudança para um plano de alojamento de melhor qualidade.

Um plugin incómodo

A causa pode não ser a memória. Pode estar num plugin. Se tiveres acesso ao painel de controlo do WordPress, vai a Plugins e desactiva aquele que foi instalado ou actualizado mais recentemente. Se não resultar, ou não souberes qual foi, desactiva todos os plugins. Vê se o website regressou e vai activando um a um até encontrares aquele que provocou o erro.

Se não tiveres acesso ao painel de controlo, volta a aceder via FTP.

Vai à directoria ‘wp-content/plugins’, que contém todos os plugins instalados. Muda o nome da pasta, por exemplo para ‘plugins-erro’ e vê se consegues aceder ao site.

Em vez de alterar o nome da pasta ‘plugins’ podes alterar o nome da pasta de cada plugin e assim vais testando um a um. Até ao erro final.

Se o problema estiver num plugin, deves elimina-lo, reportar o erro ao seu autor e esperar que ele responda com uma solução ou correcção ou, em alternativa, encontrar outro para a mesma funcionalidade.

Se o erro do ecrã branco no WordPress ocorreu quando estava a activar um novo plugin é muito provável que este seja a causa. Eventualmente provocado por um conflito entre o plugin e o tema que tem no site.

E por falar em tema…

Um tema problemático

Se as duas opções anteriores não forem a resposta para o problema, então a origem poderá estar relacionada com o tema.
Começa por fazer um backup de todos os ficheiros da pasta do tema que estás a utilizar. Activa o mais recente tema por defeito do WordPress e vê se o teu website regressa. Se regressar, o problema está mesmo no tema.

Se assim for, depois de salvaguardares os ficheiros com a cópia de segurança, podes apagar a respectiva pasta.
O melhor a fazer é tentar instalar uma cópia fresca do tema que estavas a utilizar. Se o problema persistir, contacta o seu autor.

Nada? Tenta activar o mode de debug

Se a solução não tiver sido encontrada nos pontos anteriores, será necessário ir um pouco mais longe e, enfim, um pouco mais técnico.
Vamos activar o modo de debug do WordPress.

Usando o gestor de ficheiros do teu alojamento ou o FTP visita o ficheiro wp-config.php file.
Localiza a seguinte linha:

define('WP_DEBUG', false);
Coloca ‘//’ no início para que fique assim:
//define('WP_DEBUG', false);
Agora copia e cola as cinco linhas de código aqui apresentadas imediatamente abaixo da linha anterior:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors',0);

Estes dados vão dizer à tua instalação para revelar todos os erros. A compilação será apresentada num ficheiro error.log, que vais encontrar na pasta wp-content.

Os dados que vão surgir, e podem ser imensos, devem permitir desvendar o mistério da ‘página branca da morte’. Podem ser consultados num editor de texto. Se houver algo que não entendas, é melhor procurar ajuda.

Ficheiros corrompidos

É também possível que um dos ficheiros do core do WordPress tenha ficado corrompido. É pouco provável mas não é, de todo, impossível. Portanto, temos também de considerar esta possibilidade.

Se for este o caso, aconselhamos a que tente reinstalar o WordPress de fresco, conforme recomenda as instruções do sistema:

  • Descarregue a mais recente versão do WordPress do site oficial em português ou inglês ou outra língua da sua preferência (pode mudar mais tarde);
  • Descompacte o ficheiro zip;
  • Desactive os plugins usando um dos métodos acima indicados;
  • Via FTP, cPanel ou outro meio, elimine os directórios (pastas) wp-includes e wp-admin no seu site. Não elimine a pasta wp-content;
  • Via FTP, cPanel ou outro meio, carregue as novas pastas wp-includes e wp-admin do seu computador para o seu site, para o local onde estavam aquelas que eliminou no ponto anterior
  • Carregue os ficheiros individuais que estão na pasta wp-content do WordPress que descarregou e confirme que pretende substituir estes ficheiros por aqueles que estão no seu site; Tal como indicado atrás, não elimine a pasta wp-content. Não elimine nenhum ficheiro ou pasta dentro do wp-content;
  • Carregue todos os outros ficheiros individuais que estão na pasta WordPress que descarregou para a sua instalação e substitua aqueles que lá estão.
  • Não elimine o ficheiro wp-config.php.

A pasta wp-content é onde estão os temas e plugins, bem como as imagens do seu site.

Agora que já instalou uma versão fresca do WordPress é tempo de reactivar os plugins.

Cópia de segurança, backup, chama o que quiseres mas faz sempre

Uma das tarefas essenciais de quem tem um site WordPress (ou qualquer site, já agora) é fazer cópias de segurança. Podes confiar nos backups que o fornecedor de alojamento faz (já agora, confirma se o serviço de alojamento faz cópias de segurança e com que regularidade) mas aconselhamos sempre a que tenha o seu próprio sistema.

Este será a última salvaguarda caso todas as opções indicadas tenham falhado.

Se nada resultar, procure ajuda junto do suporte do serviço de alojamento e, em último caso, aplique a cópia de segurança mais recente.

José Freitas

José Freitas

Ajudo pequenas e médias empresas e empreendedores a criar estratégias online para conseguirem melhores clientes, através da comunicação relacional. Na minha vida passada fui jornalista durante 25 anos. A comunicação é a minha praia. Viciado em café intenso e aromático.

Queres receber as nossas mensagens semanais o teu email?

As nossas mensagens são compostas por pequenos textos escritos a pensar em ti (sim a sério, a pensar em ti).

Não enviamos SPAM porque também não gostamos de o receber.