プラグインWooCommerceのwoocommerce_cart_emptiedアクションの使用方法・解説

概要

woocommerce_cart_emptied アクションは、WooCommerceのショッピングカートが空になった際にトリガーされるフックです。このフックは、ユーザーがカート内の商品を削除したり、購入が完了した後にカートが空になった際に特定の処理を実行するためによく使用されます。実装例としては、次のようなケースが考えられます。

ユーザーへのカート空の通知を送信する。
マーケティングキャンペーンのためのデータを収集する。
アナリティクスやトラッキングツールにデータを送信する。
特定のクーポンコードを発行する。
顧客フィードバックの収集を開始する。
アップセリングの内容を表示する。

構文

add_action('woocommerce_cart_emptied', 'your_function_name', 10, 0);

パラメータ

なし（このアクションはパラメータを受け取りません）

戻り値

戻り値はありません。このフックは、特定の処理を実行するために使用されるため、何も返さないのが通常です。

使用可能なプラグインおよび WordPress のバージョン

WooCommerce バージョン: 3.0.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_action('woocommerce_cart_emptied', 'notify_cart_empty');

function notify_cart_empty() {
    wc_add_notice(__('Your cart is currently empty.', 'your-text-domain'), 'notice');
}

このコードは、カートが空になったときに「カートは現在空です」というメッセージを表示します。

サンプル2: カートが空になったときにメールを送信する

add_action('woocommerce_cart_emptied', 'send_cart_empty_email');

function send_cart_empty_email() {
    $to = get_option('admin_email');
    $subject = 'Cart Emptied Notification';
    $message = 'A user has emptied their cart.';
    wp_mail($to, $subject, $message);
}

このコードは、カートが空になった際に管理者にメールを送信します。

サンプル3: カートが空になったときにデータを記録する

add_action('woocommerce_cart_emptied', 'log_cart_empty_action');

function log_cart_empty_action() {
    // ログファイルに記録する処理
    error_log('Cart emptied at ' . date("Y-m-d H:i:s"));
}

このコードは、カートが空になった時刻をログファイルに記録します。

サンプル4: カートが空になったときにクーポンを表示する

add_action('woocommerce_cart_emptied', 'display_coupon');

function display_coupon() {
    echo '<script>alert("Use coupon code SAVE10 for your next purchase!");</script>';
}

このコードは、カートが空になったときにクーポンコード「SAVE10」の通知を表示します。

サンプル5: カートが空になったときにカスタムリダイレクト

add_action('woocommerce_cart_emptied', 'redirect_after_cart_empty');

function redirect_after_cart_empty() {
    wp_redirect(home_url('/custom-page'));
    exit;
}

このコードは、カートが空になった際に特定のカスタムページへリダイレクトします。

概要

構文