WordPress短代码驱动内容无法被原生搜索检索的解决方案咨询

方案1：将外部内容同步至文章自定义字段（推荐，性能友好） #

核心思路是在文章保存/更新时，解析短代码对应的MD文件内容，将其存入文章的自定义字段，让WordPress搜索能索引到这些内容。

步骤1：添加保存文章时的同步逻辑 #

在functions.php中插入以下代码：

// 保存文章时同步外部MD内容到自定义字段
function sync_external_page_content_to_meta($post_id) {
    // 跳过自动保存和修订版本
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
    if (wp_is_post_revision($post_id)) return;

    // 获取文章内容
    $post_content = get_post_field('post_content', $post_id);
    
    // 提取所有[page]短代码
    preg_match_all('/\[page name="([^"]+)"\]/', $post_content, $matches);
    if (empty($matches[1])) return;

    $combined_content = '';
    $locale = get_locale() === 'fr_FR' ? 'fr' : 'en';

    foreach ($matches[1] as $name) {
        $path = "/content/{$locale}/pages/{$name}.md";
        $file_path = WP_CONTENT_DIR . $path;
        if (file_exists($file_path)) {
            $md_content = file_get_contents($file_path);
            // 可选：去除Markdown标记，转为纯文本减少冗余
            $plain_content = strip_tags(preg_replace('/[#*`[\]]/', '', $md_content));
            $combined_content .= ' ' . $plain_content;
        }
    }

    // 更新自定义字段，字段名可自定义（这里用_external_page_content）
    update_post_meta($post_id, '_external_page_content', trim($combined_content));
}
add_action('save_post', 'sync_external_page_content_to_meta');

步骤2：让搜索包含自定义字段 #

修改WordPress的搜索查询规则，使其包含同步后的自定义字段内容：

// 调整搜索查询，加入自定义字段匹配
function include_external_content_in_search($query) {
    if ($query->is_search() && $query->is_main_query() && !is_admin()) {
        $query->set('meta_query', array(
            'relation' => 'OR',
            array( // 保留原生文章内容匹配
                'key' => 'post_content',
                'value' => $query->get('s'),
                'compare' => 'LIKE'
            ),
            array( // 匹配同步的外部MD内容
                'key' => '_external_page_content',
                'value' => $query->get('s'),
                'compare' => 'LIKE'
            )
        ));
        // 清空原生search参数，避免冲突
        $query->set('search', '');
    }
    return $query;
}
add_action('pre_get_posts', 'include_external_content_in_search');

方案2：实时加载外部内容参与搜索匹配（无数据库存储，性能略低） #

如果不想把内容存入数据库，可在搜索时实时读取对应MD文件，检查是否包含搜索关键词，再过滤结果。适合内容更新频繁但站点规模较小的场景：

function filter_search_results_by_external_content($posts, $query) {
    if (!$query->is_search() || is_admin() || empty($posts)) return $posts;

    $search_term = $query->get('s');
    $locale = get_locale() === 'fr_FR' ? 'fr' : 'en';
    $valid_post_ids = array();

    foreach ($posts as $post) {
        // 先检查文章本身是否匹配原生搜索逻辑
        $post_matches = stripos($post->post_content, $search_term) !== false;
        
        // 再检查短代码对应的外部MD内容
        preg_match_all('/\[page name="([^"]+)"\]/', $post->post_content, $matches);
        if (!empty($matches[1])) {
            foreach ($matches[1] as $name) {
                $path = "/content/{$locale}/pages/{$name}.md";
                $file_path = WP_CONTENT_DIR . $path;
                if (file_exists($file_path)) {
                    $md_content = file_get_contents($file_path);
                    if (stripos($md_content, $search_term) !== false) {
                        $post_matches = true;
                        break;
                    }
                }
            }
        }

        if ($post_matches) {
            $valid_post_ids[] = $post->ID;
        }
    }

    // 过滤出符合条件的文章
    return array_filter($posts, function($post) use ($valid_post_ids) {
        return in_array($post->ID, $valid_post_ids);
    });
}
add_filter('posts_results', 'filter_search_results_by_external_content', 10, 2);

方案3：WP CLI定期同步内容（适合静态内容） #

如果MD内容更新不频繁，可写WP CLI脚本定期遍历含[page]短代码的文章，同步内容到自定义字段。示例脚本（保存为sync-external-content.php）：

<?php
if (!defined('WP_CLI')) {
    exit;
}

WP_CLI::add_command('sync-external-content', function() {
    $args = array(
        'post_type' => 'post',
        'posts_per_page' => -1,
        's' => '[page', // 筛选包含目标短代码的文章
    );
    $posts = get_posts($args);
    $locale = get_locale() === 'fr_FR' ? 'fr' : 'en';

    foreach ($posts as $post) {
        preg_match_all('/\[page name="([^"]+)"\]/', $post->post_content, $matches);
        if (empty($matches[1])) continue;

        $combined_content = '';
        foreach ($matches[1] as $name) {
            $path = "/content/{$locale}/pages/{$name}.md";
            $file_path = WP_CONTENT_DIR . $path;
            if (file_exists($file_path)) {
                $md_content = file_get_contents($file_path);
                $plain_content = strip_tags(preg_replace('/[#*`[\]]/', '', $md_content));
                $combined_content .= ' ' . $plain_content;
            }
        }

        update_post_meta($post->ID, '_external_page_content', trim($combined_content));
        WP_CLI::success("Synced post {$post->ID}: {$post->post_title}");
    }
});

使用时在终端执行：wp sync-external-content，可配合服务器cron定期运行。

注意事项 #

• 方案1需注意：若MD内容更新，需重新保存对应文章（或用方案3定期同步）才能让搜索索引到新内容。
• 方案2每次搜索都会读取文件，文件数量多或内容较大时会影响性能，适合小站点使用。
• 多语言场景下，若需搜索所有语言的内容，可调整逻辑读取对应语言版本的文件，或保存多语言版本的自定义字段。

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