WooCommerce产品排序问题：AJAX分页后库存排序失效

问题根源 #

WOOF插件的AJAX分页/筛选请求会构建独立查询对象，常规钩子的is_main_query()判断会失效，导致自定义库存排序逻辑未触发；同时WOOF可能重置查询的orderby参数，覆盖自定义排序规则。

解决方案代码 #

1. 兼容AJAX的库存+ACF字段排序逻辑

使用posts_clauses钩子注入排序SQL，同时适配WOOF的AJAX请求：

add_filter('posts_clauses', 'custom_product_stock_acf_sort', 20, 2);
function custom_product_stock_acf_sort($clauses, $query) {
    // 匹配前台产品查询、WOOF的AJAX请求
    $is_valid_query = (!is_admin() && $query->get('post_type') === 'product');
    $is_woof_ajax = isset($_REQUEST['action']) && $_REQUEST['action'] === 'woof_get_posts';

    if (($is_valid_query && $query->is_main_query()) || $is_woof_ajax) {
        global $wpdb;
        
        // 关联库存状态元数据表
        $clauses['join'] .= " LEFT JOIN {$wpdb->postmeta} AS stock_status ON {$wpdb->posts}.ID = stock_status.post_id AND stock_status.meta_key = '_stock_status'";
        // 关联ACF的sorting字段表
        $clauses['join'] .= " LEFT JOIN {$wpdb->postmeta} AS acf_sorting ON {$wpdb->posts}.ID = acf_sorting.post_id AND acf_sorting.meta_key = 'sorting'";
        
        // 排序规则：库存商品优先（instock在前），再按sorting字段数字升序
        $clauses['orderby'] = "FIELD(stock_status.meta_value, 'instock', 'outofstock') ASC, acf_sorting.meta_value+0 ASC";
    }

    return $clauses;
}

2. 阻止WOOF覆盖排序参数

使用WOOF专属钩子woof_pre_get_posts，清理插件默认排序参数避免冲突：

add_action('woof_pre_get_posts', 'custom_woof_reset_sort_params', 10);
function custom_woof_reset_sort_params($query) {
    if (!is_admin() && $query->get('post_type') === 'product') {
        // 清空WOOF自动设置的排序相关参数
        $query->set('meta_key', '');
        $query->set('orderby', '');
    }
}

额外注意事项 #

• 钩子优先级：将posts_clauses优先级设为20（高于默认10），确保在WOOF修改查询后执行，避免被覆盖。
• 数字排序兼容：acf_sorting.meta_value+0确保ACF的sorting字段按数字排序（即使字段存为字符串数字也能生效）。
• WOOF设置检查：在插件后台将「排序选项」设为默认，不要选择固定排序方式，防止插件强制覆盖自定义逻辑。

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