WordPress自定义查询变量多值传递及分页重定向问题

1. 正确注册数组型查询变量 #

WordPress默认不会自动解析数组形式的查询变量，需通过parse_query钩子手动处理，确保能正确获取数组值：

add_action('parse_query', 'handle_array_query_vars');
function handle_array_query_vars($query) {
    if (isset($_GET['filter_fabric']) && is_array($_GET['filter_fabric'])) {
        $query->query_vars['filter_fabric'] = array_map('sanitize_text_field', $_GET['filter_fabric']);
    }
}

add_filter('query_vars', 'register_custom_query_vars');
function register_custom_query_vars($vars) {
    $vars[] = 'filter_fabric';
    return $vars;
}

注意：表单中面料筛选的input名称必须设为filter_fabric[]，PHP才会将其解析为数组。

2. 修复分页链接的参数传递 #

paginate_links()函数默认不会保留数组型查询参数，需手动通过add_args传入处理后的数组：

$current_page = get_query_var('paged') ?: 1;
$pagination_args = array(
    'base'      => get_pagenum_link(1) . '%_%',
    'format'    => '?paged=%#%',
    'current'   => max(1, $current_page),
    'total'     => $query->max_num_pages,
    'add_args'  => array(
        'filter_fabric' => $_GET['filter_fabric'] ?? array()
    )
);

echo paginate_links($pagination_args);

WordPress会自动将数组参数格式化为filter_fabric[]=cotton&filter_fabric[]=polyester的合法形式。

3. 禁用重复参数的301重定向 #

WordPress的redirect_canonical函数会自动清理重复参数并触发301重定向，需跳过对filter_fabric的规范处理：

add_filter('redirect_canonical', 'skip_array_var_redirect', 10, 2);
function skip_array_var_redirect($redirect_url, $requested_url) {
    if (strpos($requested_url, 'filter_fabric[]') !== false) {
        return false;
    }
    return $redirect_url;
}

该函数会在WordPress准备执行规范重定向时，判断URL包含数组参数则取消重定向，避免参数丢失。

4. 在pre_get_posts中正确处理数组筛选 #

确保产品筛选逻辑能识别数组参数，用IN比较符匹配多值：

add_action('pre_get_posts', 'filter_products_by_fabric');
function filter_products_by_fabric($query) {
    if (!is_admin() && $query->is_main_query() && is_post_type_archive('product')) {
        $fabric_filters = $query->query_vars['filter_fabric'] ?? array();
        if (is_array($fabric_filters) && !empty($fabric_filters)) {
            $query->set('meta_query', array(
                array(
                    'key'     => 'product_fabric',
                    'value'   => $fabric_filters,
                    'compare' => 'IN'
                )
            ));
        }
    }
}

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