プラグインWooCommerceのwoocommerce_customer_object_updated_propsアクションの使用方法・解説

概要

woocommerce_customer_object_updated_props は、WooCommerce におけるカスタマーオブジェクトのプロパティが更新された際に発火するアクションフックです。このフックは、カスタマー情報の変更が行われた際にカスタム処理を実行するために使用されます。以下のような機能実装でよく使われます。

カスタマー情報の変更をトラッキング
外部サービスとのデータ同期
カスタムフィールドの更新
メール通知の送信
アナリティクスのデータ送信
顧客セグメンテーションやマーケティングのトリガー

構文

do_action( 'woocommerce_customer_object_updated_props', $customer, $data );

パラメータ

$customer (WC_Customer)：更新されたカスタマーオブジェクト。
$data (array)：更新されたプロパティの配列。

戻り値

このアクションは、特に戻り値を持っていません。主にカスタム処理を実行するために使用されます。

WooCommerce と WordPress のバージョン

WooCommerce バージョン: 5.0 以上
WordPress バージョン: 5.0 以上

この関数のアクションでの使用可能性

アクション名	使用可能性
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init
register_sidebar
wp_loaded
send_headers
parse_query
pre_get_posts
wp
template_redirect
get_header
wp_head

サンプルコード

サンプル1: カスタマー情報の更新をトラッキングする

add_action( 'woocommerce_customer_object_updated_props', 'track_customer_info_update', 10, 2 );

function track_customer_info_update( $customer, $data ) {
    $changed_properties = array_keys( $data );
    // 変更があったプロパティをログに記録
    error_log( '変更があったプロパティ: ' . implode( ', ', $changed_properties ) );
}

このサンプルでは、カスタマー情報が更新されるたびに変更されたプロパティをログに記録します。

サンプル2: 外部サービスにデータを同期する

add_action( 'woocommerce_customer_object_updated_props', 'sync_customer_data_to_external_service', 10, 2 );

function sync_customer_data_to_external_service( $customer, $data ) {
    $customer_data = [
        'email' => $customer->get_email(),
        'first_name' => $customer->get_first_name(),
        'last_name' => $customer->get_last_name(),
    ];
    // 外部サービスに客データを送信するコード
}

このサンプルでは、カスタマーのメールアドレス、名、姓を外部サービスに送信します。

サンプル3: カスタムフィールドの更新

add_action( 'woocommerce_customer_object_updated_props', 'update_custom_fields', 10, 2 );

function update_custom_fields( $customer, $data ) {
    if ( isset( $data['billing_phone'] ) ) {
        // カスタムフィールドを更新
        update_user_meta( $customer->get_id(), 'custom_phone_field', sanitize_text_field( $data['billing_phone'] ) );
    }
}

このサンプルでは、顧客の電話番号が更新されると、カスタムフィールドにもその情報を反映させます。

サンプル4: メール通知の送信

add_action( 'woocommerce_customer_object_updated_props', 'send_email_notification', 10, 2 );

function send_email_notification( $customer, $data ) {
    // メールを送信する処理
}

このサンプルは、カスタマー情報が変更された際にメール通知を送信するための処理を示しています。

サンプル5: アナリティクスへのデータ送信

add_action( 'woocommerce_customer_object_updated_props', 'send_to_analytics', 10, 2 );

function send_to_analytics( $customer, $data ) {
    // アナリティクスサービスにデータを送る処理
}

このサンプルでは、カスタマー情報が更新されると、アナリティクスサービスに関連データを送る処理を示しています。

概要

構文