概要
woocommerce_before_cart_totals
は、WooCommerceのカートページで合計金額が表示される前に実行されるアクションフックです。このフックを使うことで、カートの合計表示の前にカスタムテキストや特別な通知、追加情報などを表示することが可能です。これは主に、次のような機能を実装する際に使用されます。
- カートに特別な割引やオファーを表示する。
- 購入手続きの前に注意事項やポリシー情報を提示する。
- カート内の商品の推奨アイテムを表示する。
- 購入を促すメッセージやバナーを表示する。
- クーポンコードの入力フィールドを追加する。
- トラッキングコードを埋め込むためのスクリプトを追加する。
構文
add_action('woocommerce_before_cart_totals', 'your_function_name');
パラメータ
woocommerce_before_cart_totals
にはパラメータはありません。このフックは、WooCommerceのカートの合計が表示される前にカスタム関数を実行させるためのものです。
戻り値
このアクション自体は戻り値を返しません。使われる関数内で出力するHTMLやテキストがカートページに追加されます。
使用可能なバージョン
- 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_action('woocommerce_before_cart_totals', function() {
echo '<div class="custom-message">今だけ限定オファー: 5%オフ!</div>';
});
このサンプルコードは、カートの合計金額の前に「今だけ限定オファー: 5%オフ!」というメッセージを表示します。
サンプルコード2
add_action('woocommerce_before_cart_totals', function() {
echo '<p>あなたにおすすめの商品:</p>';
// ここにおすすめ商品を表示するコードを追加
});
このサンプルコードでは、カートの合計の表示前におすすめ商品に関するメッセージを表示する準備をしています。
サンプルコード3
add_action('woocommerce_before_cart_totals', function() {
if ( WC()->cart->subtotal > 100 ) {
echo '<p>お買い上げ金額が100ドルを超えると送料無料です!</p>';
}
});
このコードは、カートの小計が100ドルを超える場合、送料無料についてのメッセージを表示します。
サンプルコード4
add_action('woocommerce_before_cart_totals', function() {
echo '<div class="alert alert-warning">注意: クーポンコードをお忘れなく!</div>';
});
このサンプルコードは、カート合計の表示の前にクーポンコードを忘れないように促す警告メッセージを表示します。
サンプルコード5
add_action('woocommerce_before_cart_totals', function() {
echo '<p>カートの中身を確認してください!</p>';
});
このシンプルなコードは、カート合計の前に顧客にカートの内容を確認するよう促すメッセージを表示します。