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

概要

woocommerce_email_heading_customer_refunded_order フィルタは、WooCommerceが顧客の返金注文に関連するメールを送信する際に、メールのヘッディングを変更するために使用されます。このフィルタは特に、メールの内容やスタイルをカスタマイズしたい場合に有用で、以下のようなシナリオでよく使われます。

メールのタイトルをブランドに合わせたものに変更したい場合
特定のターゲットオーディエンス向けにパーソナライズしたメッセージを作成したい場合
メールの言語やトーンを変更して顧客体験を向上させたい場合
特別なプロモーションや割引情報を追加したい場合
ビジネスのロゴを含めることで視覚的な一貫性を持たせたい場合
顧客に対する感謝の意を示すカスタムメッセージを追加したい場合

構文

add_filter( 'woocommerce_email_heading_customer_refunded_order', 'custom_email_heading_for_refunded_order', 10, 2 );

パラメータ

このフィルタには次のパラメータがあります。

$heading (string): 変更前のメールのヘッディング。
$order (WC_Order): 対応する注文オブジェクト。

戻り値

このフィルタは変更されたヘッディング（string）を返します。

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

WooCommerce: 4.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_email_heading_customer_refunded_order', function( $heading, $order ) {
    return 'お支払いが返金されました';
}, 10, 2 );

このコードは、返金された注文のメールヘッディングを「お支払いが返金されました」に変更します。

サンプルコード 2

add_filter( 'woocommerce_email_heading_customer_refunded_order', function( $heading, $order ) {
    return sprintf( '注文 #%s の返金通知', $order->get_order_number() );
}, 10, 2 );

このコードでは、ヘッディングに注文番号を追加して、より文脈にそったメッセージにしています。

サンプルコード 3

add_filter( 'woocommerce_email_heading_customer_refunded_order', function( $heading, $order ) {
    return '返金手続きが完了しました。';
}, 10, 2 );

このコードは、ヘッディングを「返金手続きが完了しました」に設定します。

サンプルコード 4

add_filter( 'woocommerce_email_heading_customer_refunded_order', function( $heading, $order ) {
    return 'ご注文の返金について';
}, 10, 2 );

このコードは、顧客に向けたより丁寧な表現「ご注文の返金について」を使ってヘッディングを変更します。

サンプルコード 5

add_filter( 'woocommerce_email_heading_customer_refunded_order', function( $heading, $order ) {
    return '返金のご案内 - Thank you for your support!';
}, 10, 2 );

このコードでは、ヘッディングに感謝の意を表したメッセージを付加して、顧客への配慮を反映しています。

各サンプルコードは、特定のニーズに合わせて、異なるメッセージを返すように設計されています。

概要

構文