如何为WooCommerce Products短码添加ACF字段排序规则？

WooCommerce自带的[products]短码默认不支持直接将ACF自定义字段作为排序依据，你需要通过钩子扩展短码的排序逻辑，具体步骤如下：

1. 添加自定义排序逻辑代码 #

将以下代码添加到你的WordPress主题（推荐使用子主题）的functions.php文件中，或者自定义功能插件里：

// 扩展Products短码，支持按ACF的rank字段排序
add_filter('woocommerce_shortcode_products_query', 'custom_sort_products_by_acf_rank', 10, 3);
function custom_sort_products_by_acf_rank($query_args, $atts, $loop_name) {
    // 检测短码是否指定orderby为'rank'
    if (isset($atts['orderby']) && $atts['orderby'] === 'rank') {
        // 配置查询参数，按数字类型的ACF字段排序
        $query_args['meta_key'] = 'rank';
        $query_args['orderby'] = 'meta_value_num';
        // 允许通过order参数控制升降序，默认升序
        $query_args['order'] = isset($atts['order']) ? $atts['order'] : 'ASC';
    }
    return $query_args;
}

2. 修改你的短码参数 #

现在可以直接在短码中指定orderby="rank"，还能通过order参数控制排序方向（ASC升序/DESC降序），示例：

[products category="Watches" per_page="18" paginate="true" orderby="rank" order="ASC"]

关键点说明 #

• meta_value_num确保排序时按数字大小而非字符串比较，适配你的rank字段数字类型
• 确认ACF字段的键确实是rank，拼写错误会导致排序失效
• 代码放在子主题或自定义插件中，避免主题更新时丢失修改

内容的提问来源于stack exchange，提问作者junglist