Adição de propriedades de contato para o complemento do HubSpot

Visão geral

Gostaria de incluir propriedades adicionais na seção de campo personalizado ao personalizar o complemento da HubSpot? Nosso complemento do HubSpot permite que você inclua campos de formulário adicionais que serão mapeados para campos em sua conta da HubSpot. No entanto, você pode estender esse recurso para incluir mais propriedades de campo não suportadas atualmente pelo complemento principal.

Este guia abordará as etapas para adicionar o snippet ao seu site WordPress.


Adicionando o snippet

Para começar, você precisará adicionar o snippet abaixo ao seu site. Se você não tiver certeza de como ou onde adicionar snippets, consulte 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 atualizando a API da HubSpot para incluir o conversioninformation detalhes como uma opção ao definir campos personalizados com o Complemento do HubSpot.

Visualização de novas propriedades

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

Para confirmar suas configurações, crie um novo formulário ou edite um existente para acessar o construtor de formulários. No construtor de formulários, navegue até Marketing " HubSpot e selecione o menu suspenso Nome do campo personalizado.

Seção de campo personalizado do complemento do HubSpot

Você verá todos os campos da propriedade que adicionou listados no menu suspenso.

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

Para saber mais sobre o complemento da HubSpot, consulte nosso guia detalhado sobre como instalar e usar o complemento da HubSpot no WPForms.

Perguntas frequentes

Abaixo, respondemos a algumas das principais perguntas sobre a extensão das propriedades de contato ao usar o complemento da HubSpot com o WPForms.

Posso permitir várias propriedades?

Você pode modificar o snippet para incluir propriedades adicionais. Aqui está o snippet para fazer 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 atualizando a API para incluir tanto o conversioninformation e analyticsinformation propriedades.

Posso incluir todas as propriedades de contato do HubSpot?

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

add_filter( 'wpforms_hubspot_api_allow_property', '__return_true' );

É isso aí! Agora você aprendeu a personalizar o complemento do HubSpot para incluir propriedades adicionais de contato.

Em seguida, você gostaria de acessar o URL dos arquivos carregados por meio do campo File Upload? Não deixe de conferir nosso tutorial para saber como.

Referência do filtro: wpforms_hubspot_api_allow_property