概要
woocommerce_cart_item_removed_message
フィルタは、WooCommerceにおいてカートからアイテムが削除された際に表示されるメッセージをカスタマイズするためのフックです。このフィルタを使うことで、デフォルトのメッセージを変更したり、ユーザーの体験を向上させるためのカスタムメッセージを提供したりできます。
使用例
このフィルタは以下のようなシナリオでよく使用されます:
- アイテム削除時に特別な割引情報を追記する。
- カートに戻るボタンを促すメッセージを表示する。
- 最近訪れた商品の関連商品の情報を表示する。
- カスタマイズされたプロモーションやキャンペーンを告知する。
- 在庫切れ商品に関する情報を示す。
- ユーザーの操作のフィードバックとして、最終的に購入する商品のアップセル情報を加える。
構文
add_filter('woocommerce_cart_item_removed_message', 'custom_remove_item_message', 10, 2);
パラメータ
- $message (文字列): 削除されたアイテムに関するデフォルトのメッセージ。
- $cart_item_key (文字列): 削除されたアイテムのカートアイテムキー。
戻り値
- カスタマイズされたメッセージ (文字列)。
対応バージョン
- WooCommerce: 2.1.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_cart_item_removed_message', 'custom_remove_item_message', 10, 2);
function custom_remove_item_message($message, $cart_item_key) {
return 'アイテムがカートから削除されました。お買い得な商品のチェックをお忘れなく!';
}
このサンプルでは、アイテムがカートから削除されたときに、カスタムメッセージを表示します。
サンプルコード2: 割引情報を追加
add_filter('woocommerce_cart_item_removed_message', 'add_discount_message', 10, 2);
function add_discount_message($message, $cart_item_key) {
return 'アイテムが削除されました。次回の購入の際に使える10%割引クーポンをお送りします!';
}
このサンプルでは、削除時に次回購入時の割引情報を追加しています。
サンプルコード3: ユーザーへのアクションを促すメッセージ
add_filter('woocommerce_cart_item_removed_message', 'promote_cart_return', 10, 2);
function promote_cart_return($message, $cart_item_key) {
return 'カートからアイテムが削除されました。カートに戻るにはこちらをクリックしてください!';
}
このサンプルは、カートに戻るアクションを促すメッセージを表示します。
サンプルコード4: 関連商品の情報を表示
add_filter('woocommerce_cart_item_removed_message', 'related_products_message', 10, 2);
function related_products_message($message, $cart_item_key) {
return 'アイテムが削除されました。これらの関連商品もチェックしてみてください!';
}
このサンプルでは、関連商品のチェックを促すメッセージをカスタマイズしています。
サンプルコード5: 在庫切れ商品のアラートを追加
add_filter('woocommerce_cart_item_removed_message', 'out_of_stock_alert', 10, 2);
function out_of_stock_alert($message, $cart_item_key) {
return 'このアイテムは現在在庫切れです。他の商品の購入をご検討ください。';
}
このサンプルは、在庫切れのアイテムを削除した際にアラートメッセージを表示します。