为子比主题 WordPress 站点提供智能自动内链功能，自动将文章中的关键词链接到相关文章或指定页面。

版本: 1.3.0 作者: 小武网站: https://1z345.cn

功能特点

核心功能

智能关键词提取: 自动提取文章的标签、分类名称作为内链关键词
自定义关键词: 支持添加自定义关键词及其目标链接
批量文章查询: 一次查询获取所有相关文章，显著提升性能
智能链接替换: 安全替换，避免在 HTML 标签、已有链接内重复添加

性能优化

Transients 缓存: 内链数据缓存 2 小时，减少数据库查询
批量查询: 使用 `tax_query` 一次查询匹配所有关键词的文章
按匹配度排序: 优先链接匹配度最高的文章
设置缓存: 静态变量缓存设置，减少 `get_option` 调用

安全特性

rel=”nofollow”: 防止搜索引擎传递权重
rel=”noopener”: 防止新窗口安全漏洞
target=”_blank”: 可选的新标签页打开
防注入检查: 检查是否已在链接中，避免嵌套链接
HTML 边界检测: 避免在 HTML 标签内部插入链接

中文优化

完美中文支持: 使用 `mb_strlen`、`strpos` 处理中文
无正则边界问题: 避免 Unicode `\b` 与中文不兼容的问题
多重检测机制: 支持多种单文章页面检测方式

样式选项

下划线样式: 经典下划线效果
背景高亮: 浅色背景突出显示
渐变效果: 渐变背景更美观
夜间模式: 自动适配子比主题夜间模式

安装方法

方式一：WordPress 后台上传

下载插件文件夹
在 WordPress 后台「插件」→「安装插件」→「上传插件」
上传 ZIP 文件并启用

方式二：FTP/SFTP 上传

将插件文件夹上传到 `/wp-content/plugins/zib-auto-link/`
在 WordPress 后台「插件」页面启用

使用说明

1. 插件设置

在 WordPress 后台「设置」→「自动内链配置」中进行配置：

设置项	说明	默认值
最小内链数	文章必须包含的最小内链数	2
最大内链数	文章最多显示的内链数	5
最小文章长度	只有超过此长度的文章才会添加内链	200 字符
缓存时间	内链数据缓存有效期（小时）	2 小时
链接样式	选择内链的显示样式	下划线
新标签页打开	内链在新标签页打开	开启
添加 nofollow	为内链添加 nofollow 属性	开启
添加 noopener	为内链添加 noopener 属性	开启
显示相关推荐	文章底部显示相关阅读推荐	开启
排除分类	不添加内链的分类（多选）	无

2. 自定义关键词

支持两种格式：

JSON 数组: `[“关键词1″,”关键词2”]`
换行分隔: 每行一个关键词

3. 链接样式

插件提供 5 种样式：

`underline` – 下划线样式（默认）
`highlight` – 背景高亮
`gradient` – 渐变背景
`badge` – 徽章样式
`none` – 无特殊样式

工作原理

处理流程

文章内容 → 检查是否单文章页面 ↓ 是获取关键词（标签+分类+自定义） ↓ 批量查询相关文章（按标签/分类匹配） ↓ 按匹配度排序 ↓ 安全替换关键词为链接 ↓ 可选：添加相关阅读推荐

关键词匹配规则

自动提取当前文章的标签名称
自动提取当前文章的分类名称
读取自定义关键词
关键词长度 ≥ 2 个字符

链接目标选择

查询与当前文章共享标签/分类的文章
按匹配关键词数量排序（匹配越多越优先）
选择匹配度最高的文章作为链接目标

模板标签

清除内链缓存

// 在主题或插件中调用 if (function_exists(‘zib_auto_link_clear_cache’)) { zib_auto_link_clear_cache(); }

常见问题

Q: 内链没有生效？

检查文章是否为「已发布」状态
检查文章长度是否达到最小要求
清除浏览器缓存或 CDN 缓存
在文章中添加对应的标签或分类

Q: 内链数量不对？

检查是否在排除分类中
检查缓存设置，可减少缓存时间
确认其他插件没有干扰

Q: 如何调试？

确认文章包含对应的标签或分类
检查 WordPress 调试日志
临时关闭缓存进行测试

更新日志

v1.3.0 (2026-05-18)

优化中文关键词匹配算法
修复批量查询返回空结果的问题
增强单文章页面检测（5 种方式）
简化安全替换逻辑，使用字符串操作替代复杂正则
添加 5 种链接样式选项
优化夜间模式适配

v1.2.0

添加自定义关键词功能
添加缓存机制
优化性能

v1.1.0

添加排除分类功能
优化安全检查

v1.0.0

初始版本发布

文件结构

zib-auto-link/ ├── zib-auto-link.php # 插件主文件 ├── includes/ │ ├── functions.php # 核心功能 │ └── admin.php # 管理界面 ├── assets/ │ └── style.css # 样式文件 └── README.md # 说明文档

兼容性

WordPress: 5.0+
PHP: 7.4+
主题主题主题主题主题主题: 子比主题（Zibll Theme）
其他主题: 理论上支持所有 WordPress 主题

许可证

GPL2

本网站部分文件及内容来自互联网，版权归原作者所有。转载需授权，侵权必究。部分内容受《网络出版服务管理规定》保护，未经许可禁止商业使用。

THE END

子比主题 – 自动内链插件