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

概要

woocommerce_email_title フィルタは、WooCommerceの送信するメールのタイトルを変更するために使用されるフックです。このフィルタを使用することで、さまざまなシーンでメールのタイトルをカスタマイズできます。代表的な用途としては以下のようなものがあります：

注文確認メールのタイトルを変更する
注文キャンセルメールのタイトルをカスタマイズする
商品の発送通知メールの件名を変更する
お客様への問い合わせへの返信メールのタイトルを設定する
定期購読更新のお知らせメールのタイトルを調整する
特別なプロモーションの案内メールのタイトルを変更する

woocommerce_email_title フィルタは、WooCommerceのメール処理に関連するすべてのバージョンで利用可能です。ワードプレスのバージョンにおいても、WooCommerceがインストールされている限り、このフィルタを使用することができます。

構文

add_filter( 'woocommerce_email_title', 'custom_email_title', 10, 2 );

パラメータ

$title (string): 現在のメールのタイトル
$id (string): メールのタイプ（例：’customer_order’、’customer_note’など）

戻り値

(string): 変更されたメールのタイトル

サンプルコード

サンプルコード1: 注文確認メールの件名をカスタマイズ

このサンプルコードは、注文確認メールのタイトルをカスタマイズします。

add_filter( 'woocommerce_email_title', 'custom_order_confirmation_email_title', 10, 2 );

function custom_order_confirmation_email_title( $title, $id ) {
    if ( $id == 'customer_on_hold_order' ) {
        return 'あなたの注文が保留中です！';
    }
    return $title;
}

このコードでは、メールのIDが ‘customer_on_hold_order’ の場合に、タイトルを「あなたの注文が保留中です！」に変更します。

引用元: https://woocommerce.com/document/woocommerce-email-settings/

サンプルコード2: 商品発送メールのタイトル変更

このサンプルコードは、商品発送通知メールのタイトルをカスタマイズします。

add_filter( 'woocommerce_email_title', 'custom_shipping_email_title', 10, 2 );

function custom_shipping_email_title( $title, $id ) {
    if ( $id == 'customer_shipped_order' ) {
        return 'あなたの注文が発送されました！';
    }
    return $title;
}

このコードは、商品発送通知の際にタイトルを「あなたの注文が発送されました！」に変更します。

引用元: https://woocommerce.com/document/configuring-woocommerce-emails/

サンプルコード3: キャンセルメールのタイトルを変更

このサンプルコードは、注文キャンセルメールのタイトルをカスタマイズします。

add_filter( 'woocommerce_email_title', 'custom_cancelled_order_email_title', 10, 2 );

function custom_cancelled_order_email_title( $title, $id ) {
    if ( $id == 'customer_cancelled_order' ) {
        return 'ご注文がキャンセルされました';
    }
    return $title;
}

このコードでは、キャンセルされた注文に対して「ご注文がキャンセルされました」というタイトルに変更します。

引用元: https://woocommerce.com/document/managing-orders/

サンプルコード4: 顧客ノートメールのタイトル変更

このサンプルコードは、顧客ノートメールのタイトルをカスタマイズします。

add_filter( 'woocommerce_email_title', 'custom_customer_note_email_title', 10, 2 );

function custom_customer_note_email_title( $title, $id ) {
    if ( $id == 'customer_note' ) {
        return '新しいメモが追加されました';
    }
    return $title;
}

このコードでは、顧客に送信されるノートに「新しいメモが追加されました」というタイトルを変更します。

引用元: https://woocommerce.com/document/woocommerce-email-how-to/

サンプルコード5: 定期購読に関するメールタイトルの変更

このサンプルコードは、定期購読更新のメールタイトルを変更しています。

add_filter( 'woocommerce_email_title', 'custom_subscription_email_title', 10, 2 );

function custom_subscription_email_title( $title, $id ) {
    if ( $id == 'customer_subscription_renewal' ) {
        return 'あなたの定期購読が更新されました！';
    }
    return $title;
}

このコードは、定期購読の更新通知メールのタイトルを「あなたの定期購読が更新されました！」に変更します。

引用元: https://woocommerce.com/document/woocommerce-subscriptions/

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

アクション	使用可能性
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

概要

構文