Visão geral
Gostaria de incluir propriedades adicionais na secção de campos personalizados ao personalizar o suplemento do HubSpot? O nosso complemento do HubSpot permite-lhe incluir campos de formulário adicionais que serão mapeados para campos na sua conta do HubSpot. No entanto, pode alargar esta funcionalidade para incluir mais propriedades de campo que não são atualmente suportadas pelo addon principal.
Este guia abordará as etapas para adicionar o snippet ao seu site WordPress.
Adicionar o snippet
Para começar, terá de adicionar o snippet abaixo ao seu site. Se não tiver a 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 do HubSpot para incluir o conversioninformation
detalhes como uma opção ao definir campos personalizados com o Complemento do HubSpot.
Visualizar 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.

Verá todos os campos da propriedade que adicionou listados no menu pendente.

Para saber mais sobre o complemento do HubSpot, não deixe de conferir nosso guia detalhado sobre como instalar e usar o complemento do HubSpot no WPForms.
Perguntas mais frequentes
Abaixo, respondemos a algumas das principais perguntas sobre como estender as propriedades de contato ao usar o complemento do HubSpot com o WPForms.
Posso autorizar várias 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 atualizando a API para incluir tanto o conversioninformation
e analyticsinformation
propriedades.
Posso incluir todas as propriedades de contacto do HubSpot?
Sim, você pode incluir todas as propriedades de contato adicionais da sua conta da HubSpot no WPForms. Para isso, basta adicionar o snippet abaixo ao seu site:
add_filter( 'wpforms_hubspot_api_allow_property', '__return_true' );
É isso aí! Aprendeu a personalizar o addon do HubSpot para incluir propriedades de contacto adicionais.
Em seguida, gostaria de aceder ao URL dos ficheiros carregados através do campo File Upload? Não deixe de consultar o nosso tutorial para saber como.
Relacionadas
Referência do filtro: wpforms_hubspot_api_allow_property