17370845950

WooCommerce评论统计图表:按WPML当前语言筛选评分数据

本文介绍如何修改woocommerce评论统计图表代码,使其仅统计当前wpml激活语言下的产品评论,避免跨语言混计,确保多语言站点的评分图表准确反映本地化用户反馈。

在使用 WPML 构建多语言 WooCommerce 站点时,原生的评论统计逻辑(如基于直接 SQL 查询 wp_commentmeta 的方式)会汇总全站所有语言的评论,导致评分图表失真——例如英文版页面却显示了中文、西班牙语等其他语言用户的评分。根本原因在于原始 SQL 查询未关联语言上下文,也未遵循 WPML 的语言过滤机制。

要实现「仅统计当前语言评论」,关键在于弃用硬编码 SQL 查询,转而使用 WordPress 原生且 WPML 兼容的 WP_Comment_Query 接口。WPML 会自动为 WP_Comment_Query 注入语言上下文(通过 icl_object_id 和 wpml_language 过滤),前提是评论对象已正确注册为 WPML 可翻译内容(WooCommerce 产品评论默认支持)。

以下是核心改造方案:

✅ 替换 get_all_product_review_ratings() 函数(推荐实现)

function get_all_product_review_ratings() {
    global $wpdb;

    // 使用带语言上下文的 transient key,避免不同语言共用缓存
    $lang_code = defined('ICL_LANGUAGE_CODE') ? ICL_LANGUAGE_CODE : 'all';
    $transient_key = 'all_product_review_ratings_' . $lang_code;

    if (false === ($review_ratings = get_transient($transient_key))) {
        $review_ratings = array();
        $args = array(
            'status'      => 'approve',
            'type'        => 'review',
            'number'      => 0, // 获取全部(不限数量)
            'meta_query'  => array(
                array(
                    'key'   => 'rating',
                    'compare' => 'EXISTS'
                )
            )
        );

        // WP_Comment_Query 自动应用 WPML 语言过滤
        $comments_query = new WP_Comment_Query();
        $comments = $comments_query->query($args);

        foreach ($comments as $comment) {
            $rating = get_comment_meta($comment->comment_ID, 'rating', true);
            if (is_numeric($rating) && $rating >= 1 && $rating <= 5) {
                $review_ratings[] = (int) $rating;
            }
        }

        $expiration = 5 * MINUTE_IN_SECONDS; // 缓存 5 分钟
        set_transient($transient_key, $review_ratings, $expiration);
    }

    return $review_ratings;
}

? 关键改进说明

  • 语言感知查询:WP_Comment_Query 在 WPML 激活时自动添加语言条件(如 JOIN wp_icl_translations ... WHERE element_type = 'comment_comment' AND language_code = 'en'),无需手动拼接 SQL。
  • 动态缓存键:使用 ICL_LANGUAGE_CODE 作为 transient key 后缀(如 all_product_review_ratings_en),确保每种语言拥有独立缓存,避免交叉污染。
  • 健壮性增强:显式检查 rating 元字段是否存在,并验证数值范围(1–5),防止脏数据干扰统计。
  • 移除冗余逻辑:不再依赖 verified = 1 条件(该字段非 WooCommerce 标准,若业务需要请确认其存在性并保留)。

⚠️ 注意事项

  • 确保 WPML 已启用「Comments」翻译支持(WPML → Translation Management → Translation Options → Comments)。
  • 若评论未与产品正确关联(如缺失 comment_post_ID 或产品未被 WPML 翻译),仍可能漏计;建议检查 wp_comments.comment_post_ID 是否指向当前语言的产品 ID(可通过 icl_object_id($post_id, 'product', false, $lang) 验证)。
  • 如需进一步优化性能,可考虑将统计逻辑移至后台异步任务(如 WP Cron),或对高频访问页面启用对象缓存(Redis/Memcached)。

完成上述替换后,display_all_product_review_histogram() 及其调用链将自动基于当前语言返回精准的评分分布数据,图表即刻反映真实本地用户评价,提升多语言用户体验与数据可信度。