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

概要

woocommerce_email_subject_backorder フィルタは、WooCommerceプラグイン内でのバックオーダー関連のメールの件名をカスタマイズするために使用されます。このフィルタは、ストックがない商品が注文された際に送信されるメールの件名を変更したい場合に特に便利です。具体的には、以下のような機能を実装する際によく使用されます：

バックオーダー商品の件名をブランド名や製品名でカスタマイズする
バックオーダー時の迅速な通知のために、件名に特別なタグを追加する
メールの件名を多言語対応にするため、条件に応じて変更する
イベントやキャンペーンに基づいて、件名を特別なメッセージに変更する
エコ意識のある企業のため、件名に「環境に優しい」などのキーワードを追加する
顧客のフィードバックをもとに、件名を定期的に見直す

使用構文

add_filter( 'woocommerce_email_subject_backorder', 'custom_backorder_email_subject', 10, 2 );

woocommerce_email_subject_backorder はフィルターフック名。
custom_backorder_email_subject は関数名。
10 は優先度（オプション）。
2 は渡される引数の数（オプション）。

パラメータ

$subject : 既定のメール件名（文字列）
$order : 注文オブジェクト（WC_Order）

戻り値

カスタマイズされたメール件名（文字列）

使用可能なバージョン

WooCommerce: 3.0以上
WordPress: 4.4以上

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

アクション	使用可能性
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_backorder', 'custom_backorder_subject', 10, 2 );
function custom_backorder_subject( $subject, $order ) {
    return '【重要】バックオーダー商品について - ' . $subject;
}

このコードは、バックオーダー商品のメール件名の前に「【重要】バックオーダー商品について」というプレフィックスを追加します。

サンプルコード引用元: https://www.example.com/sample1

サンプルコード 2

add_filter( 'woocommerce_email_subject_backorder', 'language_based_backorder_subject', 10, 2 );
function language_based_backorder_subject( $subject, $order ) {
    if ( get_locale() == 'ja' ) {
        return 'バックオーダー件名 - ' . $subject;
    }
    return $subject;
}

このコードは、言語設定が日本語の場合にのみ件名をカスタマイズします。

サンプルコード引用元: https://www.example.com/sample2

サンプルコード 3

add_filter( 'woocommerce_email_subject_backorder', 'event_promotion_backorder_subject', 10, 2 );
function event_promotion_backorder_subject( $subject, $order ) {
    return 'プロモーション中のバックオーダー - ' . $subject;
}

このコードは、特別なプロモーション中に送信されるバックオーダーメールの件名を変更します。

サンプルコード引用元: https://www.example.com/sample3

サンプルコード 4

add_filter( 'woocommerce_email_subject_backorder', 'environment_friendly_backorder_subject', 10, 2 );
function environment_friendly_backorder_subject( $subject, $order ) {
    return 'エコバックオーダー商品: ' . $subject;
}

このコードは、エコ意識を持った企業のために、件名に「エコバックオーダー商品」というフレーズを追加します。

サンプルコード引用元: https://www.example.com/sample4

サンプルコード 5

add_filter( 'woocommerce_email_subject_backorder', 'feedback_based_backorder_subject', 10, 2 );
function feedback_based_backorder_subject( $subject, $order ) {
    // 顧客のフィードバックに基づく件名の変更（例）
    if ( $order->get_meta( 'customer_feedback' ) ) {
        return 'フィードバックに基づくバックオーダー - ' . $subject;
    }
    return $subject;
}

このコードは、顧客のフィードバックがある場合にのみ件名を変更します。

サンプルコード引用元: https://www.example.com/sample5

概要