Quando o plugin Simulador de Parcelas está instalado e ativo, o WC Boleto Parcelado ganha duas opções extras na tela de configuração que ligam o cálculo dos planos ao Simulador.
Pré-requisitos
- Plugin Simulador de Parcelas instalado e ativo (v1.x ou v2.x).
Sem o Simulador instalado, os campos abaixo não aparecem no admin.
Ativando
Em WooCommerce > Configurações > Pagamentos > Boleto Parcelado:
| Campo | Função |
|---|---|
| Integração com Simulador de parcelas. | Marque pra usar os planos do Simulador no lugar da tabela manual. |
| Formatação do texto | Template de texto exibido pra cada plano no checkout. Suporta variáveis. |
Salve as alterações.
Variáveis do template
Use no campo Formatação do texto:
| Variável | O que substitui |
|---|---|
{{ parcelas }} |
Número de parcelas do plano (ex.: 6). |
{{ valor }} |
Valor de cada parcela já formatado (ex.: R$ 100,00). |
{{ total }} |
Total com juros já formatado (ex.: R$ 600,00). |
{{ juros }} |
Rótulo de juros vindo do Simulador (ex.: Sem juros, Com juros). |
Exemplos de formatação
{{ parcelas }}x de {{ valor }}. Total: {{ total }}
→ 6x de R$ 100,00. Total: R$ 600,00
{{ parcelas }}x de {{ valor }} {{ juros }}
→ 6x de R$ 100,00 Sem juros
{{ parcelas }} parcelas de {{ valor }} | Total: {{ total }}
→ 12 parcelas de R$ 25,00 | Total: R$ 300,00
O que muda no checkout
- A tabela manual Opções de parcelamento deixa de ser usada — os planos são gerados pelo Simulador a cada renderização.
- As regras de juros e número máximo de parcelas vêm das configurações do Simulador.
- Parcelas abaixo do valor mínimo de parcela definido no Simulador não aparecem.
- Períodos sem juros configurados no Simulador são respeitados (parcelas iniciais sem juros, restantes com).
Com a integração ativa, os planos da aba Opções de parcelamento são ignorados. Pra voltar a usar planos manuais, desmarque Integração com Simulador de parcelas.
Visibilidade do método
Com a integração ativa, o filtro padrão de visibilidade (woocommerce_wc_ticket_installments_is_disabled) é forçado em false — ou seja, o método aparece sempre no checkout enquanto o gateway estiver ativo, ignorando a regra de subtotal mínimo dos planos manuais.
Compatibilidade
- Simulador v1.x (clássico): integração via
WC_Simulador_Parcelas_Calculate_ValueseWCSP_Apply_Rules. - Simulador v2.x (moderno): integração via
\WC_Installments_Simulator\Math\DiscountseInstallments::get_calculate_installments.
A detecção de versão é automática — você só precisa marcar Integração com Simulador de parcelas.
Customizando os settings do Simulador
Devs podem sobrescrever os settings carregados do Simulador (somente v2) com o filtro wc_ticket_gateway_installments_simulator_settings:
add_filter( 'wc_ticket_gateway_installments_simulator_settings', function( $settings ) {
$settings['max_installments'] = 10;
return $settings;
});
Veja a referência completa em Filtros.