Como diagnosticar erro ao atualizar temas ou plugins no WordPress
Olá, querido(a) cliente! Seja bem-vindo(a) ao seu guia de diagnóstico de erros ao atualizar temas ou plugins no WordPress. Aqui, você vai aprender a identificar o problema com calma, passo a passo — como se estivéssemos conversando sobre um café. Não se preocupe: mesmo que pareça complicado, com um pouco de atenção, tudo volta ao normal!
Passo 1: Verifique se o erro está no seu site ou apenas no painel
Antes de tudo, veja se o problema é apenas na tela de atualização ou se o site está realmente inacessível.
- Se o erro aparece apenas no painel do WordPress (no menu "Plugins" ou "Temas"), provavelmente é um problema de permissão ou espaço em disco.
- Se o site inteiro está com erro (tela branca, mensagem de erro, ou não carrega), o problema pode estar no tema ou plugin que foi atualizado.
Dica do Sensei: Nunca atualize um tema ou plugin se o site já está com erro. Isso pode piorar tudo!
Passo 2: Acesse o Gerenciador de Arquivos do cPanel
Para diagnosticar, vamos olhar diretamente dentro da sua hospedagem. Siga os passos:
- Entre no cPanel da sua conta (use o link que você recebeu por e-mail).
- No painel, encontre e clique em Gerenciador de Arquivos (File Manager).
- Selecione a pasta public_html (ou a pasta do seu site, se estiver em subdiretório).
Passo 3: Verifique o diretório de plugins e temas
Os plugins e temas ficam em pastas específicas dentro do seu site. Vamos ver se há algo estranho:
- Na pasta public_html, acesse a pasta wp-content.
- Dentro de wp-content, verifique duas pastas principais:
- plugins — aqui estão todos os plugins.
- themes — aqui estão todos os temas.
- Se você tentou atualizar um plugin ou tema, verifique se a pasta do plugin ou tema foi criada com nome incompleto, com caracteres estranhos, ou se está vazia.
Atenção: Se a pasta do plugin ou tema estiver vazia ou com arquivos corrompidos, a atualização falhou. Isso pode acontecer por falta de espaço ou erro de conexão.
Passo 4: Verifique o espaço em disco e limites de upload
Um erro comum é quando o espaço de armazenamento está cheio ou o limite de upload é muito baixo.
- No cPanel, clique em Métricas (Metrics).
- Verifique o uso de disco. Se estiver em 95% ou mais, é hora de limpar arquivos.
- Se o uso estiver alto, vá ao Gerenciador de Arquivos e exclua arquivos temporários, imagens antigas ou backups antigos.
Passo 5: Verifique os arquivos de log (opcional, mas poderoso)
Se o erro persistir, o WordPress pode estar gravando mensagens de erro. Vamos ver:
- No Gerenciador de Arquivos, vá até a pasta wp-content.
- Procure por um arquivo chamado debug.log. Se não existir, crie um.
- Abra o arquivo (ou crie com um editor de texto) e veja se há mensagens como "Failed to create directory" ou "Permission denied".
Dica do Sensei: Se vir mensagens de "permissão", o problema é que o servidor não pode escrever na pasta. Isso geralmente se resolve com ajuste de permissões (mas não é para fazer sozinho — peça ajuda da GeHost!).
Passo 6: Soluções práticas para resolver
Com base no que você descobriu, aqui estão os caminhos mais comuns:
- Se o espaço está cheio: Exclua arquivos antigos, backups ou imagens desnecessárias.
- Se a atualização falhou por permissão: Entre em contato com o suporte da GeHost. Nós ajudamos a corrigir isso com segurança.
- Se o erro aparece apenas na tela de atualização: Tente atualizar o WordPress inteiro (não só o plugin/tema) — isso muitas vezes resolve conflitos.
- Se o site parou de funcionar: Renomeie a pasta do tema ou plugin com um nome como
tema-antigoouplugin-antigo. Isso desativa o problema e restaura o site.
Quer ajuda? Nós estamos aqui!
Se você seguiu todos os passos e ainda não conseguiu resolver, não se preocupe. O suporte da GeHost está pronto para te ajudar com um toque de cuidado e paciência. É só nos chamar!
Com carinho,
Sensei da GeHost 🌿
