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

概要

woocommerce_cart_item_backorder_notification フィルタは、WooCommerceのカートアイテムがバックオーダー（在庫切れ）の際に表示される通知をカスタマイズするためのフィルタです。このフィルタを使用することで、商業的なニーズや特定のマーケティング戦略に基づいてメッセージを変更し、顧客に対する情報提供の質を向上させることができます。

このフィルタは、以下のような機能を実装する際によく使われます。
1. バックオーダーアイテムに対するカスタマイズメッセージの表示
2. 特定の商品のバックオーダーに対する警告メッセージの設定
3. スペシャルオファーやプロモーションの通知の統合
4. 顧客体験を向上させるためのメッセージカスタマイゼーション
5. バックオーダーによる物流情報の提供
6. 商品供給状況に関するターゲティングメッセージの表示

構文

add_filter('woocommerce_cart_item_backorder_notification', 'custom_backorder_notification', 10, 2);

パラメータ

$notification: 各アイテムに対して表示される通知メッセージ。
$item: カート内のアイテムに関する情報。

戻り値

フィルタによってカスタマイズされたバックオーダーメッセージ。

使用可能なプラグインのバージョン

WooCommerce: v3.0.0以上
WordPress: v4.6.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_cart_item_backorder_notification', 'custom_backorder_message', 10, 2);
function custom_backorder_message($notification, $item) {
    if ($item['data']->is_on_backorder(1)) {
        return 'この商品はバックオーダー可能です。';
    }
    return $notification;
}

このサンプルコードは、バックオーダーが可能な商品に対して特定のメッセージを表示します。

サンプルコード2

add_filter('woocommerce_cart_item_backorder_notification', 'enhanced_backorder_notification', 10, 2);
function enhanced_backorder_notification($notification, $item) {
    return 'ご利用いただけるバックオーダー。この商品はすぐに入荷予定です。';
}

このコードは、バックオーダーが可能な商品に対して、特に期待感を持たせるメッセージに変更しています。

サンプルコード3

add_filter('woocommerce_cart_item_backorder_notification', 'custom_backorder_text', 10, 2);
function custom_backorder_text($notification, $item) {
    if ($item['data']->is_on_backorder()) {
        return sprintf('"%s"は在庫切れですが、バックオーダーが可能です。', $item['data']->get_name());
    }
    return $notification;
}

このサンプルでは、商品名を含むカスタムメッセージを生成します。

サンプルコード4

add_filter('woocommerce_cart_item_backorder_notification', 'dynamic_backorder_notice', 10, 2);
function dynamic_backorder_notice($notification, $item) {
    $restock_date = '3月10日';
    return $notification . '次回入荷予定: ' . $restock_date;
}

このコードは、バックオーダー商品に対して次回の入荷予定日を通知するメッセージを追加します。

サンプルコード5

add_filter('woocommerce_cart_item_backorder_notification', 'personalized_backorder_message', 10, 2);
function personalized_backorder_message($notification, $item) {
    $user = wp_get_current_user();
    if ($item['data']->is_on_backorder()) {
        return 'お客様 ' . $user->display_name . '、この商品はバックオーダーに登録済みです。';
    }
    return $notification;
}

このコードでは、現在ログイン中のユーザー名を含むバックオーダーメッセージを作成します。

概要

構文