As notas do Moodle 5.3 remetem a orientações de atualização de 33 componentes. Para quem mantém plug-ins, temas e integrações, ler tudo de uma vez ajuda pouco. A nossa hipótese é que a lista fica administrável quando separada por prazo, e não por assunto: o que para de funcionar no dia da atualização, o que segue funcionando com aviso e o que só indica o rumo. Só o primeiro precisa estar resolvido antes de marcar a data.
Esse grupo é pequeno. O tema Classic deixou de ser distribuído com o Moodle, e quem depende dele tem duas saídas: instalá-lo à parte antes de atualizar, o que preserva as configurações, ou migrar para o Boost, sem levar presets nem posição dos blocos. Se o config.php força o Classic, a linha tem de ser corrigida à mão. O bloco Linha do tempo foi refeito em React, e o renderizador e as funções de web service dele saíram sem etapa de depreciação. As barras de navegação também passaram ao React, e tema que as estiliza pelas classes antigas precisa de ajuste.
O segundo grupo dá tempo. As classes antigas de web service, como external_api, foram depreciadas em favor das equivalentes em core_external, e 25 funções de usuário mudaram de lugar. O código que as usa continua rodando e emite aviso no modo de depuração. No JavaScript, importar o Bootstrap pelo tema Boost tem remoção marcada para o Moodle 7.0.
O terceiro grupo não obriga a nada agora. As APIs por rotas, que existem desde a 4.5, ganharam OAuth 2, tokens de acesso pessoal e escopos: uma integração pode receber permissão apenas para ler dados de usuários, em vez de herdar tudo o que o dono do token pode fazer. A migração da interface para React segue por partes. E o Boost ganhou modo escuro, experimental e desligado por padrão; quando ele for ligado, plug-in com cor fixa no CSS tende a perder contraste.
A ordem de trabalho sai daí. Antes de atualizar, procure no código herança do Classic, referências à Linha do tempo, estilos das barras de navegação e a linha de tema no config.php. Depois, ligue a depuração no ambiente de teste e zere os avisos. E deixe o rumo para o próximo projeto: integração nova já pode nascer com escopo mínimo, e tela nova, com as variáveis de cor do tema. É o roteiro que seguimos nos projetos de desenvolvimento e de customização.
