Como Passar o Valor do Campo de Quantidade para Provedores de API

Introdução

Gostaria de acessar o valor de um campo de pagamento com quantidade habilitada em um serviço de integração de terceiros? Com um trecho de código personalizado, você pode tornar as Smart Tags utilizáveis com o Campo Oculto. Em seguida, adicione o valor do campo de pagamento ao Campo Oculto usando Smart Tags.

Neste tutorial, vamos guiá-lo pelas etapas para adicionar este trecho ao seu site e mostrar como usar a Smart Tag em seus formulários.

Criando um Formulário de Pagamento

Primeiro, você precisará criar um novo formulário ou editar um existente para acessar o construtor de formulários. No construtor de formulários, certifique-se de adicionar o Campo Oculto ao seu formulário.

Adicionando o Snippet

Após criar o formulário de pagamento e habilitar a seleção de quantidade, prossiga para adicionar o trecho abaixo ao seu site. Se precisar de ajuda para adicionar trechos no WordPress,  certifique-se de revisar esta documentação útil.

/**
 * Make all Smart Tags workable for the Hidden field
 *
 * @link   https://wpforms.com/developers/how-to-pass-quantity-field-value-to-api-providers/
 */

add_filter( 'wpforms_process_filter', static function( $fields, $entry, $form_data ) {

	// payment form ID
	$form_id = 1334;

	// ID of a hidden field where you'll place a smart tag as the default value, e.g. {field_id="#"} or {field_html_id="#"}.
	$hidden_field_id = 4;

	if (
		empty( $form_data['id'] ) ||
		( (int) $form_data['id'] !== $form_id ) ||
		empty( $form_data['fields'][ $hidden_field_id ]['default_value'] )
	) {
		return $fields;
	}

	// Go magic!
	$fields[ $hidden_field_id ]['value'] = wpforms_process_smart_tags( $form_data['fields'][ $hidden_field_id ]['default_value'], $form_data, $fields );

	return $fields;

}, 10, 3 );

O trecho de código acima tornará as Smart Tags do WPForms utilizáveis com o Campo Oculto. Certifique-se de substituir $form_id pelo ID do formulário específico que você pretende usar. Além disso, substitua o valor $hidden_field_id pelo ID do Campo Oculto em seu formulário.

Usando Smart Tags com Campo Oculto

Após adicionar o trecho ao seu site, retorne ao construtor de formulários e selecione o Campo Oculto para abrir seu painel de Opções de Campo. Em seguida, navegue até a guia Avançado.

Depois disso, você pode usar qualquer uma das seguintes Smart Tags como valor padrão para o campo:

• {field_html_id="#"} retorna o valor formatado em HTML (preço x quantidade)
• {field_id="#|quantity"} retorna apenas o valor da quantidade

Certifique-se de substituir # na Smart Tag pelo ID do campo de pagamento em seu formulário com a seleção de quantidade habilitada.

Mapeando Campo Oculto para Integrações de Marketing

Após definir o valor padrão para o Campo Oculto, você poderá mapeá-lo como um campo personalizado ao usar qualquer uma de nossas integrações de marketing.

Uma vez feito isso, o valor do seu campo de pagamento estará acessível no painel de controle da conta da integração de marketing. Ele incluirá o valor do pagamento e a quantidade selecionada pelo usuário.

Pronto! Agora você sabe como passar o valor do campo de Quantidade para provedores de API no WPForms.

Gostaria também de aprender como criar suas próprias Smart Tags personalizadas no WPForms? Confira nosso tutorial sobre Como Criar uma Smart Tag Personalizada para mais detalhes.

Relacionado

Referências de Filtro:

• wpforms_processar_filtro