Solução de problemas

Os problemas mais comuns do plugin caem em uns poucos padrões. Use esta página como checklist antes de abrir um chamado.

O parcelamento não aparece

Verifique nesta ordem:

1. Máximo de parcelas está maior que 1?
2. Parcelamento na página interna do produto ou na listagem está com alguma opção marcada (não está em "Não exibir")?
3. Parcela mínima não está alta demais? Ex: produto de R$ 30 com mínima de R$ 30 → só 1x cabe.
4. Ocultar parcelamento em 1x está marcado e o produto só comporta 1x? Aí está fazendo o que você pediu.
5. O produto tem preço maior que 0 e não está sendo visto pelo admin (o plugin oculta no admin).

O preço cheio aparece mesmo com desconto configurado

Verifique:

1. Desconto no preço principal está com porcentagem maior que 0.
2. Se o produto está em promoção, confirme o que está em Mostrar preço original — o que parece "preço cheio" pode ser o riscado ao lado do preço com desconto.
3. Sempre exibir preço à vista está marcado? Se não, e o desconto é 0%, o bloco à vista some.
4. O filtro wcsp_is_available está retornando false pra esse produto? Veja Ocultar em produtos específicos.

O desconto não é aplicado no checkout

Mesmo que apareça na vitrine, o desconto só é cobrado quando você configura os métodos:

1. Método com desconto tem pelo menos um gateway selecionado.
2. O cliente está escolhendo um desses gateways no checkout.
3. Desconto no preço principal é maior que 0.
4. Você não está testando com o admin do site. Faça checkout em uma janela anônima.

Exibição incorreta em temas Elementor

Em alguns temas (especialmente comerciais com layouts próprios baseados em Elementor), o plugin pode aplicar a configuração errada — usando a configuração de Listagem na página do produto, ou vice-versa.

Caso 1: produto único parecendo listagem

Sintoma: na página do produto não aparece o botão de tabela completa (ou ele aparece pequeno como na listagem).

Solução: adicione o shortcode [wcsp_open_single_product] ANTES do bloco onde o preço aparece (no Elementor, num widget de "Texto/HTML" colocado acima do widget de preço).

Caso 2: listagem parecendo produto único

Sintoma: na seção de produtos relacionados (ou recentes, upsells, cross-sells), aparece a tabela completa expansível como se fosse a página do produto.

Solução: adicione o shortcode [wcsp_close_single_product] ANTES do bloco da listagem.

Os dois ao mesmo tempo

Quando os dois problemas acontecem na mesma página (acontece em alguns temas), use os dois shortcodes nos lugares certos. O [wcsp_open_single_product] abre o "modo produto" e o [wcsp_close_single_product] volta pro "modo listagem".

O JavaScript não está funcionando

A tabela completa expansível usa JavaScript pra abrir e fechar. Se ela não abre:

1. Abra o console do navegador (F12) e verifique erros.
2. Confira se o jQuery está carregado.
3. O filtro wcsp_script pode estar desativando o script — veja Referência de hooks.
4. Algum cache de plugin agressivo (LiteSpeed, WP Rocket) pode estar omitindo o script. Limpe o cache.

O CSS não está sendo aplicado

1. O filtro wcsp_style está retornando false ou um caminho inválido?
2. Cache de CSS combinado pode estar desatualizado. Limpe o cache.
3. O tema pode estar com seletores muito específicos que sobrescrevem. Use as variáveis CSS --wcsp-* para customizar — veja Aparência.

A integração com Rank Math não está atualizando o schema

1. Confirme que o Rank Math está ativo e o produto tem o módulo Product Schema configurado.
2. Use a ferramenta Rich Results Test do Google na URL do produto.
3. Se o enable_schema foi desativado por código, o schema fica intacto (não é injetado).

Próximos passos

• Compatibilidade com outros plugins
• Referência de hooks (filtros e ações)
• Ocultar em produtos específicos