Como identificar conflito de plugins no WordPress
O que é um conflito de plugins no WordPress?
Um conflito de plugins no WordPress acontece quando dois plugins (ou um plugin e o tema) carregam código incompatível: enfileiram a mesma biblioteca JavaScript em versões diferentes, registram a mesma rota ou disputam o mesmo hook. O resultado é uma função que para, uma tela branca ou um erro de JavaScript no console. Como o WordPress não aponta o culpado, é preciso isolá-lo por eliminação, desativando e reativando plugins de forma controlada.
Como identificar
- Uma função quebra (editor, checkout, formulário) logo após instalar ou atualizar um plugin.
- O console do navegador mostra “Uncaught TypeError” ou “$ is not a function” numa tela específica.
- A Tela Branca da Morte aparece só em uma página, e o site volta ao desativar um plugin.
- O erro some no Modo de Recuperação do WordPress (com todos os plugins desligados) e volta ao reativá-los.
Como prevenir
- Atualize plugins e tema em staging antes de aplicar em produção, testando as funções críticas
- Mantenha só os plugins que você realmente usa, reduzindo a superfície de conflito
- Exclua scripts essenciais (checkout, editor) da minificação e combinação do plugin de cache desde o início
Causa
- Dois plugins enfileiram a mesma biblioteca JavaScript (ex.: jQuery ou um slider) em versões diferentes.
- Plugin e tema registram a mesma rota REST, shortcode ou custom post type com o mesmo identificador.
- Plugin de cache ou de minificação combina/adia scripts e quebra a ordem de carregamento de outro plugin.
- Dois plugins usam o mesmo hook com prioridade conflitante, e um sobrescreve a ação do outro.
- Plugin desatualizado chama uma função PHP removida que outro plugin (ou o core/PHP 8) já não fornece.
Como resolver
- Faça backup e teste em staging: antes de desativar nada, gere um backup ou trabalhe num ambiente de homologação para não afetar visitantes.
- Desative todos os plugins de uma vez: em Plugins, selecione todos e use Desativar em massa. Se você não acessa o wp-admin, renomeie a pasta wp-content/plugins por FTP para forçar a desativação.
- Confirme que o erro sumiu: reproduza a ação que falhava. Se o site voltou ao normal, a causa é um plugin (ou a interação entre eles).
- Reative um plugin por vez: ligue um plugin, teste a função, ligue o próximo. Quando o erro reaparecer, o último plugin reativado é o culpado (ou está em conflito com um já ativo).
- Troque para um tema padrão: se nenhum plugin sozinho causa o erro, ative temporariamente um tema padrão (Twenty Twenty-Four) para descartar conflito com o tema.
- Decida a correção: com o culpado isolado, atualize-o, procure um substituto compatível ou abra um chamado com o desenvolvedor citando o conflito específico.
-- Desativa TODOS os plugins direto no banco quando o wp-admin esta inacessivel
-- (rode via phpMyAdmin; troque wp_ pelo prefixo real das suas tabelas)
UPDATE wp_options
SET option_value = 'a:0:{}'
WHERE option_name = 'active_plugins';
-- Para conferir o que estava ativo ANTES de zerar (faca isto primeiro):
SELECT option_value FROM wp_options WHERE option_name = 'active_plugins';Perguntas frequentes
Como saber se o problema é um plugin ou o tema?
Posso identificar o conflito sem derrubar o site no ar?
Desativei tudo e o erro continua. E agora?
Reativar plugins um a um pode causar perda de dados?
O que causa o conflito de jQuery entre plugins?
Um plugin de cache pode parecer um conflito de plugins?
Como corrigir notificações de Q&A que não chegam aos instrutores no Tutor LMS
As notificações de Q&A do Tutor LMS não chegam aos instrutores quando o addon Email do Tutor LMS Pro está desligado, o gatilho New Q&A Message está desmarcado ou o site não tem um SMTP configurado para entregar o e-mail disparado quando o aluno faz uma pergunta.
Como corrigir o Social Login que não funciona no Tutor LMS
O Social Login do Tutor LMS para de funcionar quando o addon está desativado, o Tutor LMS Pro não está ativo, as credenciais do provedor (Client ID do Google ou App ID do Facebook) estão incorretas, ou a URL de redirecionamento no console do provedor não casa com a do site.
Como corrigir custom field do ACF que não exibe em cursos do Tutor LMS no WordPress
No ACF Tutor LMS, o custom field não exibe no curso quase sempre porque a regra de localização do grupo de campos não aponta para o tipo de post courses, ou porque o template do curso chama get_field sem o ID do curso correto, deixando o valor do meta vazio na página.
Como corrigir a lógica condicional que não funciona no WPForms
A lógica condicional WPForms não funciona quando as regras Smart Logic não executam no frontend e os campos deixam de aparecer ou esconder conforme a resposta do usuário. A causa quase sempre esta no JavaScript do formulário que não carrega.
Como corrigir o mapeamento de campos no User Registration do WPForms
O mapeamento de campos no User Registration do WPForms falha quando os dropdowns em Settings -> User Registration não apontam para os campos certos do formulário, quando o campo Email obrigatório esta ausente ou quando a Meta Key de um custom user meta não casa com o nome real do campo, fazendo os dados não chegarem ao perfil do usuário.
Como corrigir formulários de inscricao do WPForms que não funcionam no Tutor LMS no WordPress
O formulário de inscricao do WPForms não funciona no Tutor LMS quando o WPForms cria a conta WordPress por fora do fluxo de cadastro do Tutor LMS: o usuário nasce sem o papel de estudante e sem passar pelo hook de signup, entao não aparece como aluno nem consegue se matricular nos cursos.
