Pular para o conteúdo principal
Versão: 1.x

Conflitos de Plugin

Conflitos de plugins são uma das causas mais comuns de problemas com o WCPOS. Quando outros plugins do WordPress interferem na funcionalidade do WooCommerce ou do WCPOS, você pode enfrentar travamentos, problemas de desempenho ou comportamentos inesperados.

Sinais de Conflitos de Plugin​

Você pode ter um conflito de plugin se experimentar:

  • Erros fatais - "Ocorreu um erro crítico neste site"
  • Problemas de desempenho - Carregamento lento, timeouts ou alta carga do servidor
  • Problemas de funcionalidade - Recursos que não funcionam como esperado
  • Problemas de sincronização de dados - Produtos, pedidos ou clientes não sincronizados corretamente
  • Problemas com gateways de pagamento - Falhas no checkout ou erros de processamento de pagamento

Antes de Começar: Use um Site de Staging​

Importante

Nunca resolva conflitos de plugins em seu site ao vivo. Sempre use um ambiente de staging para evitar interromper as operações do seu negócio.

O que é um Site de Staging?​

Um site de staging é uma cópia exata do seu site ao vivo onde você pode testar alterações com segurança, sem afetar seus clientes. A maioria dos provedores de hospedagem modernos oferece ambientes de staging como recurso padrão.

Se Seu Provedor Não Oferecer Staging​

Se seu provedor de hospedagem não oferecer sites de staging, considere mudar para um host que ofereça. Este é um recurso padrão nos dias de hoje e essencial para:

  • Testes seguros de plugins/temas
  • Atualizações do WordPress
  • Resolução de problemas
  • Trabalho de desenvolvimento

Hosts recomendados com staging:

  • WP Engine
  • SiteGround
  • Kinsta
  • Cloudways
  • Muitos outros

Passo 1: Verifique Erros Fatais​

Se você está enfrentando travamentos ou erros críticos, comece verificando os registros de erro:

  1. Verifique os Registros do WCPOS - Abra a tela de Registros no WCPOS para mensagens de erro
  2. Verifique os Registros de Erros Fatais - Siga o guia de resolução de erros críticos para encontrar mensagens de erro detalhadas
  3. Anote os detalhes do erro - Procure os nomes dos plugins ou os caminhos dos arquivos mencionados no erro

Se você encontrar um erro fatal que menciona um plugin específico, esse é provavelmente seu culpado. Você pode desabilitar esse plugin e testar se o problema foi resolvido.

Passo 2: O Método de Eliminação de Plugins​

Se não houver erros fatais nos registros, ou se você quiser identificar conflitos relacionados ao desempenho, use esta abordagem sistemática:

2.1 Crie uma Linha de Base​

  1. Acesse seu site de staging
  2. Teste a funcionalidade problemática - Anote exatamente o que não está funcionando ou está lento
  3. Registre métricas de desempenho - Se for um problema de desempenho, anote os tempos de execução dos Registros

2.2 Desative Todos os Plugins (Exceto os Essenciais)​

Mantenha esses plugins ativos:

  • WooCommerce
  • WooCommerce POS (WCPOS)
  • WooCommerce POS Pro (se você o tiver)

Desative tudo o mais:

  1. Vá para WP Admin > Plugins
  2. Selecione todos os outros plugins
  3. Escolha "Desativar" no menu suspenso de ações em massa
  4. Clique em "Aplicar"

2.3 Teste o Problema​

  1. Limpe quaisquer caches - Se você usa plugins de cache, limpe todos os caches
  2. Teste a funcionalidade problemática - Funciona agora?
  3. Verifique o desempenho - Os tempos de execução melhoraram?

Se o problema foi resolvido: Você tem um conflito de plugin. Prossiga para o Passo 2.4.

Se o problema persistir: O problema provavelmente não é um conflito de plugin. Considere:

  • Problemas de recursos do servidor (veja Desempenho do Servidor)
  • Conflitos de tema (veja o Passo 3)
  • Problemas do WordPress/WooCommerce principais

2.4 Ative os Plugins Um a Um​

Agora você precisa identificar qual plugin está causando o conflito:

  1. Ative um plugin - Comece com os mais essenciais primeiro
  2. Teste a funcionalidade - Verifique se o problema retorna
  3. Se nenhum problema - Ative o próximo plugin e teste novamente
  4. Se o problema retornar - Você encontrou o plugin conflitante!

Ordem de Prioridade dos Plugins (ativa na seguinte ordem):

  1. Plugins de Segurança - Wordfence, Sucuri, etc.
  2. Plugins de SEO - Yoast, RankMath, etc.
  3. Plugins de Desempenho - Cache, otimização
  4. Gateways de Pagamento - Stripe, PayPal, etc.
  5. Outras extensões do WooCommerce
  6. Plugins gerais do WordPress

2.5 Documente Suas Descobertas​

Quando você identificar o plugin conflitante:

  1. Anote o nome e a versão do plugin
  2. Documente o problema específico que ele causa
  3. Verifique se há uma versão atualizada disponível
  4. Procure plugins alternativos que ofereçam funcionalidade semelhante

