WordPress搜索结果替换：显示PDF而非自定义文章类型文档

以下是针对性的解决方案，直接修改现有逻辑实现需求：

1. 过滤搜索查询（确保只返回带PDF的文档条目） #

将以下代码添加到主题的functions.php文件中，确保搜索documents类型时，仅返回已上传PDF的条目：

add_action('pre_get_posts', 'filter_document_search_query');
function filter_document_search_query($query) {
    if (!is_admin() && $query->is_search && isset($_GET['post_type'])) {
        $post_types = (array)$_GET['post_type'];
        // 当搜索包含documents类型时，过滤出有PDF的条目
        if (in_array('documents', $post_types)) {
            $meta_query = $query->get('meta_query', []);
            $meta_query[] = [
                'key' => 'eof-doc',
                'compare' => 'EXISTS'
            ];
            $query->set('meta_query', $meta_query);
        }
    }
    return $query;
}

2. 修改search.php渲染逻辑，直接输出PDF链接 #

打开主题的search.php文件，替换原有的循环渲染代码，区分普通文章和自定义文档类型的展示：

<?php if ( have_posts() ) : ?>
    <?php while ( have_posts() ) : the_post(); ?>
        <?php if ( get_post_type() === 'documents' ) : ?>
            <?php $pdf_url = get_field('eof-doc'); ?>
            <?php if ( $pdf_url ) : ?>
                <div class="search-result document-pdf">
                    <h3><a href="<?php echo esc_url($pdf_url); ?>" target="_blank"><?php the_title(); ?></a></h3>
                    <p><?php the_excerpt(); ?></p>
                    <span class="pdf-tag">PDF 文件</span>
                </div>
            <?php endif; ?>
        <?php else : ?>
            <!-- 普通新闻文章的原有展示逻辑 -->
            <div class="search-result post">
                <h3><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
                <p><?php the_excerpt(); ?></p>
            </div>
        <?php endif; ?>
    <?php endwhile; ?>
<?php else : ?>
    <p>未找到匹配的搜索结果</p>
<?php endif; ?>

这段代码的核心逻辑：

• 检测当前搜索结果条目是否为documents类型
• 若是，直接读取ACF字段eof-doc的PDF链接，输出可直接跳转的链接（target="_blank"让PDF在新窗口打开）
• 保留普通post类型的原有展示逻辑

3. 适配多选搜索的参数传递 #

如果你的搜索表单是多选框（同时可选文章和文档），确保表单提交的post_type参数为数组格式（例如post_type[]=post&post_type[]=documents），上述代码已兼容这种情况。

注意事项 #

• 确认ACF字段键名eof-doc与你创建的字段完全一致，避免拼写错误
• 使用esc_url()处理PDF链接，保证站点安全
• 可通过.document-pdf类名添加自定义CSS样式，区分PDF结果与普通文章结果

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