如何通过查询参数自定义WordPress Query Loop块及解决无内容问题

一、添加自定义搜索表单 #

在页面Query Loop块上方插入「自定义HTML」块，添加以下表单代码：

<form method="get" action="">
    <input type="text" name="search_keyword" placeholder="输入关键词搜索..." value="<?php echo isset($_GET['search_keyword']) ? esc_attr($_GET['search_keyword']) : ''; ?>">
    <button type="submit">搜索</button>
</form>

这里使用自定义参数search_keyword而非默认的s，避免与WordPress全局搜索功能冲突。

二、让Query Loop识别搜索参数 #

打开主题的functions.php文件（或使用代码片段插件），添加以下代码修改默认Query Loop的查询逻辑：

add_filter('query_loop_block_query_vars', 'custom_search_filter_query_loop', 10, 3);
function custom_search_filter_query_loop($query_vars, $block, $context) {
    // 仅当存在搜索关键词时修改查询
    if (isset($_GET['search_keyword']) && !empty(trim($_GET['search_keyword']))) {
        $query_vars['s'] = sanitize_text_field($_GET['search_keyword']);
    }
    return $query_vars;
}

如果需要仅作用于特定Query Loop块，可以给目标块添加自定义CSS类（比如search-enabled-loop），然后修改代码增加判断：

add_filter('query_loop_block_query_vars', 'custom_search_filter_query_loop', 10, 3);
function custom_search_filter_query_loop($query_vars, $block, $context) {
    // 检查块是否包含指定CSS类
    $class_name = $block['attrs']['className'] ?? '';
    if (strpos($class_name, 'search-enabled-loop') !== false && isset($_GET['search_keyword']) && !empty(trim($_GET['search_keyword']))) {
        $query_vars['s'] = sanitize_text_field($_GET['search_keyword']);
    }
    return $query_vars;
}

三、修复分页时的搜索参数丢失问题 #

默认分页点击后会丢失搜索关键词，添加以下代码让分页链接自动携带参数：

add_filter('paginate_links', 'custom_pagination_preserve_search_param');
function custom_pagination_preserve_search_param($link) {
    if (isset($_GET['search_keyword']) && !empty(trim($_GET['search_keyword']))) {
        $link = add_query_arg('search_keyword', sanitize_text_field($_GET['search_keyword']), $link);
    }
    return $link;
}

四、解决「从模板继承查询」失效问题 #

开启该选项后Query Loop无内容，是因为模板继承的查询未兼容自定义搜索逻辑，且灵活性较差。建议关闭「从模板继承查询」，直接在Query Loop块的设置中配置基础查询规则（比如选择文章类型、设置分类、每页数量等），再通过上述代码实现过滤功能，逻辑更清晰可控。

验证效果 #

1. 保存页面与代码修改后，访问页面输入关键词搜索，Query Loop将自动展示匹配的文章。
2. 点击分页按钮，搜索参数会自动保留，分页内容也会对应过滤结果。

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