Atenção!

Este artigo contém código PHP e destina-se a programadores. Oferecemos este código como cortesia, mas não prestamos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação adicional, consulte o tutorial da WPBeginner sobre como adicionar código personalizado.

Ignorar

Adicionar Propriedades de Contacto para o Addon HubSpot

Visão geral

Gostaria de incluir propriedades adicionais na secção de campos personalizados ao personalizar o addon HubSpot? O nosso addon HubSpot permite-lhe incluir campos de formulário adicionais que serão mapeados para campos na sua conta HubSpot. No entanto, pode estender esta funcionalidade para incluir mais propriedades de campo que não são atualmente suportadas pelo addon principal.

Este guia irá cobrir os passos para adicionar o snippet ao seu site WordPress.


Adicionar o Trecho

Para começar, terá de adicionar o snippet abaixo ao seu site. Se não tem a certeza como ou onde adicionar snippets, por favor reveja esta documentação útil.

/**
  * Filter whether a specific HubSpot property should be allowed.
  *
  * @link https://wpforms.com/developers/adding-contact-properties-for-hubspot-addon/
  * @since {VERSION}
  *
  * @param bool   $allowed  Whether the property is allowed. Default false.
  * @param mixed  $property The HubSpot property being checked.
  *
  * @return bool True to allow the property, false to disallow.
*/

function wpf_hubspot_add_property( $allow, array $property ) {

	return $property['groupName'] === 'conversioninformation' ? true : $allow;

}

add_filter( 'wpforms_hubspot_api_allow_property', 'wpf_hubspot_add_property', 10, 2 );

No código acima, estamos a atualizar a API do HubSpot para incluir os detalhes de conversioninformation como uma opção ao definir campos personalizados com o addon HubSpot.

Visualizar Novas Propriedades

Após o snippet ser adicionado, a nova propriedade será adicionada à lista de campos disponíveis ao personalizar campos personalizados na página de integração HubSpot.

Para confirmar as suas definições, crie um novo formulário ou edite um existente para aceder ao construtor de formulários. No construtor de formulários, navegue para Marketing » HubSpot e selecione o menu suspenso Nome do Campo Personalizado.

Secção de campo personalizado do addon HubSpot

Verá todos os campos sob a propriedade que adicionou listados no menu suspenso.

Secção de informações de conversão

Para saber mais sobre o addon HubSpot, certifique-se de consultar o nosso guia detalhado sobre instalar e usar o addon HubSpot no WPForms.

Perguntas Frequentes

Abaixo, respondemos a algumas das principais questões sobre a extensão de propriedades de contacto ao usar o addon HubSpot com o WPForms.

Posso permitir múltiplas propriedades?

Pode modificar o snippet para incluir propriedades adicionais. Aqui está o snippet para conseguir isso:

function wpf_hubspot_add_multiple_properties( $allow, array $property ) {

	return in_array( $property['groupName'], [ 'conversioninformation', 'analyticsinformation' ], true ) ? true : $allow;

}

add_filter('wpforms_hubspot_api_allow_property', 'wpf_hubspot_add_multiple_properties', 10, 2);

No snippet acima, estamos a atualizar a API para incluir as propriedades conversioninformation e analyticsinformation.

Posso incluir todas as propriedades de contacto do HubSpot?

Sim, pode incluir todas as propriedades de contacto adicionais da sua conta HubSpot no WPForms. Para o fazer, basta adicionar o snippet abaixo ao seu site:

add_filter( 'wpforms_hubspot_api_allow_property', '__return_true' );

É tudo! Agora aprendeu como personalizar o addon HubSpot para incluir propriedades de contacto adicionais.

Em seguida, gostaria de aceder ao URL para ficheiros carregados através do campo de Carregamento de Ficheiros? Certifique-se de consultar o nosso tutorial para aprender como.

Referência de Filtro: wpforms_hubspot_api_allow_property