概要
woocommerce_order_button_textフィルタは、WooCommerceのチェックアウトページに表示される注文ボタンのテキストをカスタマイズするために使用されます。このフックを利用することで、ショップオーナーは顧客に対してより魅力的なメッセージを提供したり、特定のアクションを促すテキストに変更することができます。
このフィルタは、以下のような機能を実装する際によく使われます。
- 注文ボタンのテキストをカスタマイズする。
- 特定のプロモーションやセールを反映させた文言に変更する。
- 顧客の購入を促す心理的なメッセージを追加する。
- 複数の言語に対応したボタンテキストを設定する。
- ［カートにアイテムを追加］等の特別な文言に変更する。
- 販売方法（定期購入や一回限りの購入）に応じたテキストを表示する。
フィルタの概要
- 構文:
add_filter( 'woocommerce_order_button_text', 'your_custom_function' ); - パラメータ: 1つのパラメータ
$button_text（現在の注文ボタンのテキスト） - 戻り値: カスタマイズされた注文ボタンのテキスト
- WooCommerce バージョン: 4.x 以降
- WordPress バージョン: 5.x 以降
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| 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_order_button_text', 'custom_order_button_text' );
function custom_order_button_text( $button_text ) {
return '今すぐ購入';
}
引用元: https://woocommerce.com
サンプルコード 2: プロモーションの反映
このコードでは、特定のプロモーションを反映した注文ボタンのテキストを設定します。
add_filter( 'woocommerce_order_button_text', 'promo_order_button_text' );
function promo_order_button_text( $button_text ) {
return '特別オファーを受ける';
}
引用元: https://woocommerce.com
サンプルコード 3: 多言語対応
この例では、言語に応じて異なる注文ボタンのテキストを設定します。
add_filter( 'woocommerce_order_button_text', 'multilingual_order_button_text' );
function multilingual_order_button_text( $button_text ) {
return ( is_rtl() ) ? 'احصل على الاقتراحات الآن' : 'Get Suggestions Now';
}
引用元: https://woocommerce.com
サンプルコード 4: 定期購入向けのテキスト
このコードでは、定期購入に特化したメッセージを設定します。
add_filter( 'woocommerce_order_button_text', 'subscription_order_button_text' );
function subscription_order_button_text( $button_text ) {
return '定期購入を開始';
}
引用元: https://woocommerce.com
サンプルコード 5: 特定の商品カテゴリ用のボタン文言
このコードでは、特定の商品カテゴリに応じてボタンテキストを変更します。
add_filter( 'woocommerce_order_button_text', 'category_based_order_button_text' );
function category_based_order_button_text( $button_text ) {
if ( has_term( '特定カテゴリ', 'product_cat' ) ) {
return '特別なお買い物';
}
return $button_text;
}
引用元: https://woocommerce.com