WordPress 优化：为文章标签自动添加内链（修正版）

文章内链的重要性

对于关注 SEO 的站长而言，文章内链的重要性不言而喻。合理的内部链接结构有助于引导页面权重的传递，促进搜索引擎收录，并提升内页在搜索结果中的排名。

实现自动内链的方法

为 WordPress 文章中的关键词（标签）自动添加内链，通常可以通过在主题的 functions.php 文件中添加自定义函数来实现。然而，网络上流传的许多代码片段可能存在错误或已过时。

原始代码的问题

您提供的原始代码存在多处语法错误和逻辑问题，例如：

• 变量 $ex_word 未定义。
• 正则表达式模式字符串拼接错误，包含未转义的特殊字符和无效的占位符（如 {5cc1b29162d549a8071384de182cc9fc6e6a0fd85e7907f22fd9e18cff4269c3}）。
• preg_replace 调用中的 $case 变量未定义。
• 代码试图排除 <a> 和 <img> 标签内的关键词，但逻辑复杂且可能失效。

直接使用这段代码很可能导致网站错误或功能异常。

修正与优化后的代码

以下是一个修正并优化后的版本，它更清晰、更健壮，并添加了详细的注释：

/**
 * WordPress 文章标签关键词自动添加内链
 * 将文章内容中出现的标签名称，自动替换为指向该标签归档页的链接。
 */
function auto_tag_internal_link($content) {
    // 配置参数
    $match_num_from = 1; // 一个标签至少出现几次才添加链接
    $match_num_to   = 1; // 一个标签最多添加几次链接

    // 获取当前文章的所有标签
    $post_tags = get_the_tags();
    if (empty($post_tags)) {
        return $content; // 没有标签则直接返回内容
    }

    // 按标签名称长度降序排序，优先替换长标签，避免短标签成为长标签的一部分而被错误替换
    usort($post_tags, function($a, $b) {
        return strlen($b->name) - strlen($a->name);
    });

    // 遍历每个标签进行处理
    foreach ($post_tags as $tag) {
        $tag_name = $tag->name;
        $tag_link = get_tag_link($tag->term_id);

        // 构建替换用的链接HTML
        $link_html = sprintf(
            '<a href="%s" title="查看更多关于“%s”的文章">%s</a>',
            esc_url($tag_link),
            esc_attr($tag_name),
            esc_html($tag_name)
        );

        // 对标签名进行正则转义，用于构建模式
        $escaped_tag_name = preg_quote($tag_name, '/');

        /**
         * 核心正则表达式解释：
         * (?!<[^>]*>)      - 负向前瞻，确保匹配位置不在任何HTML标签内部（如 <a>, <strong> 等）
         *                  - 单词边界，确保匹配完整的单词
         * (%s)               - 占位符，将被替换为转义后的标签名
         *                  - 单词边界
         * (?![^<]*</a>)    - 负向后顾，确保匹配位置不在一个 </a> 闭合标签之前（即不在一个链接内）
         * /iu                - 修饰符：i(不区分大小写), u(支持UTF-8)
         */
        $pattern = '/(?!<[^>]*>)b(' . $escaped_tag_name . ')b(?![^<]*</a>)/iu';

        // 随机决定本次替换次数（在设定的范围内）
        $limit = rand($match_num_from, $match_num_to);

        // 执行替换
        $content = preg_replace($pattern, $link_html, $content, $limit);
    }

    return $content;
}
// 将函数挂载到‘the_content’过滤器，优先级设为12（在短代码解析等之后运行）
add_filter('the_content', 'auto_tag_internal_link', 12);

代码说明与使用建议

1. 安全性：使用 esc_url(), esc_attr(), esc_html() 函数对输出进行转义，提高了安全性。
2. 准确性：通过复杂的正则表达式，确保只替换纯文本中的关键词，而不会破坏已有的HTML标签（尤其是已有的链接）。
3. 性能：对标签按长度排序，并设置了替换次数上限，有助于控制性能开销。
4. 使用方法：将以上代码添加到您当前主题的 functions.php 文件末尾。保存后，新发布的文章内容中的标签名将会自动添加内链。
5. 注意事项：
   • 此功能会影响页面生成速度，如果标签或文章内容非常长，请酌情使用。
   • 建议在添加此功能后，检查网站前台页面，确保替换效果符合预期，没有破坏页面布局。
   • 可以考虑添加缓存机制，或仅在特定页面（如单篇文章）启用此过滤器以优化性能。

提示：对于更高级或生产环境的需求，建议考虑使用成熟的SEO插件（如Rank Math、SEOPress、AIOSEO等），它们通常提供更完善、可配置且经过充分测试的内链（内部链接）功能。