プラグインWooCommerceのwoocommerce_return_to_shop_textフィルタの使用方法・解説

概要

woocommerce_return_to_shop_text フィルタは、WooCommerce で「ショップに戻る」ボタンのテキストをカスタマイズするために使用されます。このフィルタは、カスタマーエクスペリエンスを向上させるためのさまざまなシナリオで利用されます。具体的には、以下のような場面で役立ちます：

ショップのテーマやブランドに合わせたボタン名のカスタマイズ
商品カテゴリ別の独自メッセージの設定
セール情報に基づくカスタマイズ
特定の商品やページによる文言の変更
子供向けや高齢者向けに配慮した表現の使用
トランスレーションシステムを用いた多言語対応

総覧

使用可能なプラグイン WooCommerce のバージョン: 5.0 以上
WordPress のバージョン: 5.4 以上

構文

apply_filters( 'woocommerce_return_to_shop_text', $text );

パラメータ

$text: デフォルトのショップに戻るボタンのテキスト。

戻り値

新しく設定されたショップに戻るボタンのテキスト。

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

アクション	使用例
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_return_to_shop_text', 'custom_return_to_shop_text' );

function custom_return_to_shop_text( $text ) {
    return '戻るショップへ';
}

このコードは、ショップに戻るボタンのテキストを「戻るショップへ」に変更します。

サンプルコード 2

add_filter( 'woocommerce_return_to_shop_text', 'change_return_to_shop_text' );

function change_return_to_shop_text( $text ) {
    if ( is_product_category( 'sale' ) ) {
        return 'セール品をもっと見る';
    }
    return $text;
}

このコードは、セール商品カテゴリーに属するページで「セール品をもっと見る」というテキストを表示します。

サンプルコード 3

add_filter( 'woocommerce_return_to_shop_text', 'update_return_button_text' );

function update_return_button_text( $text ) {
    return 'ショッピングを続ける';
}

このサンプルでは、ボタンのテキストを「ショッピングを続ける」に変更しています。

サンプルコード 4

add_filter( 'woocommerce_return_to_shop_text', 'localized_return_to_shop_text' );

function localized_return_to_shop_text( $text ) {
    return __( '続けて買い物', 'my-text-domain' );
}

このコードは、国際化のために翻訳可能なテキストを返します。特定のテキストドメインも指定しています。

サンプルコード 5

add_filter( 'woocommerce_return_to_shop_text', 'personalized_return_to_shop' );

function personalized_return_to_shop( $text ) {
    // 特定のユーザーに対してカスタマイズ
    if ( current_user_can( 'subscriber' ) ) {
        return 'あなたのショップに戻る';
    }
    return $text;
}

このサンプルは、特定のユーザー権限を持つユーザーへのカスタマイズされたメッセージを提供します。

概要

総覧

構文