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

概要

woocommerce_email_additional_content_$THIS->IDフィルタは、WooCommerceで特定のメールテンプレートに追加のコンテンツを挿入する際に使用されます。このフィルタは、特定のメールIDに基づいて且つメールの送信時に呼び出されます。これにより、顧客へのメールにカスタムメッセージや情報を追加することが可能です。このフィルタは、以下のような機能を実装する際に役立ちます：

注文確認メールに追加の公式情報を提供
配送通知メールにプロモーション情報を追加
カスタムメッセージを新規登録メールに含める
レビューリマインダーメールにクーポン情報を追加
定期購読の確認メールにオプトイン情報を追加
キャンセルされた注文の通知メールにフィードバックリクエストを含める

構文

add_filter( 'woocommerce_email_additional_content_$THIS->ID', 'your_function_name', 10, 2 );

パラメータ

$additional_content：追加メールコンテンツの文字列
$order：該当する注文の情報を含むオブジェクト

戻り値

$additional_content：フィルタ処理された追加コンテンツの文字列

使用可能なバージョン

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_additional_content_customer_completed_order', 'add_custom_message_to_completed_order_email', 10, 2 );
function add_custom_message_to_completed_order_email( $additional_content, $order ) {
    $additional_content .= 'ご注文いただきありがとうございます！次回のお買い物に使えるクーポンコードをお送りします。';
    return $additional_content;
}

このコードは、注文完了メールにカスタムメッセージを追加します。

サンプル2: 配送通知メールにプロモーション情報を追加

add_filter( 'woocommerce_email_additional_content_customer_shipped_order', 'add_promotion_info_to_shipped_order_email', 10, 2 );
function add_promotion_info_to_shipped_order_email( $additional_content, $order ) {
    $additional_content .= '今後のご注文に使える10%オフのクーポンコードをご利用ください！';
    return $additional_content;
}

このコードは、配送通知メールにプロモーション情報を追加します。

サンプル3: 新規登録メールにカスタムメッセージを追加

add_filter( 'woocommerce_email_additional_content_customer_new_account', 'add_welcome_message_new_account', 10, 2 );
function add_welcome_message_new_account( $additional_content, $user ) {
    $additional_content .= '新しいアカウントの作成ありがとうございます！';
    return $additional_content;
}

このコードは、新規登録メールに歓迎メッセージを追加します。

サンプル4: レビューリマインダーメールにクーポン情報を追加

add_filter( 'woocommerce_email_additional_content_customer_review_reminder', 'add_coupon_code_to_review_email', 10, 2 );
function add_coupon_code_to_review_email( $additional_content, $order ) {
    $additional_content .= 'レビューを書いていただくと次回使えるクーポンをお送りします！';
    return $additional_content;
}

このコードは、レビューリマインダーメールにクーポン情報を追加します。

サンプル5: キャンセル通知メールにフィードバックリクエストを追加

add_filter( 'woocommerce_email_additional_content_customer_cancelled_order', 'add_feedback_request_to_cancelled_order_email', 10, 2 );
function add_feedback_request_to_cancelled_order_email( $additional_content, $order ) {
    $additional_content .= 'ご注文がキャンセルされました。ぜひ、フィードバックをお寄せください。';
    return $additional_content;
}

このコードは、キャンセル通知メールにフィードバックリクエストを追加します。

概要

構文