WordPress 6.7: as traduções não funcionam corretamente

Incidente resolvido. O WordPress 6.7.1 corrigiu uma regressão da versão 6.7 que impedia o carregamento de algumas traduções de plugins. Este artigo mantém-se como referência histórica e não se recomenda voltar a uma versão antiga para a evitar.

Não confunda essa regressão com o aviso Function _load_textdomain_just_in_time was called incorrectly. O WordPress 6.7 começou a avisar quando um plugin ou tema pede traduções demasiado cedo. O domínio de texto que aparece no aviso orienta para o componente, mas é o rastreio que permite localizar a chamada.

Ação atual

• Atualize o WordPress para a última versão de segurança disponível, juntamente com os pacotes de idioma, plugins e temas.
• Faça antes uma cópia de segurança e valide a atualização em staging quando a loja ou o site forem críticos.
• Se uma tradução continuar sem carregar, identifique se falta o texto ou se existe o aviso anterior. Atualize o componente e verifique que não executa funções de tradução antes do hook recomendado pelo WordPress.
• Mantenha as personalizações num tema filho ou plugin próprio; não substitua ficheiros do núcleo nem de traduções geridos pelas atualizações.

Em código próprio, inicie as funções traduzíveis de um plugin em init ou depois. Para um tema, utilize o ponto de inicialização documentado, como after_setup_theme. Não esconda o aviso como solução: reproduza a página com registo privado e confirme que desaparece depois da alteração.

Não faça downgrade do WordPress para a 6.6 nem para outra versão sem suporte: uma regressão pode reabrir vulnerabilidades já corrigidas.

Se só falhar um texto ou um idioma

Compare o idioma do site com o do perfil do administrador e verifique que existe a tradução dessa cadeia no pacote do componente. Uma tradução incompleta não é a regressão da 6.7. Depois de atualizar o pacote, limpe a cache afetada e teste o mesmo ecrã.

A nota oficial de internacionalização do WordPress 6.7 explica as chamadas demasiado precoces. Guarde o domínio de texto e o rastreio ao comunicar o caso ao programador; não edite ficheiros de idioma que serão substituídos na próxima atualização.