Como passar o valor do campo Quantidade para os provedores de API

Introdução

Gostaria de aceder ao valor de um campo de pagamento com a quantidade activada num serviço de integração de terceiros? Com um snippet de código personalizado, pode tornar as Smart Tags utilizáveis com o Hidden Field. Em seguida, adicione o valor do campo de pagamento ao Hidden Field utilizando Smart Tags.

Neste tutorial, vamos guiá-lo através dos passos para adicionar este snippet ao seu site e mostrar-lhe como utilizar a Smart Tag nos seus formulários.

Criar um formulário de pagamento

Primeiro, tem de criar um novo formulário ou editar um já existente para aceder ao criador de formulários. No criador de formulários, certifique-se de que adiciona o Campo oculto ao formulário.

Adicionar o snippet

Depois de criar o formulário de pagamento e ativar a seleção da quantidade, adicione o snippet abaixo ao seu site. Se precisar de ajuda para adicionar snippets no WordPress, não deixe de consultar 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 fará com que as Smart Tags do WPForms possam ser usadas com o Hidden Field. Não se esqueça de substituir $form_id com o ID do formulário específico que pretende utilizar. Além disso, substitua o $hidden_field_id com o ID do campo oculto no seu formulário.

Utilizar as etiquetas inteligentes com o campo oculto

Depois de adicionar o snippet ao seu site, volte ao construtor de formulários e selecione o Campo oculto para abrir o painel Opções de campo. Em seguida, navegue até ao separador Avançadas.

Depois disso, pode utilizar qualquer uma das seguintes etiquetas inteligentes como valor predefinido para o campo:

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

Não se esqueça de substituir # na Smart Tag com o ID do campo de pagamento no seu formulário com a seleção de quantidade activada.

Mapeamento do campo oculto para integrações de marketing

Depois de definir o valor predefinido para o Campo oculto, poderá mapeá-lo como um campo personalizado quando utilizar qualquer uma das nossas integrações de marketing.

Uma vez concluído, o valor do seu campo de pagamento estará acessível no painel de controlo da conta da integração de marketing. Incluirá o valor do pagamento e a quantidade selecionada pelo utilizador.

É isso aí! Agora você sabe como passar o valor do campo Quantidade para os provedores de API no WPForms.

Você também gostaria de aprender como criar suas próprias Smart Tags personalizadas no WPForms? Confira nosso tutorial sobre Como criar uma tag inteligente personalizada para obter mais detalhes.

Relacionadas

Referências de filtros:

• wpforms_process_filter