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
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:
- Verifique os Logs do WCPOS - Abra a tela de Logs no WCPOS para quaisquer mensagens de erro
- Verifique os Logs de Erros Fatais - Siga o guia de resolução de erros críticos para encontrar mensagens de erro detalhadas
- 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
- Acesse seu site de testes
- Teste a funcionalidade problemática - Anote exatamente o que não está funcionando ou está lento
- 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
- WCPOS
- WCPOS Pro (se você o tiver)
Desative todo o resto:
- Vá para
WP Admin > Plugins - Selecione todos os outros plugins
- Escolha "Desativar" no menu suspenso de ações em massa
- Clique em "Aplicar"
2.3 Teste o Problema
- Limpe quaisquer caches - Se você usa plugins de cache, limpe todos os caches
- Teste a funcionalidade problemática - Funciona agora?
- 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:
- Ative um plugin - Comece com os mais essenciais primeiro
- Teste a funcionalidade - Verifique se o problema retorna
- Se não houver problema - Ative o próximo plugin e teste novamente
- Se o problema retornar - Você encontrou o plugin em conflito!
Ordem de Prioridade dos Plugins (ative nesta ordem):
- Plugins de segurança - Wordfence, Sucuri, etc.
- Plugins de SEO - Yoast, RankMath, etc.
- Plugins de desempenho - Cache, otimização
- Gateways de pagamento - Stripe, PayPal, etc.
- Outras extensões do WooCommerce
- Plugins gerais do WordPress
2.5 Documente suas Descobertas
Quando você identificar o plugin em conflito:
- Anote o nome e a versão do plugin
- Documente o problema específico que ele causa
- Verifique se há uma versão atualizada disponível
- 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
- Em seu site de testes, mude para um tema padrão do WordPress:
- Twenty Twenty-Four
- Twenty Twenty-Three
- Twenty Twenty-Two
- Teste a funcionalidade problemática
- Se o problema estiver resolvido - Seu tema tem um conflito
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
- Verifique se há atualizações - O conflito pode ter sido corrigido em uma versão mais nova
- Atualize o plugin em seu site de testes primeiro
- Teste completamente antes de atualizar no site ao vivo
Opção 2: Encontrar uma Alternativa
- Pesquise plugins alternativos que forneçam a mesma funcionalidade
- Teste as alternativas em seu site de testes
- Migre configurações se trocar de plugins
Opção 3: Contatar o Desenvolvedor do Plugin
- Informe o conflito ao desenvolvedor do plugin
- 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:
- Contate um desenvolvedor WordPress para criar uma correção personalizada
- Considere hooks específicos do plugin para desativar funcionalidades conflitantes
- 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
Conflitos de Plugins Conhecidos
Os plugins abaixo são conhecidos por interferir com o WCPOS. Muitos problemas já foram corrigidos automaticamente em versões recentes do WCPOS — atualizar para a versão mais recente resolve esses problemas sem qualquer configuração.
O denominador comum: o WCPOS depende da WooCommerce REST API e renderiza alguns fluxos (login, pagamento, recibos) em iframes. A correção habitual é excluir os endpoints/URLs do POS (/wp-json/wcpos/, /wp-json/wc/v3/ e o caminho /pos/) do outro plugin — e não desativá-lo por completo.
Plugins de segurança e login
Estes são a fonte mais comum de conflitos, especialmente para o login do aplicativo desktop/móvel.
| Plugin | Sintoma | Correção |
|---|---|---|
| Wordfence | O firewall bloqueia a REST API; o campo de código 2FA não renderiza no iframe de login; uma CSP restritiva pode bloquear os recursos do POS | Adicione /wp-json/wcpos/ e /wp-json/wc/v3/ à lista de permissões do firewall. Para 2FA: desative-o temporariamente para usuários do POS. A CSP é removida automaticamente na v1.9.0+ |
| Really Simple Security | Bloqueia o acesso à API / força redirecionamentos | Desative quaisquer restrições da REST API nas configurações Advanced do plugin |
| WPS Hide Login | A URL de login personalizada quebra o iframe de login do aplicativo | Use a URL de login padrão /wp-admin/ para acesso ao POS |
| iThemes / Solid Security | Bloqueia a REST API ou aciona bloqueios por força bruta a partir das chamadas do POS | Adicione à lista de permissões apenas os endpoints do POS e o próprio IP do servidor — evite regras de IP abrangentes |
| Sucuri | O WAF bloqueia solicitações da API | Adicione os endpoints da REST API à lista de permissões no painel do Sucuri |
| Security Optimizer | Bloqueia o login do POS no admin ("use customize login URL") | Faça login no WP Admin pela URL personalizada primeiro e depois acesse /pos |
| Force Login (e plugins de autenticação REST similares) | /wp-json/ retorna 401/403; aplicativos mais antigos relatavam "Site does not seem to be a WordPress site" | Permita acesso não autenticado aos endpoints do POS ou desative durante a conexão inicial. Os aplicativos da v1.x agora exibem a mensagem de erro real |
| LoginPress | Força login baseado em e-mail; quebra o login multiusuário do POS | Permita login por nome de usuário ou desative para acesso ao POS |
| JWT Authentication plugins | 403 em todas as solicitações da API do POS após a ativação (o login pode ter sucesso, todo o resto falha) | Corrigido automaticamente na v1.8.x+. Em versões mais antigas, desative o plugin JWT ou exclua os endpoints do POS |
| Captcha / reCAPTCHA | Loop de login no aplicativo desktop (o captcha não consegue renderizar no iframe) | Desative o captcha para a URL de login do POS |
| Defender Pro | O cabeçalho X-Frame-Options bloqueia todos os iframes do POS (login, pagamento, recibos) | Adicione uma exceção específica para o POS em /pos/ em vez de desativar o X-Frame-Options em todo o site |
| Jetpack CRM Client Portal | Quebra completamente o login do POS | Desative apenas a extensão Client Portal |
Plugins de desempenho, cache e otimização
| Plugin | Sintoma | Correção |
|---|---|---|
| WP Rocket, Autoptimize, Hummingbird, Smush | Adiar/minificar JS quebra o checkout e o Stripe Terminal | Exclua as URLs /pos/ da otimização de JS |
| LiteSpeed Cache | Loop constante de recarregamento no checkout no aplicativo desktop; CSP restritiva | Atualize o WCPOS, limpe o cache, exclua as páginas do POS do cache. A CSP é removida automaticamente na v1.9.0+ |
| Image Prioritizer | Sobrecarrega o cabeçalho HTTP Link, quebrando a descoberta da REST API; o aplicativo desktop mostra "does not appear to be a WordPress site" | Desative o plugin |
Construtores de páginas e injetores de front-end
| Plugin | Sintoma | Correção |
|---|---|---|
| Elementor | elementor-frontend.js quebra o acordeão do checkout dentro do iframe do POS — os métodos de pagamento não expandem | Exclua as páginas do POS do carregamento de scripts do Elementor |
| Omnisend / plugins de marketing | Injetam scripts no iframe do checkout, quebrando o layout e os pagamentos | Use as Checkout Settings do POS para desativar scripts não essenciais |
| MyStickyElements / Complianz | Injetam sobreposições (botões fixos, banners de cookies) no iframe do checkout | Configure-os para excluir as URLs /pos/ |
Extensões do WooCommerce e outros plugins
| Plugin | Sintoma | Correção |
|---|---|---|
| WooCommerce Subscriptions | Conflito de script de migração durante a atualização da v1.7→v1.8 | Desative o Subscriptions, ative o POS Pro (deixe a migração rodar) e depois reative |
| WP Activity Log | Registra todas as ações do POS → inchaço de postmeta → "only 10 products" | Desative-o ou exclua os tipos de post do POS do registro |
Jetpack / Astra / Xero (qualquer um que use o hook save_post) | Linhas de meta duplicadas em cada chamada da API do POS (uma loja atingiu 36.867 linhas em um produto) | Corrigido automaticamente na v1.8.12+ (gratuito) / v1.8.14+ (Pro) com uma migração de limpeza — basta atualizar |
| Stripe Tax | Incompatível com pedidos criados via REST API (como o POS cria pedidos) | Sem solução — incompatível |
| Mollie | Pode ocultar o método BACS (transferência bancária) do checkout do POS | Atualize o Mollie para a versão mais recente |
| CTX Feed | Erros 403 intermitentes na página de configurações do POS | Desative para confirmar; sem solução conhecida |
| Plugins de leitor de código de barras de terceiros | Corrompem o JSON da API de pedidos, quebrando a criação/exibição de pedidos | Desative-os; use o escaneamento de código de barras integrado do POS |
| MailerLite (Signup Forms + WooCommerce) | Erro 500 na criação de pedidos do POS (esgotamento de memória) | Desative para confirmar e depois entre em contato com o MailerLite |
| The Courier Guy Shipping | A criação de pedidos do POS falha com um erro de servidor | Reverta para uma versão anterior ou entre em contato com o desenvolvedor |
| PixelYourSite / PixelMySite | Erro fatal: call to member function is_type() on bool | Desative temporariamente |
| Google Listings & Ads | Conflito de autoloader → erro crítico "Class WCPOS\…\Stores not found" | Exclua todos os plugins do POS e reinstale apenas o Pro standalone mais recente |
O gateway Stripe Terminal deve ser habilitado apenas dentro das Configurações do POS, nunca em WooCommerce > Settings > Payments. Habilitá-lo globalmente faz com que ele apareça no checkout da sua loja pública e quebra o fluxo de checkout online.
Conflitos a nível de servidor
| Origem | Sintoma | Correção |
|---|---|---|
Cabeçalhos CSP personalizados (.htaccess, Nginx ou um plugin de segurança) | O POS fica preso no logo; JS/CSS bloqueados | Removidos automaticamente nas páginas do POS na v1.9.0+. Para CSP a nível de servidor, permita cdn.jsdelivr.net em script-src/style-src ou adicione uma exceção para /pos/ |
| GoDaddy Website Firewall | Bloqueia /wp-json/ ("Received 'undefined'") | Permita o caminho de URL /wp-json/ no firewall — veja Desempenho do Servidor |
Dicas de Prevenção
Manutenção Regular
- Mantenha os plugins atualizados - Sempre use as versões mais recentes
- Remova plugins não utilizados - Não apenas desative, exclua-os
- Teste atualizações no staging antes de aplicar no site ao vivo
- Monitore o desempenho regularmente usando métricas de Desempenho do Servidor
Melhores Práticas de Seleção de Plugins
- Escolha desenvolvedores respeitáveis - Verifique avaliações e frequência de atualização
- Evite funcionalidade redundante - Não instale vários plugins que fazem a mesma coisa
- Leia informações de compatibilidade - Verifique se os plugins foram testados com o WooCommerce
- 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
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:
- Lista de plugins ativos com versões
- Versões do WordPress e WooCommerce
- Descrição detalhada do problema
- Etapas que você já tentou
- Mensagens de erro dos logs
- Métricas de desempenho do servidor se relevante