Filtros

Referência completa dos filtros expostos pelo WC Boleto Parcelado. Todos aceitam callback via add_filter().

Filtros próprios do plugin

wc_ticket_installments_gateway_setting_fields

Permite alterar/adicionar campos na tela de configuração do gateway.

Argumentos: array $fields — definições dos campos do init_form_fields(). Retorna: array — campos modificados.

add_filter( 'wc_ticket_installments_gateway_setting_fields', function( $fields ) {
    $fields['title']['default'] = 'Boleto em até 12x';

    $fields['custom_note'] = [
        'title'   => 'Observação interna',
        'type'    => 'text',
        'default' => '',
    ];

    return $fields;
});

woocommerce_wc_ticket_installments_icon

URL ou HTML do ícone exibido ao lado do nome do método no checkout.

Argumentos: string $icon — vazio por padrão. Retorna: string — URL da imagem ou HTML.

add_filter( 'woocommerce_wc_ticket_installments_icon', function() {
    return '<img src="' . get_stylesheet_directory_uri() . '/assets/boleto.png" alt="Boleto" />';
});

woocommerce_wc_ticket_installments_is_disabled

Decide se o método deve ser ocultado no checkout.

Argumentos:

• bool $is_disabled — true se o subtotal está abaixo do menor mínimo configurado ou se nenhum plano está cadastrado.
• WC_Ticket_Installments_Gateway $gateway — instância do gateway.

Retorna: bool — true oculta, false mostra.

add_filter( 'woocommerce_wc_ticket_installments_is_disabled', function( $is_disabled, $gateway ) {
    if ( current_user_can( 'manage_woocommerce' ) ) {
        return false;
    }
    return $is_disabled;
}, 10, 2 );

woocommerce_wc_ticket_gateway_installments_available

Modifica a lista de planos exibida no checkout. É onde a integração com o Simulador injeta os planos calculados.

Argumentos:

• array $installments_available — array de ['value' => 'CODE', 'description' => 'texto'].
• array $options — wc_ticket_installments_available_options cru.
• float $cart_total — total do carrinho.
• WC_Ticket_Installments_Gateway $gateway — instância do gateway.

Retorna: array no mesmo formato.

add_filter( 'woocommerce_wc_ticket_gateway_installments_available', function( $available, $options, $total, $gateway ) {
    foreach ( $available as &$plan ) {
        $plan['description'] .= ' • Análise em até 1 dia útil';
    }
    return $available;
}, 10, 4 );

woocommerce_wc_ticket_gateway_use_css

Controla se o CSS inline padrão do template do checkout é injetado.

Argumentos: bool — true por padrão. Retorna: bool — false desabilita o CSS embutido.

add_filter( 'woocommerce_wc_ticket_gateway_use_css', '__return_false' );

Veja Personalizando aparência.

wc_ticket_gateway_installments_simulator_settings

Sobrescreve os settings vindos do Simulador de Parcelas v2.x antes do cálculo dos planos.

Argumentos: array $settings — wc_installments_simulator_settings(). Retorna: array modificado.

add_filter( 'wc_ticket_gateway_installments_simulator_settings', function( $settings ) {
    $settings['max_installments'] = 10;
    $settings['min_installment']  = 50;
    return $settings;
});

Hooks do WooCommerce usados internamente

O plugin se registra como handler nesses hooks padrão do WooCommerce. Você pode adicionar callbacks paralelos ou usar prioridades pra ajustar o comportamento.

Pra customizar a visibilidade do método, prefira woocommerce_wc_ticket_installments_is_disabled (acima) ao woocommerce_available_payment_gateways cru.