
本文介绍如何修改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() 及其调用链将自动基于当前语言返回精准的评分分布数据,图表即刻反映真实本地用户评价,提升多语言用户体验与数据可信度。










