HubSpotアドオンの連絡先プロパティの追加

概要

HubSpotアドオンをカスタマイズする際に、カスタムフィールドセクションに追加のプロパティを含めますか？ HubSpotアドオンを使用すると、HubSpotアカウントのフィールドにマッピングされる追加のフォームフィールドを含めることができます。ただし、この機能は、コアアドオンでは現在サポートされていない、より多くのフィールドプロパティを含めるように拡張できます。

このガイドでは、WordPressサイトにスニペットを追加する手順を説明します。

スニペットの追加

まず、以下のスニペットをサイトに追加する必要があります。スニペットの追加方法や場所がわからない場合は、こちらの役立つドキュメントをご覧ください。

/**
  * 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 );

上記のコードでは、HubSpotのAPIを更新して、HubSpotアドオンでカスタムフィールドを設定する際のオプションとしてconversioninformationの詳細を含めています。

新しいプロパティの表示

スニペットが追加されると、HubSpot統合ページでカスタムフィールドをカスタマイズする際に、新しいプロパティが利用可能なフィールドのリストに追加されます。

設定を確認するには、新しいフォームを作成するか、既存のフォームを編集してフォームビルダーにアクセスしてください。フォームビルダーで、Marketing » HubSpotに移動し、Custom Field Nameドロップダウンを選択します。

追加したプロパティの下にあるすべてのフィールドがドロップダウンに一覧表示されます。

HubSpotアドオンの詳細については、WPFormsでのHubSpotアドオンのインストールと使用方法に関する詳細ガイドをご覧ください。

よくある質問

以下に、WPFormsでHubSpotアドオンを使用する際に連絡先プロパティを拡張することに関する、よくある質問への回答をまとめました。

複数のプロパティを許可できますか？

スニペットを変更して、追加のプロパティを含めることができます。それを実現するためのスニペットは次のとおりです。

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);

上記のスニペットでは、APIを更新して、conversioninformationとanalyticsinformationの両方のプロパティを含めています。

HubSpotのすべての連絡先プロパティを含めることはできますか？

はい、HubSpotアカウントの追加の連絡先プロパティをすべてWPFormsに含めることができます。これを行うには、以下のスニペットをサイトに追加するだけです。

add_filter( 'wpforms_hubspot_api_allow_property', '__return_true' );

これで、HubSpotアドオンをカスタマイズして追加の連絡先プロパティを含める方法を学びました。

次に、ファイルアップロードフィールドを介してアップロードされたファイルのURLにアクセスしますか？ 方法を学ぶには、チュートリアルを確認してください。

関連

フィルターリファレンス: wpforms_hubspot_api_allow_property