プラグインWooCommerceのwoocommerce_email_subject_$THIS->IDフィルタの使用方法・解説

概要

woocommerce_email_subject_$THIS->ID フィルタは、WooCommerceプラグイン内でさまざまなメール通知の件名をカスタマイズするために使用されます。このフィルタを使用することで、特定のメールタイプに対応した件名を変更できます。この機能は、特に以下のような要件がある場合によく使用されます。

1. 購入完了メールの件名の変更
2. 注文キャンセル通知の件名のカスタマイズ
3. パスワードリセットメールの件名の変更
4. 新規ユーザー登録メールの件名の調整
5. 返品リクエストメールの件名のカスタマイズ
6. 定期購買の確認メールの件名の変更

構文

add_filter( 'woocommerce_email_subject_$THIS->ID', 'custom_email_subject', 10, 2 );

パラメータ

• $subject：デフォルトのメール件名（文字列）
• $order：関連する注文情報のオブジェクト（オプション）

戻り値

このフィルタは、カスタマイズされたメール件名（文字列）を返します。

使用可能なプラグインバージョン

このフィルタはWooCommerceのすべてのバージョンで使用可能です。

使用可能なWordPressバージョン

WordPressのバージョン4.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_email_subject_customer_completed_order', 'custom_completed_order_email_subject', 10, 2 );

function custom_completed_order_email_subject( $subject, $order ) {
    return 'お祝い！あなたの注文が完了しました！'; 
}

引用元: https://example.com

サンプルコード2: 注文キャンセルメールの件名を変更

このコードは、注文キャンセルのメール件名を変更する例です。

add_filter( 'woocommerce_email_subject_customer_cancelled_order', 'custom_cancelled_order_email_subject', 10, 2 );

function custom_cancelled_order_email_subject( $subject, $order ) {
    return 'ご注意：あなたの注文がキャンセルされました。';
}

引用元: https://example.com

サンプルコード3: パスワードリセットメールの件名を変更

このコードは、パスワードリセットメールの件名をカスタマイズします。

add_filter( 'woocommerce_email_subject_customer_reset_password', 'custom_reset_password_email_subject', 10, 2 );

function custom_reset_password_email_subject( $subject, $user ) {
    return 'あなたのパスワードリセットリンクです。';
}

引用元: https://example.com

サンプルコード4: 新規ユーザー登録メールの件名を変更

このコードは、新規ユーザー登録メールの件名をカスタマイズします。

add_filter( 'woocommerce_email_subject_new_customer', 'custom_new_customer_email_subject', 10, 2 );

function custom_new_customer_email_subject( $subject, $customer ) {
    return '新しいアカウントが作成されました！';
}

引用元: https://example.com

サンプルコード5: 返品リクエストメールの件名を変更

このコードは、返品リクエストメールの件名を変更します。

add_filter( 'woocommerce_email_subject_customer_refunded_order', 'custom_refund_email_subject', 10, 2 );

function custom_refund_email_subject( $subject, $order ) {
    return 'あなたの返品リクエストが処理されました。';
}

引用元: https://example.com