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

概要

woocommerce_admin_dashboard_recent_reviews フィルタは、WooCommerceの管理ダッシュボード内に表示される最近のレビュー情報をカスタマイズするために使用されます。このフィルタは、レビューの表示方法や内容を変更したい場合に便利です。主に以下のような機能を実装する際に使われます：

最近のレビューの数を制限する
特定の商品のレビューのみを表示する
レビューの順序を変更する
レビューの表示形式をカスタマイズする
ユーザーの評価に基づいてフィルタリングする
コメントの内容をハイライトする

構文

add_filter( 'woocommerce_admin_dashboard_recent_reviews', 'function_name' );

パラメータ

$reviews (配列): 最近のレビュー情報を含む配列。

戻り値

修正されたレビュー情報の配列。

使用可能なバージョン

WooCommerce バージョン: 3.0以上
WordPress バージョン: 4.0以上

サンプルコード

サンプルコード1: 最近のレビューを制限する

add_filter( 'woocommerce_admin_dashboard_recent_reviews', 'custom_limit_recent_reviews' );

function custom_limit_recent_reviews( $reviews ) {
    return array_slice( $reviews, 0, 5 ); // 最初の5件のレビューのみを返す
}

このコードは、最近のレビューを5件に制限します。

サンプルコード2: 特定の商品のレビューのみを表示する

add_filter( 'woocommerce_admin_dashboard_recent_reviews', 'custom_product_reviews_only' );

function custom_product_reviews_only( $reviews ) {
    $filtered_reviews = array();
    foreach ( $reviews as $review ) {
        if ( $review->product_id == 123 ) { // 商品IDが123のレビューのみ
            $filtered_reviews[] = $review;
        }
    }
    return $filtered_reviews;
}

このコードは、特定の商品のレビューのみをダッシュボードに表示します。

サンプルコード3: レビューの順序を変更する

add_filter( 'woocommerce_admin_dashboard_recent_reviews', 'custom_sort_recent_reviews' );

function custom_sort_recent_reviews( $reviews ) {
    usort( $reviews, function( $a, $b ) {
        return strtotime( $b->date_created ) - strtotime( $a->date_created ); // 新しいものから順に並べる
    });
    return $reviews;
}

このコードは、レビューを新しい順に並べ替えます。

サンプルコード4: レビューの表示形式をカスタマイズする

add_filter( 'woocommerce_admin_dashboard_recent_reviews', 'custom_format_reviews' );

function custom_format_reviews( $reviews ) {
    foreach ( $reviews as &$review ) {
        $review->comment_content = strtoupper( $review->comment_content ); // コメント内容を大文字に変換
    }
    return $reviews;
}

このコードは、レビューのコメント内容を大文字にします。

サンプルコード5: 評価に基づいてレビューをフィルタリングする

add_filter( 'woocommerce_admin_dashboard_recent_reviews', 'custom_filter_reviews_by_rating' );

function custom_filter_reviews_by_rating( $reviews ) {
    $filtered_reviews = array();
    foreach ( $reviews as $review ) {
        if ( $review->rating >= 4 ) { // 評価が4以上のレビューのみ
            $filtered_reviews[] = $review;
        }
    }
    return $filtered_reviews;
}

このコードは、評価が4以上のレビューのみを表示します。

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

アクション	使用可能性
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

概要

構文