Problemas depois de atualizar para o WordPress 5.x

Nota histórica: este guia refere-se à passagem do WordPress 4.x para o 5.x. Numa instalação atual, utilize versões compatíveis e mantidas do WordPress, do PHP, de temas e de plugins.

O facto de uma falha aparecer depois de atualizar não demonstra por si só que o WordPress ou um plugin sejam a causa. Reproduza o sintoma uma vez e consulte o erro registado nesse mesmo momento.

Diagnóstico

1. Faça uma cópia de segurança antes de modificar componentes.
2. Reproduza a ação que falha e anote a hora e o URL.
3. No WordPress 5.2 ou posterior, reveja também o email de recuperação; nas versões anteriores essa função não existe. Consulte o registo do PHP. Se não dispuser de um, ative temporariamente o registo privado de depuração.
4. Anote o primeiro erro fatal do pedido, incluindo o ficheiro, a linha e o componente mencionado.

Um ficheiro dentro de wp-content/plugins/ ou wp-content/themes/ identifica o componente que estava a ser executado, mas ainda é preciso verificar se está desatualizado, se existe uma incompatibilidade documentada ou se recebeu dados inválidos de outro componente.

Aplicar a correção mais restrita

• Atualize primeiro o componente indicado e consulte os seus requisitos de WordPress e PHP.
• Se não conseguir entrar em wp-admin, utilize o modo de recuperação. Como medida reversível, pode mudar o nome apenas da pasta do plugin identificado e voltar a carregar o mesmo caminho.
• Se o registo não indicar um componente, reproduza o problema em staging e faça um teste de conflito: mude temporariamente para um tema predefinido e desative plugins por grupos.

Um teste só confirma a relação se a mesma ação falhar com o componente ativo e funcionar ao desativá-lo. Reponha depois a configuração original e procure uma atualização ou uma correção do fornecedor.

Reveja também a Saúde do site para detetar requisitos não cumpridos, mas não trate cada recomendação como a causa da falha.

Alterações do editor e conteúdo antigo

A passagem para o WordPress 5 introduziu o editor de blocos, mas uma alteração de interface não equivale a um erro PHP. Se o problema surgir ao editar um artigo, guarde uma revisão, verifique a Consola e a Rede e reveja a compatibilidade do tema e dos plugins com o editor utilizado.

Não converta em massa conteúdo antigo nem faça downgrade do núcleo para resolver um único ecrã. Teste primeiro uma cópia representativa, guarde as suas revisões e verifique que o conteúdo público mantém o design, as ligações e as imagens depois da alteração.