用户浏览商品数统计短代码实现方法

本文详解了如何利用 WooCommerce 原生的浏览记录机制，安全、精准地统计当前用户最近浏览的商品数量，并封装成灵活易用的 `[recently_count]` 短代码——它能自动解析并清理 `woocommerce_recently_viewed` Cookie 中的商品 ID，过滤非法值、去重并支持可选数量限制，适用于主题模板、古腾堡编辑器及各类钩子；同时特别强调了常见陷阱（如误对字符串调用 count）、缓存兼容性方案及 GDPR/CCPA 合规要点，让开发者无需改动现有追踪逻辑即可开箱即用，兼顾准确性、安全性与扩展性。

本文介绍如何基于 WooCommerce 原生浏览记录机制，准确获取当前用户最近浏览的商品数量，并封装为可复用的 [recently_count] 短代码，支持主题模板、页面编辑器及钩子中灵活调用。

本文介绍如何基于 WooCommerce 原生浏览记录机制，准确获取当前用户最近浏览的商品数量，并封装为可复用的 `[recently_count]` 短代码，支持主题模板、页面编辑器及钩子中灵活调用。

WooCommerce 默认通过 woocommerce_recently_viewed Cookie 存储用户最近浏览的商品 ID（以 | 分隔），但原生并未提供直接获取数量的接口。要实现「显示已浏览商品总数」的功能（例如在页眉提示“您已浏览 7 件商品”），关键在于安全解析 Cookie 并统计有效商品 ID 数量，而非简单计算字符串长度或错误使用 count() 作用于字符串。

以下是一个健壮、可直接集成的短代码实现：

/**
 * 获取当前用户最近浏览商品数量的短代码 [recently_count]
 * 支持过滤：可选参数 'limit' 限制统计上限（如 [recently_count limit="10"]）
 */
function dorzki_recently_viewed_count_shortcode( $atts ) {
    $atts = shortcode_atts(
        array(
            'limit' => null,
        ),
        $atts,
        'recently_count'
    );

    // 检查 Cookie 是否存在且非空
    if ( empty( $_COOKIE['woocommerce_recently_viewed'] ) ) {
        return '0';
    }

    // 安全解析 Cookie：去除空格、过滤非数字 ID、去重（可选）
    $raw_ids = explode( '|', wp_unslash( $_COOKIE['woocommerce_recently_viewed'] ) );
    $viewed_ids = array_filter(
        array_map( 'absint', $raw_ids ), // 强制转为正整数，过滤非法值
        function( $id ) { return $id > 0; }
    );

    // 去重并保持顺序（避免重复访问导致冗余计数）
    $viewed_ids = array_values( array_unique( $viewed_ids ) );

    // 应用可选限制
    if ( is_numeric( $atts['limit'] ) && $atts['limit'] > 0 ) {
        $viewed_ids = array_slice( $viewed_ids, 0, (int) $atts['limit'] );
    }

    return (string) count( $viewed_ids );
}
add_shortcode( 'recently_count', 'dorzki_recently_viewed_count_shortcode' );

✅ 使用方式示例：

• [recently_count] → 输出全部浏览数（最多 15，取决于追踪逻辑）
• [recently_count limit="5"] → 仅统计最近 5 个

⚠️ 重要注意事项：

• 不要对 $ids 字符串使用 count()：原始答案中 count($ids) 是错误的（$ids 是逗号分隔字符串，count() 返回 1），应始终对解析后的数组调用 count()。
• 务必校验与过滤 ID：Cookie 可被客户端篡改，必须用 absint() 和 array_filter() 清理无效值，防止 SQL 注入或逻辑异常。
• 注意缓存兼容性：若启用全站静态缓存（如 WP Super Cache），短代码可能被缓存为固定值。建议配合 AJAX 或 wp_localize_script 动态加载，或禁用该区域缓存。
• 隐私合规提示：该功能依赖 Cookie，在 GDPR/CCPA 合规站点中，需确保用户已同意存储偏好类 Cookie，并在隐私政策中明确说明用途。

此方案与您已有的追踪逻辑完全兼容，无需修改原有 dorzki_wc_track_product_views() 函数，即可开箱即用，精准、安全、可扩展。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《用户浏览商品数统计短代码实现方法》文章吧，也可关注golang学习网公众号了解相关技术文章。