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

概要

woocommerce_rating_filter_count フィルタは、WooCommerceの商品評価に関連するデータのフィルタリングに利用されます。このフィルタは特に、商品一覧や検索結果において特定の評価に基づいた商品の表示数を調整したい場合に便利です。主に次のような機能を実装する際に使用されます。

商品フィルタリング機能のカスタマイズ
評価に基づくおすすめ商品の表示
商品一覧ページのユーザー体験の向上
特定の評価に対する商品の選択肢を狭める
SEO対策としての商品の表示数調整
フロントエンドでの動的な評価表示の改善

フィルタの構文は以下の通りです。

apply_filters( 'woocommerce_rating_filter_count', $count, $rating );

パラメータ

$count：フィルタリングされる商品数
$rating：評価（例えば、星1つから5つまで）

戻り値

このフィルタはフィルタリングされた商品数を返します。

使用可能なバージョン

WooCommerceのバージョン：4.0以上
WordPressのバージョン：5.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_rating_filter_count', 'custom_rating_filter_count', 10, 2 );

function custom_rating_filter_count( $count, $rating ) {
    // 例えば、5つ星の商品のみを表示する
    if ( $rating == 5 ) {
        return $count * 2; // 表示数を2倍にする
    }
    return $count;
}

このサンプルコードは、5つ星の商品の数を2倍にするカスタムフィルタです。

サンプルコード 2

add_filter( 'woocommerce_rating_filter_count', 'limit_product_display_count', 10, 2 );

function limit_product_display_count( $count, $rating ) {
    // 評価が3つ星以上の商品を表示するためには最大50件に制限
    if ( $rating >= 3 ) {
        return min( $count, 50 );
    }
    return $count;
}

このコードでは、3つ星以上の商品が表示される際の最大表示数を50件に制限しています。

サンプルコード 3

add_filter( 'woocommerce_rating_filter_count', 'filter_by_user_role', 10, 2 );

function filter_by_user_role( $count, $rating ) {
    // 管理者であれば、表示数を変更しない
    if ( current_user_can( 'administrator' ) ) {
        return $count;
    }
    // 管理者以外はカウントを半減
    return $count / 2;
}

ここでは、管理者以外のユーザーに対して商品数を半減するロジックを追加しています。

サンプルコード 4

add_filter( 'woocommerce_rating_filter_count', 'dynamic_rating_count_based_on_date', 10, 2 );

function dynamic_rating_count_based_on_date( $count, $rating ) {
    // 商品の公開日によって表示数を変更
    if ( strtotime( get_the_date() ) > strtotime( '-30 days' ) ) {
        return $count + 10; // 最近の商品はさらに10件追加
    }
    return $count;
}

このサンプルは、過去30日以内に公開された商品に対して、表示数を10件増やす機能を実装しています。

サンプルコード 5

add_filter( 'woocommerce_rating_filter_count', 'set_minimum_product_count', 10, 2 );

function set_minimum_product_count( $count, $rating ) {
    // どの評価にもかかわらず、最低表示数は1件
    return max( $count, 1 );
}

このコードは、評価に関わらず最低表示数を1件に制限します。

これらのサンプルコードは、WooCommerceのカスタムフィルタリングに役立ち、それぞれ異なる目的を達成しています。 적정

概要