概要
フィルタ woocommerce_cart_no_shipping_available_html
は、WooCommerce のカートで利用可能な配送方法がない場合に表示されるメッセージをカスタマイズするために使用されます。このフィルタを使用することにより、ユーザーに適切な情報を提供したり、特定の状況に応じて異なるメッセージを表示したりすることが可能です。以下のようなシナリオでよく使用されます。
- 配送地域の制限をユーザーに通知する
- 商品の在庫状況に基づいたメッセージを表示する
- 配送方法が選択できない理由を説明する
- 特殊なプロモーションやオファーを知らせる
- サポートへのコンタクト方法を提示する
- 別の配送方法を選択するためのリンクを提供する
構文
add_filter('woocommerce_cart_no_shipping_available_html', 'custom_no_shipping_message');
パラメータ
$html
(string): デフォルトのメッセージ HTML
戻り値
- string: カスタマイズされたメッセージ HTML
WooCommerce バージョン
- WooCommerce 2.0.0以上
WordPress バージョン
- 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_no_shipping_available_html', 'custom_no_shipping_message');
function custom_no_shipping_message($html) {
return '<div class="no-shipping-alert">申し訳ございません、現在この地域への配送は利用できません。</div>';
}
説明: 配送が利用できない場合に表示されるメッセージをカスタムメッセージに変更しています。
サンプルコード2
add_filter('woocommerce_cart_no_shipping_available_html', 'add_contact_info_no_shipping');
function add_contact_info_no_shipping($html) {
return $html . '<p>ご不明点がございましたら、サポートまでご連絡ください。</p>';
}
説明: デフォルトのメッセージにサポートへの連絡情報を追加しています。
サンプルコード3
add_filter('woocommerce_cart_no_shipping_available_html', 'custom_shipping_error_message');
function custom_shipping_error_message($html) {
return '現在、この商品の配送方法はありません。<a href="' . esc_url( home_url('/support') ) . '">サポートページはこちら。</a>';
}
説明: 配送が利用できないことを伝えつつ、サポートページへのリンクを提供しています。
サンプルコード4
add_filter('woocommerce_cart_no_shipping_available_html', 'highlight_alternative_options');
function highlight_alternative_options($html) {
return '<strong>この地域への配送はできませんが、他の配送オプションをご確認ください。</strong>';
}
説明: 他の配送オプションを確認するよう促すメッセージを追加しています。
サンプルコード5
add_filter('woocommerce_cart_no_shipping_available_html', 'personalized_no_shipping_notice');
function personalized_no_shipping_notice($html) {
return '<p>お住まいの地域への配送は現在ご利用できません。<span style="color:red;">ご注意ください!</span></p>';
}
説明: 配送が不可であることを強調するデザインを施したメッセージを返しています。