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

Conflitos de Plugins

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 falhas, problemas de desempenho ou comportamento inesperado.

Sinais de Conflitos de Plugins​

Você pode ter um conflito de plugins se estiver enfrentando:

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

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

Importante

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

O que é um Site de Testes?​

Um site de testes é 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 testes como um recurso padrão.

Se Seu Provedor Não Oferecer Staging​

Se seu provedor de hospedagem não oferece sites de testes, considere mudar para um provedor que o faça. Este é um recurso padrão hoje em dia e essencial para:

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

Provedores recomendados com staging:

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

Etapa 1: Verifique Erros Fatais​

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

  1. Verifique os Logs do WCPOS - Abra a tela de Logs no WCPOS para quaisquer mensagens de erro
  2. Verifique os Logs 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 por nomes de plugins ou caminhos de arquivos mencionados no erro

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

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

Se não houver erros fatais nos logs 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 testes
  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 Logs

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 todo o resto:

  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 estiver resolvido: Você tem um conflito de plugin. Prossiga para a Etapa 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 a Etapa 3)
  • Problemas no núcleo do WordPress/WooCommerce

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 não houver problema - Ative o próximo plugin e teste novamente
  4. Se o problema retornar - Você encontrou o plugin em conflito!

Ordem de Prioridade dos Plugins (ative nesta 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 em conflito:

  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 por plugins alternativos que forneçam funcionalidade semelhante

Etapa 3: Verifique Conflitos de Tema​

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

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

Teste com um Tema Padrão​

  1. Em seu site de testes, 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 estiver resolvido - Seu tema tem um conflito
Impacto do Tema

Os temas têm muito menos probabilidade de causar problemas com o WCPOS em comparação com plugins. A interface do POS funciona independentemente do seu tema. No entanto, os temas podem afetar:

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

Etapa 4: Resolvendo Conflitos de Plugins​

Depois de identificar o plugin em conflito, você tem várias opções:

Opção 1: Atualizar o Plugin​

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

Opção 2: Encontrar uma Alternativa​

  1. Pesquise plugins alternativos que forneçam a mesma funcionalidade
  2. Teste as alternativas em seu site de testes
  3. Migre configurações se trocar de plugins

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

  1. Informe 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 ou comportamentos exatos
    • Etapas 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 correção personalizada
  2. Considere hooks específicos do plugin para desativar funcionalidades conflitantes
  3. Use lógica condicional para desativar o plugin em páginas relacionadas ao POS

Tipos Comuns de Plugins em Conflito​

Categorias de Plugins de Alto Risco​

Plugins de Segurança:

  • Podem bloquear solicitações da API
  • Podem interferir na autenticação
  • Muitas vezes 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 nas respostas da REST API

Construtores de Páginas:

  • Muitas vezes carregam scripts pesados na área administrativa
  • Podem causar conflitos com páginas administrativas do WooCommerce
  • Podem interferir nos processos de checkout

Plugins de Membros/Restrições:

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

Categorias de Plugins de Baixo Risco​

Formulários de Contato: Geralmente não interferem com o 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: Normalmente compatíveis

Dicas de Prevenção​

Manutenção Regular​

  1. Mantenha os 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 no staging antes de aplicar no site ao vivo
  4. Monitore o desempenho regularmente usando métricas de Desempenho do Servidor

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

  1. Escolha desenvolvedores respeitáveis - Verifique avaliações e frequência de atualização
  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 foram testados com o WooCommerce
  4. Comece com plugins mínimos - Adicione funcionalidades gradualmente conforme necessário

Obtendo Ajuda​

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

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​

Discord Communitysupport@wcpos.com

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. Etapas que você já tentou
  5. Mensagens de erro dos logs
  6. Métricas de desempenho do servidor se relevante
Erro CríticoComo encontrar logs de erro fatal
LogsCompreendendo logs e métricas do WCPOS
Desempenho do ServidorDiagnosticando problemas de desempenho
Desempenho do CheckoutOtimização da velocidade de checkout