A calculadora de frete padrão do WooCommerce mostra três campos no carrinho — País, Estado e CEP — e pede que o cliente clique em Calcular Frete pra ver o valor. Pra quem vende só pro Brasil, isso é fricção desnecessária: o cliente erra estado, digita CEP sem traço, espera, clica de novo. Muita gente desiste antes de ver o frete.
A Calculadora de Frete Otimizada corta esse ruído. O cliente vê um único campo: CEP. O plugin detecta o estado pelo próprio CEP, formata o campo enquanto digita e (opcionalmente) já calcula o frete sozinho assim que o CEP fica completo.
O que muda no carrinho
| Calculadora padrão | Com o plugin ativo |
|---|---|
| País + Estado + CEP | Só CEP |
| Cliente clica em Calcular Frete pra abrir o formulário | Formulário abre direto (opcional) |
| Cliente clica de novo pra calcular | Cálculo dispara sozinho ao terminar de digitar (opcional) |
| Estado dependente do que o cliente seleciona | Estado detectado pelo CEP automaticamente |
| CEP livre, qualquer formato | Máscara 00000-000 aplicada (opcional) |
Como o estado é detectado
O plugin tem mapeado as faixas de CEP de todas as 27 unidades federativas do Brasil, incluindo estados com múltiplas faixas (Amazonas, Goiás, Distrito Federal). Sem banco de dados, sem requisição externa: a detecção do estado é feita localmente, instantânea.
Para identificar a cidade, o plugin usa a API pública do ViaCEP — opcional, ligada por configuração. A consulta normalmente leva menos de 1 segundo.
O que o plugin liga e desliga
Cinco opções, todas independentes, todas em WooCommerce → Configurações → Entrega → Otimização da calculadora:
- Sempre visível — calculadora abre direto, sem clique.
- Mensagem de estimativa — esconde a frase padrão de estimativa do WooCommerce.
- Máscara de campo — formata o CEP enquanto digita.
- Identificar cidade automaticamente — preenche cidade via ViaCEP.
- Calcular automaticamente — dispara o cálculo ao detectar 8 dígitos válidos.
Cada opção tem um artigo dedicado:
- Sempre visível
- Cálculo automático
- Máscara de CEP
- Identificar cidade pelo CEP
- Ocultar estimativa de entrega
Se for a primeira instalação, ative só a Máscara de campo primeiro e veja o efeito. Depois ligue Calcular automaticamente e Sempre visível pra ter a experiência completa.
Compatibilidade
- WooCommerce: 3.5 até 9.8 (testado).
- WordPress: 4.4+ (6.4+ se quiser usar HPOS).
- HPOS (High-Performance Order Storage) declarado compatível.
- Mobile: com a máscara ativa, o teclado numérico do celular aparece automaticamente no campo de CEP.
- Plugins de máscara externa (TM Extra Product Options): há tratamento específico — o plugin reaplica a máscara quando o carrinho atualiza.
Próximo passo
Configure o plugin pela primeira vez — abre as opções no admin e mostra exatamente o que ligar.