如何自动将WordPress文章元数据及内容词汇链接至glossary自定义文章标题？

嘿，这个需求太实用了！能让你的站点术语自动关联到释义页，用户体验直接拉满。我给你整理了一套可落地的实现步骤，都是用WordPress原生钩子来做的，不用额外插件：

核心思路 #

通过WordPress的过滤器钩子，在文章内容（the_content）和元数据输出时，自动匹配术语表（glossary自定义文章类型）的标题，将其替换为指向对应术语页的链接。同时加入缓存机制避免重复查询数据库，保证性能。

第一步：获取并缓存所有术语表条目 #

先写一个函数来获取所有已发布的术语表文章，并且缓存结果，避免每次页面加载都查数据库：

function get_glossary_terms() {
    // 尝试从缓存获取术语列表，1小时后过期
    $glossary_map = wp_cache_get('glossary_terms');
    
    if (false === $glossary_map) {
        // 从数据库获取所有已发布的glossary文章
        $glossary_posts = get_posts([
            'post_type'      => 'glossary',
            'posts_per_page' => -1,
            'post_status'    => 'publish',
            'fields'         => 'ids' // 只获取ID，后续按需取标题和链接更高效
        ]);
        
        $glossary_map = [];
        foreach ($glossary_posts as $post_id) {
            $term_title = get_the_title($post_id);
            $term_link  = get_permalink($post_id);
            $glossary_map[$term_title] = $term_link;
        }
        
        // 将结果存入缓存，有效期1小时（3600秒）
        wp_cache_set('glossary_terms', $glossary_map, '', 3600);
    }
    
    return $glossary_map;
}

第二步：自动替换文章内容中的术语 #

用the_content过滤器，把文章内容里的术语替换成带链接的版本，同时避免重复替换已经是链接的术语：

function auto_link_glossary_in_content($content) {
    // 只在普通文章页面执行，排除术语表自身页面和归档页
    if (!is_single() || is_singular('glossary')) {
        return $content;
    }
    
    $glossary_terms = get_glossary_terms();
    if (empty($glossary_terms)) {
        return $content;
    }
    
    // 按术语标题长度倒序排序，避免短术语先替换长术语的部分内容
    uksort($glossary_terms, function($a, $b) {
        return strlen($b) - strlen($a);
    });
    
    $pattern = [];
    $replace = [];
    
    foreach ($glossary_terms as $title => $link) {
        // 转义正则特殊字符
        $escaped_title = preg_quote($title, '/');
        // 匹配不在<a>标签内的完整术语（避免部分匹配）
        $pattern[] = '/\b(' . $escaped_title . ')\b(?![^<]*<\/a>)/i';
        // 替换为带样式的链接
        $replace[] = '<a href="' . esc_url($link) . '" class="glossary-term" title="查看「' . esc_attr($title) . '」的释义">$1</a>';
    }
    
    // 执行替换
    return preg_replace($pattern, $replace, $content);
}
add_filter('the_content', 'auto_link_glossary_in_content');

第三步：自动替换文章元数据中的术语 #

如果你需要处理文章的元数据（比如自定义字段、文章摘要等），可以用get_post_metadata过滤器，指定你要处理的元字段键名：

function auto_link_glossary_in_metadata($value, $meta_key, $post_id) {
    // 这里替换成你需要处理的元字段键名，比如'article_tags'、'custom_summary'
    $target_meta_keys = ['your_meta_key_1', 'your_meta_key_2'];
    
    if (!in_array($meta_key, $target_meta_keys)) {
        return $value;
    }
    
    $glossary_terms = get_glossary_terms();
    if (empty($glossary_terms)) {
        return $value;
    }
    
    uksort($glossary_terms, function($a, $b) {
        return strlen($b) - strlen($a);
    });
    
    $pattern = [];
    $replace = [];
    
    foreach ($glossary_terms as $title => $link) {
        $escaped_title = preg_quote($title, '/');
        $pattern[] = '/\b(' . $escaped_title . ')\b/i';
        $replace[] = '<a href="' . esc_url($link) . '" class="glossary-term" title="查看「' . esc_attr($title) . '」的释义">$1</a>';
    }
    
    return preg_replace($pattern, $replace, $value);
}
add_filter('get_post_metadata', 'auto_link_glossary_in_metadata', 10, 3);

额外优化建议 #

• 样式区分：给术语链接加的glossary-term类，可以在主题CSS里添加样式，比如：

  .glossary-term {
      color: #2563eb;
      text-decoration: underline dotted;
  }
  .glossary-term:hover {
      text-decoration: underline solid;
  }
  

• 缓存更新：如果你的术语表更新频繁，可以在发布/更新glossary文章时清除缓存，比如添加：

  function clear_glossary_cache_on_save($post_id) {
      if (get_post_type($post_id) === 'glossary') {
          wp_cache_delete('glossary_terms');
      }
  }
  add_action('save_post', 'clear_glossary_cache_on_save');
  

• 排除特定内容：如果有部分内容不想被替换，可以给容器加特定class，比如<div class="no-glossary">...</div>，然后在正则里排除这些区域，需要稍微调整正则逻辑。

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