Todas as configurações do plugin ficam em WooCommerce → Configurações → Produtos → Simulador de frete. Esta é a referência completa de cada opção.
Template
Define o visual do simulador. Quatro opções:
- Padrão — minimalista, deixa o tema mandar no estilo.
- Minimalista — ainda mais compacto.
- Com ícone - Caminhão — destaque visual com ícone de entrega.
- Collapsed - exibir após clique — oculto por padrão, expande ao clicar.
Detalhes visuais e quando usar cada um em /article/templates.
A maioria das opções abaixo se aplica ao template Padrão. Os outros têm visual fechado e ignoram alguns campos.
Exibição do simulador
Onde, na página do produto, o simulador é renderizado:
- Junto dos dados do produto — abaixo do título e preço, dentro do summary.
- Antes do botão comprar.
- Depois do botão comprar.
- Antes do formulário de adicionar ao carrinho.
- Depois do formulário de adicionar ao carrinho.
- Junto do SKU, botões de compartilhar (padrão).
- Outro local — desativa o posicionamento automático. Use shortcode
[wc_simulador_frete]ou PHP.
Detalhes em /article/onde-o-simulador-aparece.
Prioridade
Número que define a ordem do simulador em relação a outros elementos do mesmo hook. Padrão: 10. Quanto menor, mais cedo aparece.
Útil quando você quer o simulador antes ou depois de algum elemento do tema/outro plugin que esteja no mesmo ponto.
Autocompletar endereço
Quando ativado, abaixo dos métodos de envio aparece o endereço completo (rua, bairro, cidade/estado) que foi encontrado pelo CEP. Útil pro cliente conferir se digitou certo.
A consulta usa ViaCEP por padrão, com fallback pra BrasilAPI.
Sempre visível
Em produtos variáveis, o simulador fica oculto até o cliente escolher uma variação. É o comportamento certo quando cada variação tem peso/dimensão diferente.
Ative essa opção pra mostrar sempre, mesmo sem variação selecionada. Use só se as variações compartilham peso e dimensões (ex: variação só de cor).
Se as variações têm pesos diferentes e você liga Sempre visível, o cálculo inicial usa o peso do produto principal. Pode ficar incorreto.
Título
O texto que aparece acima do formulário do simulador.
Padrão: Calcule o prazo e valor do frete deste produto.
Texto do botão
Texto do botão de calcular. Padrão: Calcular frete.
Cada template tem um padrão próprio de título e botão. Se você não personalizou e mudar o template, esses campos são atualizados automaticamente pra refletir o novo padrão.
Habilitar máscara
Ativa a máscara 00000-000 no campo de CEP enquanto o cliente digita. Requer jQuery — habilitado por padrão em qualquer site WordPress moderno.
Atualizar endereço no carrinho
Quando o cliente faz uma simulação bem-sucedida, salva o CEP e endereço no carrinho/checkout. Útil quando você tem regras de desconto ou frete que dependem da localização (frete grátis acima de X reais para certo estado, por exemplo).
Sem essa opção, o simulador é puramente informativo — não toca no carrinho do cliente.
Habilitar debug
Salva logs detalhados de cada simulação em WooCommerce → Status → Logs, no arquivo que começa com wc_simulador_frete. Use só pra investigar problemas.
Como ler o log: /article/como-ativar-debug.
Mantenha desligado em produção quando tudo está funcionando. Logs ocupam espaço e não trazem benefício se ninguém vai ler.
Container do produto
Seletor CSS da div que envolve o resumo do produto. Padrão: .entry-summary.
Esse seletor é usado pelo JavaScript pra encontrar quantidade, variação selecionada e preço do produto antes de simular. Em temas customizados (especialmente os feitos com construtor), pode ser necessário ajustar.
Mude esse valor só se algum cálculo está falhando e o suporte orientou. O default funciona em 95% dos temas.
Sintomas de seletor errado: o simulador aparece mas o preço não muda quando o cliente troca de variação ou aumenta a quantidade. Veja /article/problemas-comuns.
Carregamento de scripts
Por padrão, o JavaScript do simulador carrega só na página do produto — performance melhor.
Ative essa opção se você usa o simulador em outro lugar via shortcode ou PHP (popup, quick-view, página customizada). Sem isso, o simulador renderiza mas não funciona.
Equivalente em código:
add_filter( 'wc_simulador_frete_load_scripts', '__return_true' );
Mais detalhes em /article/carregar-scripts-em-todas-as-paginas.