Problemas comuns

Lista dos problemas mais frequentes durante a configuração e operação do Checkout Rishi, com solução direta.

Layout total ou parcialmente quebrado

A causa mais comum: a página de checkout tem conteúdo extra de algum page builder ou plugin.

1. Vá em Páginas no admin.
2. Encontre a página de finalização de compra (Checkout).
3. Clique em Editar (precisa ser apenas Editar, não Editar com Elementor).
4. Se ela está construída com Elementor, clique em Voltar ao Editor do WordPress.
5. Deixe apenas o seguinte conteúdo na página:

[woocommerce_checkout]

6. Salve.

Esse passo limpa qualquer interferência de page builder.

Tema Woodmart

O Woodmart adiciona layouts próprios para o checkout que conflitam com o Checkout Rishi.

1. No admin, vá em Layouts.
2. Desative ou exclua todos os layouts relacionados ao checkout.
3. Limpe o cache: WooCommerce → Status → Ferramentas → cache de templates.

Se o problema persistir

Limpe também o cache de objetos (Redis, Memcached, plugin de Object Cache) e o cache de página (W3 Total Cache, WP Rocket, etc.).

Layout quebrado em método de pagamento específico

Quando um gateway usa nomes de classes CSS não-padrão, o layout dele pode aparecer estranho.

Solicite a correção via ticket de suporte com:

• Nome e versão do gateway.
• Print do layout quebrado.
• Link de uma página de teste se possível.

Templates com divs estranhas

Se aparece código HTML solto ou estrutura repetida no checkout:

Se mesmo após limpar continuar:

1. Instale o plugin Code Snippets.
2. Crie um snippet com o seguinte código:

add_action( 'woocommerce_after_template_part', function() {
  if ( function_exists( 'is_checkout' ) && is_checkout() ) {
    $q = new \WC_Logger();
    $q->add( 'debug-templates', print_r( func_get_args(), true ) );
  }
}, 100, 5 );

3. Acesse o checkout para gerar logs.
4. Desative o Checkout Rishi (ele não está funcionando como esperado).
5. Acesse WooCommerce → Status → Logs → debug-templates e baixe o arquivo mais recente.
6. Envie o log para o suporte.

Cores do layout não são alteradas

Causado por temas que sobrescrevem com !important.

Solução: em WooCommerce → Configurações → Pagamento → Checkout Inteligente → Avançado, ative Carregamento do editor. Isso eleva a especificidade dos estilos.

E-mail de login mágico não chega

1. Confirme que outros e-mails do site são entregues — se nem confirmação de pedido chega, é problema de SMTP geral.
2. Instale WP Mail Logging e veja se o e-mail está sendo gerado.
3. Se está sendo gerado mas não chega, configure SMTP autenticado (Amazon SES, SendGrid, Mailgun, ou plugin como WP Mail SMTP).
4. Verifique se o domínio do e-mail (SPF/DKIM/DMARC) está configurado.

Cliente não é redirecionado pelo link mágico

• Conta administradora? O link funciona em qualquer conta com cargo de cliente. Para conta admin, há uma confirmação extra.
• Plugin de dupla autenticação? Quando o cliente tem 2FA ativo, o link mágico não autentica.
• Cache da página? O sistema de cache precisa fazer bypass quando a URL contém magic_login. A maioria faz por padrão; se o seu não faz, configure.
• Plugin de redirecionamento? Algum snippet ou plugin pode estar forçando redirect após login. Procure por hooks wp_login.

Conflito com Elementor

Se você usa Elementor Pro com cabeçalhos customizados:

1. Em Customizer → Avançado, ative Carregar estilos do Elementor.
2. Limpe cache.
3. Teste em aba anônima.

Se ainda não funciona, desative o cabeçalho Elementor para a página de checkout (em Templates → Theme Builder → condições).

Mensagem "nenhum método de entrega disponível"

• Áreas de entrega mal configuradas — em WooCommerce → Configurações → Entrega → Áreas de entrega, confirme que existe pelo menos uma área cobrindo o CEP do cliente.
• CEP inválido — peça para o cliente conferir o CEP.
• Plugin de frete fora do ar — gateways de frete (Correios, Kangu, SuperFrete) podem ter instabilidade. Tente outro CEP de teste.

Quando abrir ticket

Se nenhuma das soluções acima resolveu, abra ticket com:

• URL do site.
• Versão do plugin (em Plugins no admin).
• Versão do WooCommerce.
• Versão do tema.
• Print da tela com erro/problema.
• Console do navegador (F12 → Console) com possíveis erros.