Passo 3: Verifique Conflitos de Tema​

Embora temas raramente afetem o WCPOS (já que ele usa sua própria interface), eles podem às vezes causar problemas com:

  • Processos de checkout (se usando gateway de checkout na web)
  • Funcionalidade da área administrativa
  • Respostas da API

Teste com um Tema Padrão​

  1. No seu site de staging, mude para um tema padrão do WordPress:
    • Twenty Twenty-Four
    • Twenty Twenty-Three
    • Twenty Twenty-Two
  2. Teste a funcionalidade problemática
  3. Se o problema foi resolvido - Seu tema tem um conflito
Impacto do Tema

É muito menos provável que os temas causem problemas no WCPOS em comparação com plugins. A interface do POS funciona de forma independente do seu tema. No entanto, os temas podem afetar:

  • Páginas de checkout do WooCommerce
  • Funcionalidade administrativa do WordPress
  • Respostas da REST API

Passo 4: Resolvendo Conflitos de Plugins​

Uma vez que você tenha identificado o plugin conflitante, você tem várias opções:

Opção 1: Atualizar o Plugin​

  1. Verifique se há atualizações - O conflito pode ser corrigido em uma versão mais nova
  2. Atualize o plugin em seu site de staging primeiro
  3. Teste minuciosamente antes de atualizar no site ao vivo

Opção 2: Encontrar uma Alternativa​

  1. Pesquise plugins alternativos que oferecem a mesma funcionalidade
  2. Teste alternativas em seu site de staging
  3. Migre as configurações se estiver mudando de plugins

Opção 3: Contatar o Desenvolvedor do Plugin​

  1. Relate o conflito ao desenvolvedor do plugin
  2. Forneça informações detalhadas:
    • Versões dos plugins envolvidos
    • Versões do WordPress e WooCommerce
    • Mensagens de erro exatas ou comportamento
    • Passos para reproduzir o problema

Opção 4: Solução Personalizada​

Para plugins essenciais que não podem ser substituídos:

  1. Contate um desenvolvedor WordPress para criar uma solução personalizada
  2. Considere hooks específicos do plugin para desativar a funcionalidade conflitante
  3. Use lógica condicional para desativar o plugin em páginas relacionadas ao POS

Tipos Comuns de Plugin em Conflito​

Categorias de Plugins de Alto Risco​

Plugins de Segurança:

  • Podem bloquear solicitações da API
  • Podem interferir na autenticação
  • Frequentemente têm regras de firewall agressivas

Plugins de Cache:

  • Podem armazenar em cache respostas da API de forma inadequada
  • Podem interferir em dados em tempo real
  • Podem causar problemas de dados obsoletos

Plugins de SEO:

  • Plugins pesados podem desacelerar a área administrativa
  • Podem adicionar consultas desnecessárias ao banco de dados
  • Podem interferir em respostas da REST API

Construtores de Páginas:

  • Frequentemente carregam scripts pesados na área administrativa
  • Podem entrar em conflito com páginas administrativas do WooCommerce
  • Podem interferir em processos de checkout

Plugins de Membros/Restrição:

  • Podem bloquear o acesso à API
  • Podem interferir na autenticação do usuário
  • Podem restringir o acesso a recursos necessários

Categorias de Plugins de Baixo Risco​

Formulários de Contato: Geralmente não interferem no WCPOS
Plugins de Mídia Social: Raramente causam conflitos
Plugins de Análise: Geralmente seguros, a menos que sejam muito pesados
Plugins Básicos de Conteúdo: Geralmente compatíveis

Dicas de Prevenção​

Manutenção Regular​

  1. Mantenha plugins atualizados - Sempre use as versões mais recentes
  2. Remova plugins não utilizados - Não apenas desative, exclua-os
  3. Teste atualizações em ambiente de staging antes de aplicar no site ao vivo
  4. Monitore o desempenho regularmente usando métricas de Desempenho do Servidor

Melhores Práticas na Seleção de Plugins​

  1. Escolha desenvolvedores respeitáveis - Verifique avaliações e frequência de atualizações
  2. Evite funcionalidade redundante - Não instale vários plugins que fazem a mesma coisa
  3. Leia informações de compatibilidade - Verifique se os plugins são testados com o WooCommerce
  4. Comece com plugins mínimos - Adicione funcionalidade gradualmente conforme necessário

Obtendo Ajuda​

Se você não conseguir resolver o conflito de plugin:

Para Usuários Pro​

Suporte Pro

Usuários Pro recebem suporte prioritário para resolução de conflitos de plugins. Nossa equipe pode ajudar a identificar e resolver conflitos para você.

Suporte da Comunidade​

Ao Contatar o Suporte​

Por favor, forneça:

  1. Lista de plugins ativos com versões
  2. Versões do WordPress e WooCommerce
  3. Descrição detalhada do problema
  4. Passos que você já tentou
  5. Mensagens de erro dos registros
  6. Métricas de desempenho do servidor se relevante

Documentação Relacionada​