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

概要

woocommerce_before_cart_collateralsは、WooCommerceのカートページにおいて、カートの合計金額や決済ボタンの前にカスタムコードを挿入するためのアクションフックです。このフックを使用することで、カートの情報が表示される部分に新しい要素を追加することができ、顧客体験を向上させるための多様なカスタマイズが可能となります。

よく使われる機能としては以下の6つがあります：

カスタムマーケティングメッセージの表示
サービスや特典の告知を挿入
他の商品のおすすめリストを表示
クーポンコード入力フィールドの追加
購入に関するFAQセクションの追加
顧客のレビューや評価の表示

構文

add_action('woocommerce_before_cart_collaterals', 'your_custom_function');

パラメータ

このアクションにはパラメータはありません。

戻り値

特に戻り値はありません。このアクションは主に追加のHTMLや他の情報をカートページに出力するために使用されます。

WooCommerceのバージョン

このアクションはWooCommerce 2.0以降で利用可能です。

ワードプレスのバージョン

WordPress 3.9以降で動作します。

サンプルコード

サンプルコード1: カスタムメッセージの表示

このコードはカートの合計金額の前に特定のメッセージを表示します。

add_action('woocommerce_before_cart_collaterals', 'add_custom_message_to_cart');

function add_custom_message_to_cart() {
    echo '<div class="custom-message">特別キャンペーン中！今なら全商品5%オフ。</div>';
}

サンプルコード2: おすすめ商品の表示

カートの前におすすめ商品のリストを表示するサンプルコードです。

add_action('woocommerce_before_cart_collaterals', 'display_recommended_products');

function display_recommended_products() {
    echo '<h3>おすすめ商品</h3>';
    echo do_shortcode('[products limit="3" columns="3" orderby="rand"]');
}

サンプルコード3: FAQセクションの追加

購入に関するFAQのセクションをカートに追加する例です。

add_action('woocommerce_before_cart_collaterals', 'add_faq_section');

function add_faq_section() {
    echo '<div class="faq-section">';
    echo '<h4>よくある質問</h4>';
    echo '<p>Q: お届けはどのくらいかかりますか？</p>';
    echo '<p>A: 通常、3〜5営業日でお届けします。</p>';
    echo '</div>';
}

サンプルコード4: クーポンコードフィールドの追加

カートにクーポンコードを入力するフィールドを追加するサンプルです。

add_action('woocommerce_before_cart_collaterals', 'add_coupon_code_field');

function add_coupon_code_field() {
    echo '<div class="coupon-field">';
    echo '<h4>クーポンコードを入力</h4>';
    echo '<input type="text" name="coupon_code" placeholder="クーポンコード">';
    echo '<button type="button">適用</button>';
    echo '</div>';
}

サンプルコード5: ショッピングカートの情報を強調表示

カート内のアイテム数を強調するためのコード例です。

add_action('woocommerce_before_cart_collaterals', 'highlight_cart_item_count');

function highlight_cart_item_count() {
    $cart_count = WC()->cart->get_cart_contents_count();
    echo '<div class="cart-item-count" style="font-weight:bold;">カート内アイテム数: ' . $cart_count . ' 点</div>';
}

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

アクション	使用例
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

概要

構文