# 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[​](#signs-of-plugin-conflicts "Link direto para 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[​](#before-you-start-use-a-staging-site "Link direto para 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?[​](#what-is-a-staging-site "Link direto para 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[​](#if-your-host-doesnt-offer-staging "Link direto para 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[​](#step-1-check-for-fatal-errors "Link direto para 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](/pt-BR/support/logs.md) no WCPOS para quaisquer mensagens de erro 2. **Verifique os Logs de Erros Fatais** - Siga o [guia de resolução de erros críticos](/pt-BR/support/troubleshooting/critical-error.md) 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[​](#step-2-the-plugin-elimination-method "Link direto para 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[​](#21-create-a-baseline "Link direto para 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](/pt-BR/support/logs.md) ### 2.2 Desative Todos os Plugins (Exceto os Essenciais)[​](#22-disable-all-plugins-except-essential-ones "Link direto para 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:** 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[​](#23-test-the-issue "Link direto para 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](/pt-BR/support/performance/server.md)) * Conflitos de tema (veja a Etapa 3) * Problemas no núcleo do WordPress/WooCommerce ### 2.4 Ative os Plugins Um a Um[​](#24-enable-plugins-one-by-one "Link direto para 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[​](#25-document-your-findings "Link direto para 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[​](#step-3-check-for-theme-conflicts "Link direto para 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[​](#test-with-a-default-theme "Link direto para 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[​](#step-4-resolving-plugin-conflicts "Link direto para 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[​](#option-1-update-the-plugin "Link direto para 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[​](#option-2-find-an-alternative "Link direto para 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[​](#option-3-contact-plugin-developer "Link direto para 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[​](#option-4-custom-solution "Link direto para 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[​](#common-conflicting-plugin-types "Link direto para Tipos Comuns de Plugins em Conflito") ### Categorias de Plugins de Alto Risco[​](#high-risk-plugin-categories "Link direto para 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[​](#lower-risk-plugin-categories "Link direto para 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[​](#known-plugin-conflicts "Link direto para 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. A maioria das correções é "excluir o POS" 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[​](#security-and-login-plugins "Link direto para 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[​](#performance-caching-optimisation-plugins "Link direto para 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[​](#page-builders-front-end-injectors "Link direto para 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[​](#woocommerce-extensions-other-plugins "Link direto para 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 | Stripe Terminal: não o habilite globalmente 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[​](#server-level-conflicts "Link direto para 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](/pt-BR/support/performance/server.md#hosting-specific-notes) | ## Dicas de Prevenção[​](#prevention-tips "Link direto para Dicas de Prevenção") ### Manutenção Regular[​](#regular-maintenance "Link direto para 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](/pt-BR/support/performance/server.md) ### Melhores Práticas de Seleção de Plugins[​](#plugin-selection-best-practices "Link direto para 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[​](#getting-help "Link direto para Obtendo Ajuda") Se você não conseguir resolver o conflito de plugins: ### Para Usuários Pro[​](#for-pro-users "Link direto para 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[​](#community-support "Link direto para Suporte da Comunidade") [Discord Community](https://wcpos.com/discord) ### Ao Contatar o Suporte[​](#when-contacting-support "Link direto para 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 ## Documentação Relacionada[​](#related-documentation "Link direto para Documentação Relacionada") [Erro CríticoComo encontrar logs de erro fatal](/pt-BR/support/troubleshooting/critical-error.md) [LogsCompreendendo logs e métricas do WCPOS](/pt-BR/support/logs.md) [Desempenho do ServidorDiagnosticando problemas de desempenho](/pt-BR/support/performance/server.md) [Desempenho do CheckoutOtimização da velocidade de checkout](/pt-BR/support/performance/checkout.md)