simpay_recurring_description_format

Tipo: Filtro | Desde: 4.17.1

Descrição

O filtro simpay_recurring_description_format permite que você substitua programaticamente a chave de formato da descrição da parcela usada para um formulário de pagamento específico. Este filtro é executado após as configurações globais e por formulário terem sido resolvidas, dando a você controle final sobre qual formato é aplicado.

Argumentos

1. $format_key (string) — A chave de formato resolvida. Uma das seguintes opções:
   • count_adj_amount — “12 parcelas mensais de R$24” (padrão)
   • amount_per — “R$24 por mês para 12 pagamentos”
   • amount_every — “R$24 a cada mês, 12 pagamentos no total”
2. $form_id (int) — O ID do post do formulário de pagamento. 0 se nenhum contexto de formulário estiver disponível.

Exemplo

O exemplo a seguir força um formulário específico (ID 150) a usar sempre o formato “valor por intervalo”, independentemente da configuração global ou por formulário:

add_filter( 'simpay_recurring_description_format', function ( $format_key, $form_id ) {
    if ( 150 === $form_id ) {
        return 'amount_per';
    }

    return $format_key;
}, 10, 2 );

Você pode adicionar este código com segurança usando o plugin WPCode. Sempre teste o código personalizado em um site de staging antes de implantá-lo em produção.

Registro de alterações

Relacionados

• Como Personalizar Formatos de Descrição de Parcelas – Configure formatos através da interface de administração
• Planos de Parcelamento – Configure planos de pagamento parcelado
• Adicionando Código Personalizado – Como adicionar código PHP personalizado ao seu site