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

概要

フィルタ woocommerce_email_subject_customer_refunded_order は、WooCommerce の顧客返金通知メールの件名をカスタマイズするために使用されます。このフィルタを通じて、メールの件名を動的に変更することができ、特定のビジネスニーズやブランドのトーンに合わせた内容を実現できます。

一般的には以下のような機能を実装する際によく使われます：
1. ブランド名や店舗名の追加
2. 特定のプロモーションやキャンペーンを反映
3. 返金理由を件名に明記
4. 特定の顧客セグメントに合わせた件名の変更
5. 多言語サイトでの件名の適切な翻訳
6. 名前や注文番号を含むパーソナライズされた件名

構文

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

パラメータ

$subject (string): デフォルトの件名
$order (WC_Order): 返金された注文のオブジェクト

戻り値

(string): カスタマイズされたメール件名

対応プラグイン/バージョン

WooCommerce バージョン: 3.0 以降
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_refunded_order', 'custom_refund_subject', 10, 2 );

function custom_refund_subject( $subject, $order ) {
    return '返金のお知らせ - 注文番号: ' . $order->get_order_number();
}

このコードは、返金メールの件名に「返金のお知らせ – 注文番号: [注文番号]」という形式を追加します。

サンプルコード 2

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

function custom_subject_with_store_name( $subject, $order ) {
    return '【MyShop】' . $subject;
}

このコードは、メールの件名の先頭に店舗名を追加します。

サンプルコード 3

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

function personalized_refund_subject( $subject, $order ) {
    return 'お客様 ' . $order->get_billing_first_name() . ' 様のご返金について';
}

このコードは、受取人の名前を件名に挿入してパーソナライズされたメールにします。

サンプルコード 4

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

function promo_refund_subject( $subject, $order ) {
    return '特別なお知らせ: ご返金が処理されました！ ' . $order->get_order_number();
}

このコードはプロモーションメッセージを追加し、件名を目立たせます。

サンプルコード 5

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

function multi_language_refund_subject( $subject, $order ) {
    $lang = get_locale(); // 現在の言語を取得
    if ($lang == 'ja') {
        return 'ご返金処理が完了しました - 注文番号: ' . $order->get_order_number();
    } else {
        return 'Refund Processed - Order Number: ' . $order->get_order_number();
    }
}

このコードは、サイトの言語に応じて内容を変更します。どちらの言語でも適切なメール件名が生成されます。

概要

構文