Introdução#
Ao ter problemas com plug-ins do WordPress, muitas vezes é difícil identificar a causa exata. Os problemas podem resultar de conflitos de plug-ins, incompatibilidades de temas ou problemas de configuração do servidor. O plug-in "Verificação de integridade e solução de problemas", desenvolvido pela equipe do WordPress.org, é uma ferramenta de diagnóstico poderosa que ajuda a isolar e identificar esses problemas.
O que é Verificação de integridade e solução de problemas?#
Health Check & Troubleshooting é um plugin oficial do WordPress.org que permite:
- Execute diagnósticos em sua instalação do WordPress
- Entre em um "modo de solução de problemas" que desativa todos os plug-ins e alterna para um tema padrão apenas para sua sessão de usuário
- Reative seletivamente plugins e temas para identificar conflitos
- Reúna informações técnicas sobre seu site para fins de suporte
O principal benefício é que o modo de solução de problemas afeta apenas seu usuário administrador – seus visitantes continuarão a ver seu site normalmente enquanto você diagnostica problemas.
Instalação#
- Faça login no painel do WordPress
- Go to Plugins > Add New
- Pesquise por "Verificação de integridade e solução de problemas"
- Clique em "Instalar agora" e depois em "Ativar"
Verificando se há erros de JavaScript no console do navegador#
Before using the Health Check plugin, it’s often valuable to check for JavaScript errors that might be causing functionality issues:
- Abra as ferramentas de desenvolvedor do seu navegador:
- Chrome/Edge: Pressione F12 ou clique com o botão direito do mouse e selecione "Inspecionar"
- Firefox: Pressione F12 ou clique com o botão direito do mouse e selecione "Inspecionar elemento"
- Safari: Enable developer tools in Preferences > Advanced, then press Option+Command+I
- Navegue até a guia "Console"
- Interaja com o recurso problemático (clique em botões, envie formulários, etc.)
- Procure mensagens de erro vermelhas que aparecem no console
- Preste atenção aos nomes de script mencionados nos erros
- Observe todas as referências a plug-ins específicos nos caminhos do arquivo
- Procure padrões como erros "indefinidos" ou "nulos"
- Documente quaisquer erros que você encontrar para compartilhar com as equipes de suporte
JavaScript errors can often immediately identify which plugin is causing an issue or provide valuable clues about the nature of a conflict.
Usando o modo de solução de problemas para diagnosticar problemas#
Etapa 1: entre no modo de solução de problemas#
- Go to Tools > Site Health
- Clique na guia "Solução de problemas"
- Clique no botão "Entrar no modo de solução de problemas"
- O WordPress será recarregado em um estado básico com todos os plugins desativados e usando um tema padrão (apenas para sua sessão)
Etapa 2: testar seu problema#
Uma vez no modo de solução de problemas, teste se o problema que você estava enfrentando ainda ocorre:
- Se o problema for RESOLVIDO (não ocorre mais): Isso confirma que o problema está relacionado a um plug-in ou ao seu tema
- Se o problema persistir: O problema pode estar relacionado aos principais arquivos do WordPress, configuração do servidor ou problemas de banco de dados
Etapa 3: Teste sistemático (se o problema foi resolvido)#
Se o problema foi resolvido no modo de solução de problemas, siga estas etapas para identificar a causa específica:
- Ainda no modo de solução de problemas, clique em "Ativar e testar plug-in" ao lado do seu tema para testar se o tema está causando o problema
- Se o problema retornar, seu tema é a causa
- Se o problema não retornar, continue testando os plug-ins
- Habilite os plug-ins um por um:
- Clique em "Ativar e testar plug-in" ao lado de um plug-in
- Test if the issue returns after each plugin is enabled
- Continue até encontrar o plug-in que faz com que o problema retorne
- Quando você encontrar o plug-in ou tema conflitante:
- Anote isso
- Você pode mantê-lo desativado ou entrar em contato com o desenvolvedor para obter suporte
Etapa 4: sair do modo de solução de problemas#
Depois de identificar o problema:
- Clique em "Desativar modo de solução de problemas" na parte superior da tela
- Your site will return to its normal state with all plugins and your theme active
What to Do After Identifying a Conflict #
Se o problema for com um plug-in:#
- Verifique se o plugin tem atualizações disponíveis
- Pesquise no fórum de suporte do plug-in por problemas semelhantes
- Entre em contato com o desenvolvedor do plugin com detalhes específicos:
- Versão WordPress
- Versão do PHP
- Other active plugins
- Etapas para reproduzir o problema
- Quaisquer mensagens de erro do console do navegador
Se o problema for com um tema:#
- Verifique se as atualizações do tema estão disponíveis
- Considere mudar temporariamente para um tema padrão do WordPress
- Entre em contato com o desenvolvedor do tema com detalhes específicos
Se o problema persistir no modo de solução de problemas:#
Isso sugere questões mais profundas, como:
- Problemas de integridade do arquivo principal do WordPress
- Corrupção de banco de dados
- Problemas de configuração do servidor
- Problemas de compatibilidade de versão do PHP
Nesses casos, considere:
- Running a Site Health check (Tools > Site Health > Status)
- Consultando seu provedor de hospedagem
- Buscando ajuda de um desenvolvedor WordPress
Técnicas avançadas de solução de problemas#
Usando as informações de depuração da verificação de integridade#
- Go to Tools > Site Health > Info
- Esta página contém informações detalhadas sobre a configuração do WordPress
- Clique em "Copiar para a área de transferência" para compartilhar com as equipes de suporte
Testando com contas de usuário alternativas#
Às vezes, os problemas afetam apenas funções de usuário específicas:
- Criar uma conta de usuário temporária com uma função diferente
- Teste se o problema ocorre para esta nova conta de usuário
Verificando os logs de erros do servidor#
Os erros do servidor podem não ser visíveis no navegador:
- Verifique se há logs de erros no painel de controle da sua hospedagem
- Ou adicione
define('WP_DEBUG', true);edefine('WP_DEBUG_LOG', true);ao seu arquivo wp-config.php - Os erros serão registrados em /wp-content/debug.log
Dicas para solução de problemas eficiente#
- Binary Search Method: Para sites com muitos plugins, use uma abordagem de "dividir e conquistar":
- Habilite metade dos seus plugins e teste
- Se o problema aparecer, o problema está nessa metade; se não, está na outra metade
- Continue dividindo o grupo problemático ao meio até isolar o problema
- Este método é significativamente mais rápido do que testar plug-ins um por um quando você tem muitos plug-ins
- Complex Conflicts: Esteja ciente de que alguns problemas são causados por combinações de plug-ins:
- Se você não conseguir identificar um único plug-in problemático, tente testar combinações diferentes
- Preste atenção aos plug-ins que atendem a funções semelhantes (vários plug-ins de SEO, várias soluções de cache)
- Às vezes, dois plug-ins funcionam bem individualmente, mas entram em conflito quando usados juntos
- Methodical Documentation: Mantenha anotações detalhadas do que você testou e dos resultados
- Recent Changes: Comece testando plugins ou temas instalados ou atualizados recentemente
- Common Culprits: Teste primeiro os plug-ins de alto impacto (cache, segurança, plug-ins de otimização)
- Clear Cache: Certifique-se de limpar todos os plug-ins de cache ao testar
- Browser Testing: Teste em vários navegadores para descartar problemas específicos do navegador
Quando entrar em contato com o suporte do plug-in#
Se você identificou um problema, mas não consegue resolvê-lo sozinho:
- Gather comprehensive information:
- Versão WordPress
- Versão do PHP
- Complete list of active plugins
- Nome e versão do tema
- Informações do navegador e do dispositivo
- Etapas exatas para reproduzir o problema
- Capturas de tela ou gravações de tela, se aplicável
- Quaisquer mensagens de erro do console do navegador
- Check existing documentation:
- Revise a base de conhecimento do plug-in
- Pesquise no fórum de suporte do plug-in por problemas semelhantes
- Submit a detailed support ticket:
- Inclua todas as informações coletadas acima
- Seja específico sobre o que você já tentou
- Mencione que você usou a Verificação de integridade para isolar o problema
- Forneça acesso temporário de administrador, se possível e apropriado
Quanto mais informações você fornecer em sua solicitação de suporte inicial, mais rápido a equipe de suporte poderá ajudá-lo a resolver o problema.
Finalmente#
O plugin Health Check & Troubleshooting é uma ferramenta inestimável para diagnosticar problemas do WordPress sem interromper seu site ativo. Ao testar sistematicamente plugins e temas, você pode identificar conflitos e fornecer informações detalhadas para as equipes de suporte quando necessário.
Remember: Always back up your WordPress site before making significant changes to plugins, themes, or core files.