指定自定义文章类型weblinks的WP Query搜索功能失效

看起来你的问题出在自定义文章类型（Weblinks）的搜索支持配置上，或者是全局搜索查询被过滤掉了这个类型。下面分几种情况给出解决方案：

1. 检查自定义文章类型的注册参数 #

首先确认你注册weblinks这个自定义文章类型时，是否开启了搜索支持。注册时需要确保以下参数正确设置：

register_post_type( 'weblinks', array(
    'public' => true, // 必须设为true，才能让文章类型公开可访问和搜索
    'exclude_from_search' => false, // 明确设置为false，允许该类型被包含在搜索结果中
    'supports' => array( 'title', 'editor', 'excerpt' ), // 确保支持标题、内容这些搜索会检索的字段
    // 其他注册参数（比如标签、分类法等）...
) );

如果之前注册时没加exclude_from_search，默认情况下当public为true时，这个参数会自动设为false，但手动明确设置能避免潜在问题。

2. 检查是否有全局搜索过滤规则 #

很多主题或插件会通过pre_get_posts钩子修改全局搜索的文章类型范围，可能不小心把weblinks排除了。你可以检查主题的functions.php文件，或者已激活的插件代码，有没有类似这样的函数：

function exclude_post_types_from_search( $query ) {
    if ( $query->is_search && !is_admin() ) {
        $query->set( 'post_type', array( 'post' ) ); // 只保留默认文章类型，排除了weblinks
    }
    return $query;
}
add_action( 'pre_get_posts', 'exclude_post_types_from_search' );

如果存在这样的代码，修改它把weblinks加入允许的文章类型列表：

function include_weblinks_in_search( $query ) {
    if ( $query->is_search && !is_admin() ) {
        $query->set( 'post_type', array( 'post', 'weblinks' ) ); // 添加weblinks到搜索范围
    }
    return $query;
}
add_action( 'pre_get_posts', 'include_weblinks_in_search' );

3. 调试查询语句确认问题 #

如果上面的方法都没解决，你可以打印出WP_Query生成的SQL语句，看看具体哪里出了问题。在你的代码里添加一行调试代码：

$my_query = new WP_Query ($args);
echo '<pre>' . $my_query->request . '</pre>'; // 打印SQL语句

查看输出的SQL，确认WHERE子句里是否包含post_type = 'weblinks'，以及搜索条件（LIKE '%搜索关键词%'）是否正确应用到了标题、内容等字段。

4. 刷新固定链接（可选） #

有时候注册自定义文章类型后，固定链接规则没有更新，可能导致查询异常。你可以进入WordPress后台的设置 → 固定链接页面，直接点击「保存更改」按钮，不需要修改任何设置，这样就能刷新重写规则。

最后，记得修改代码后清空缓存，确保新的设置生效。

内容的提问来源于stack exchange，提问作者F-M-A