如何为WordPress自定义文章类型实现多条件带分页的搜索功能

第一步：创建前端筛选表单 #

表单使用GET方式提交，可保留筛选参数避免分页时条件丢失，直接放在列表页顶部即可，property替换为你自己注册的自定义文章类型别名：

<!-- 房产筛选表单 -->
<form method="GET" action="<?php echo get_post_type_archive_link('property'); ?>">
    <!-- 房间数量筛选 -->
    <div class="filter-item">
        <label>房间数量</label>
        <select name="room_count">
            <option value="">不限</option>
            <option value="1" <?php selected($_GET['room_count'], '1'); ?>>1室</option>
            <option value="2" <?php selected($_GET['room_count'], '2'); ?>>2室</option>
            <option value="3" <?php selected($_GET['room_count'], '3'); ?>>3室及以上</option>
        </select>
    </div>
    <!-- 可按相同逻辑新增价格、面积等其他筛选字段 -->
    <button type="submit">搜索</button>
</form>

第二步：自定义查询逻辑集成筛选和分页 #

用pre_get_posts钩子修改主查询，无需自己单独写WP_Query，天然兼容WordPress原生分页逻辑，代码放到当前主题的functions.php文件中：

add_action('pre_get_posts', 'custom_property_filter_query');
function custom_property_filter_query($query) {
    // 仅在前台房产列表的主查询生效，不影响后台和其他页面
    if (!is_admin() && $query->is_main_query() && is_post_type_archive('property')) {
        // 每页固定显示10条
        $query->set('posts_per_page', 10);
        
        $meta_query = array();
        // 处理房间数量筛选参数
        if (isset($_GET['room_count']) && !empty($_GET['room_count'])) {
            $room_count = sanitize_text_field($_GET['room_count']);
            if ($room_count == 3) {
                // 匹配3室及以上的情况
                $meta_query[] = array(
                    'key' => 'room_count', // 替换为你自己的自定义字段键名
                    'value' => 3,
                    'compare' => '>=',
                    'type' => 'NUMERIC'
                );
            } else {
                // 匹配指定房间数量的情况
                $meta_query[] = array(
                    'key' => 'room_count',
                    'value' => $room_count,
                    'compare' => '=',
                    'type' => 'NUMERIC'
                );
            }
        }
        // 其他筛选字段可按相同逻辑组装进$meta_query
        
        // 把筛选条件注入查询
        if (!empty($meta_query)) {
            $query->set('meta_query', $meta_query);
        }
    }
}

如果你用单独的页面模板做房产列表，不是自定义文章类型自带的归档页，只需把上面判断条件里的is_post_type_archive('property')替换成is_page('你的列表页别名')，同时把表单的提交地址改成对应列表页的链接即可。

第三步：实现带筛选参数的分页 #

原生分页默认不会携带筛选的GET参数，需要手动把筛选参数加入分页链接，代码放到列表页主循环结束的位置：

// 提取当前所有筛选参数，排除默认分页参数
$filter_params = array_diff_key($_GET, array('paged' => ''));
// 输出带筛选参数的分页
the_posts_pagination(array(
    'mid_size' => 2,
    'prev_text' => '上一页',
    'next_text' => '下一页',
    'add_args' => $filter_params // 把筛选参数拼接进分页链接
));

常见问题排查 #

• 筛选后分页404：先检查自定义文章类型注册时是否开启了has_archive，再到后台「设置-固定链接」点击保存刷新重写规则即可
• 筛选条件不生效：核对pre_get_posts里的自定义文章类型别名、自定义字段键名是否和你实际使用的一致
• 分页后筛选条件丢失：确认表单提交方式为GET，且分页代码中已经添加了add_args参数

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