Actions

Referência das actions disparadas durante o ciclo de vida do WC Boleto Parcelado. Todas são hooks padrão do WooCommerce — o plugin se registra como handler e você pode adicionar callbacks paralelos via add_action().

woocommerce_update_options_payment_gateways_wc_ticket_installments

Disparada quando você salva as configurações do gateway no admin.

Quando rodar código aqui: quando você precisa reagir a mudanças nos settings (cache, log, sync com sistema externo).

add_action( 'woocommerce_update_options_payment_gateways_wc_ticket_installments', function() {
    error_log( 'Settings do Boleto Parcelado salvos.' );
});

woocommerce_thankyou_wc_ticket_installments

Disparada na página de obrigado somente se o método de pagamento do pedido foi Boleto Parcelado.

Argumentos: int $order_id.

add_action( 'woocommerce_thankyou_wc_ticket_installments', function( $order_id ) {
    $order = wc_get_order( $order_id );
    $code  = $order->get_meta( '_ticket_installments_code' );
    echo '<p>Próximo passo: aguarde o boleto chegar no seu e-mail.</p>';
});

woocommerce_email_before_order_table

Hook padrão do WooCommerce — disparado em todos os emails de pedido, antes da tabela de itens. O plugin usa pra incluir as Instruções quando o método é Boleto Parcelado e o pedido está com status on-hold.

Argumentos:

• WC_Order $order
• bool $sent_to_admin
• bool $plain_text

add_action( 'woocommerce_email_before_order_table', function( $order, $sent_to_admin, $plain_text ) {
    if ( $sent_to_admin || 'wc_ticket_installments' !== $order->get_payment_method() ) {
        return;
    }
    echo '<p><strong>Atenção:</strong> verifique seu spam pelo boleto.</p>';
}, 20, 3 );

woocommerce_checkout_update_order_meta

Hook padrão do WooCommerce — disparado quando o pedido é salvo no checkout. O plugin usa pra gravar _ticket_installments_code e _ticket_installments_description.

Argumentos: int $order_id.

add_action( 'woocommerce_checkout_update_order_meta', function( $order_id ) {
    $order = wc_get_order( $order_id );

    if ( 'wc_ticket_installments' !== $order->get_payment_method() ) {
        return;
    }

    $order->update_meta_data( '_meu_campo_extra', sanitize_text_field( $_POST['meu_campo_extra'] ?? '' ) );
    $order->save();
}, 20 );

Veja os metadados gravados em Acessando metadados do pedido.

woocommerce_checkout_process

Hook padrão do WooCommerce — disparado durante a validação do checkout. O plugin valida que o cliente selecionou um plano antes de prosseguir.

add_action( 'woocommerce_checkout_process', function() {
    if ( ( $_POST['payment_method'] ?? '' ) !== 'wc_ticket_installments' ) {
        return;
    }

    if ( ! current_user_can( 'read' ) ) {
        wc_add_notice( 'Apenas clientes logados podem usar boleto parcelado.', 'error' );
    }
});

woocommerce_admin_order_data_after_billing_address

Hook padrão do WooCommerce — disparado no admin do pedido, abaixo do endereço de cobrança. O plugin usa pra exibir o Método de pagamento com a descrição do plano selecionado.

Argumentos: WC_Order $order.

add_action( 'woocommerce_admin_order_data_after_billing_address', function( $order ) {
    if ( 'wc_ticket_installments' !== $order->get_payment_method() ) {
        return;
    }

    $code = $order->get_meta( '_ticket_installments_code' );
    echo '<p><strong>Código interno:</strong> ' . esc_html( $code ) . '</p>';
}, 20 );