プラグインWooCommerceのwoocommerce_tracker_admin_emailフィルタの使用方法・解説

概要

woocommerce_tracker_admin_email フィルタは、WooCommerceのトラッキング情報が送信される際に、管理者への通知用のメールアドレスを変更するために使用されます。このフィルタは、さまざまなカスタマイズ要件に応じて、メール通知の受信者を調整するのに役立ちます。以下は、このフィルタがよく使われる機能です。

トラッキング通知を特定の管理者に送信する。
複数の管理者にメールを転送するためのカスタマイズ。
外部のサポートチームにトラッキング情報を送信。
特定の条件に基づいて異なるメールアドレスを指定。
プラグインやテーマによるトラッキングメールの受信者を変更。
必要に応じて一時的に受信者を変更する。

構文

add_filter('woocommerce_tracker_admin_email', 'custom_tracker_admin_email');

パラメータ

$email (string): 現在の管理者メールアドレス。

戻り値

(string): 変更後の管理者メールアドレス。

対応バージョン

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_filter('woocommerce_tracker_admin_email', function( $email ) {
    return 'admin@example.com'; // 特定の管理者のメールアドレスに変更
});

このコードは、既定の管理者メールアドレスを admin@example.com に設定します。

出典: WooCommerce公式ドキュメント

サンプルコード2

以下のサンプルコードは、複数の管理者へのメール転送を実現しています。

add_filter('woocommerce_tracker_admin_email', function( $email ) {
    return 'admin1@example.com, admin2@example.com'; // 複数管理者へメール送信
});

このコードは、admin1@example.com と admin2@example.com にトラッキングメールを送信します。

出典: WooCommerce公式リポジトリ

サンプルコード3

特定の条件に基づいてメールアドレスを設定するサンプルです。

add_filter('woocommerce_tracker_admin_email', function( $email ) {
    if ( is_admin() ) {
        return 'admin@domain.com'; // 管理画面からアクセスしている場合
    }
    return $email;
});

このコードは、管理画面からアクセスしている場合に限り admin@domain.com にメールを送信します。

出典: コミュニティフォーラム

サンプルコード4

メールアドレスを日替わりで変更するサンプルです。

add_filter('woocommerce_tracker_admin_email', function( $email ) {
    $day_of_week = date('N');
    if ($day_of_week == 1) {
        return 'monday@domain.com'; // 月曜日
    }
    return $email;
});

このコードは、月曜日の場合に限り monday@domain.com にメールを送信します。

出典: WordPress開発者向けブログ

サンプルコード5

特定のプラグインが有効な場合に、トラッキングメールアドレスを変更するサンプルです。

add_filter('woocommerce_tracker_admin_email', function( $email ) {
    if ( is_plugin_active('some-plugin/some-plugin.php') ) {
        return 'special@domain.com'; // プラグイン有効時に特定のメールアドレス
    }
    return $email;
});

このコードは、特定のプラグインが有効な場合に special@domain.com に変更します。

出典: プラグイン開発リファレンス

概要

構文