Como corrigir o botão Adicionar Mídia que não funciona
O que é o botão Adicionar Mídia que não funciona?
No WordPress, o botão Adicionar Mídia abre uma janela (modal) construída em JavaScript que carrega a Biblioteca de Mídia dentro do editor. Para isso funcionar, todos os scripts da tela precisam carregar sem erro. Se um plugin ou o tema injeta um JavaScript com falha, o navegador interrompe a execução naquele ponto e o botão deixa de responder ao clique. O problema é quase sempre de front-end, não de servidor: os arquivos continuam na biblioteca, só a janela para de abrir.
Como identificar
- Clicar em “Adicionar mídia” no editor não abre nada: a janela não aparece e a tela fica escurecida ou travada.
- O console do navegador (F12) mostra um erro de JavaScript como “Uncaught TypeError” logo após o clique.
- A Biblioteca de Mídia em Mídia > Biblioteca carrega em branco ou fica girando o ícone de carregamento.
- O problema começou logo após ativar um plugin novo, atualizar um plugin ou trocar de tema.
Como prevenir
- Teste plugins novos em um ambiente de homologação antes de ativá-los no site em produção
- Mantenha plugins e tema atualizados, já que correções de conflito de JavaScript saem nas novas versões
- Limpe o cache do site e do navegador após cada atualização para não servir scripts antigos
Causa
- Conflito de JavaScript de um plugin recém-ativado ou atualizado que quebra os scripts da janela de mídia.
- Tema com JavaScript próprio na área administrativa interferindo no carregamento do editor.
- Cache do navegador ou plugin de cache servindo uma versão antiga e quebrada dos arquivos JS.
- Constante CONCATENATE_SCRIPTS ativa em alguns ambientes, combinando scripts e gerando erro de carregamento.
- Arquivo de script do core corrompido após uma atualização interrompida do WordPress.
Como resolver
- Limpe o cache e teste em aba anônima: limpe o cache do plugin de cache, se houver, e o cache do navegador. Abra o painel em uma aba anônima e teste o botão. Muitas vezes o erro era só um arquivo JS antigo em cache.
- Abra o console do navegador: pressione F12, vá na aba Console e clique em Adicionar Mídia. O nome do arquivo .js que aparece no erro costuma apontar para qual plugin ou tema está causando o conflito.
- Desative os plugins em bloco: em Plugins, desative todos de uma vez e teste o botão. Se voltar a funcionar, reative um a um, testando após cada ativação, até o erro reaparecer e revelar o culpado.
- Troque para um tema padrão: ative temporariamente um tema padrão como o Twenty Twenty-Four. Se o botão passar a funcionar, o conflito está no seu tema, e você deve reportar ao desenvolvedor dele.
- Force scripts não concatenados: se nada resolveu, adicione no wp-config.php a constante que desliga a concatenação de scripts do admin, listada no bloco de código, e teste de novo.
// wp-config.php - desliga a concatenacao de scripts do painel.
// Coloque ANTES da linha "That's all, stop editing!".
// Util quando um script combinado quebra a janela de midia.
define( 'CONCATENATE_SCRIPTS', false );Perguntas frequentes
Por que o botão Adicionar Mídia parou de abrir?
Como descubro qual plugin está causando o conflito?
Limpar o cache pode resolver sozinho?
O problema pode estar no tema, não num plugin?
O que é a constante CONCATENATE_SCRIPTS?
A Biblioteca de Mídia também abre em branco. É o mesmo problema?
Como corrigir widgets que desapareceram após atualização
Widgets que desapareceram no WordPress após uma atualização costumam ser efeito da tela de widgets em blocos, introduzida no WordPress 5.8. Os widgets continuam no banco; o que muda é a interface, e às vezes um tema FSE remove de vez as áreas de widget clássicas.
Como corrigir o editor de blocos (Gutenberg) que não carrega
Quando o Gutenberg não carrega, o editor de blocos abre em branco, fica girando ou cai para o Editor Clássico. A causa quase sempre é um erro de JavaScript: cache antigo, minificação que quebra os scripts do editor ou conflito com outro plugin/tema que interrompe a carga da interface.
Como sair do modo de manutenção travado
O modo de manutenção travado acontece quando uma atualização de plugin, tema ou núcleo é interrompida no meio e o WordPress não chega a remover o arquivo .maintenance da raiz do site. Com esse arquivo presente, o site mostra a mensagem de manutenção a todos os visitantes até que o arquivo seja apagado manualmente.
Como corrigir atualização automática do WordPress que falha
A atualização automática falha quando o WordPress não consegue concluir sozinho a atualização de núcleo, plugins ou temas. As causas mais comuns são permissões de arquivo que bloqueiam a escrita, o WP-Cron que não dispara e a falta de acesso direto ao sistema de arquivos do servidor.
Como corrigir Destination folder already exists no WordPress
Destination folder already exists aparece quando você instala um plugin ou tema cuja pasta de destino já existe em wp-content. O WordPress se recusa a sobrescrever a pasta existente e interrompe a instalação. Costuma ocorrer após uma instalação ou atualização anterior que falhou no meio e deixou a pasta para trás.
Como corrigir o loop Update WordPress Database
O loop Update WordPress Database acontece quando o WordPress pede para atualizar o banco a cada visita e a tela nunca é superada, mesmo depois de clicar no botão. Em geral é causado por cache servindo a tela antiga ou por um descompasso na versão do banco que a rotina de atualização não consegue gravar.
