友情链接运维
独立友情链接插件：支持自助申请、人工审核、定时巡检对方是否挂载本站链接；前台展示在右侧栏下方。
免费
详情介绍
一、插件简介
友情链接（friends）在 广场首页右侧栏底部 展示已通过友链，支持用户 自助申请、后台审核与 互链巡检（检测对方页面是否包含本站域名/关键词）。连续巡检失败可自动下架。
二、核心能力
| 能力 | 说明 |
|---|---|
| 侧栏展示 | 插槽 plaza_right_bottom（仅 plaza_home 广场首页） |
| 自助申请 | 网站名称 + 域名；弹窗或 /friends/apply |
| 人工审核 | 可配置提交后待审或直接展示 |
| 互链检测 | 提交后及定时巡检拉取对方页面，匹配关键词 |
| 自动下架 | 连续失败达配置次数后自动下架（可设为 0 只记录） |
| 后台管理 | 增删改、审核、手动巡检、排序、上下架 |
三、依赖与安装
建议环境：
安装步骤：
数据表：
friends_link：友链记录（状态、巡检结果、失败次数等）四、应用中心基础配置
路径：应用中心 → 友情链接 → 配置
| 配置项 | 说明 | 建议 |
|---|---|---|
| 启用友情链接 | 关闭后前台不展示、不可申请 | 开启 |
| 开放自助申请 | 关闭后仅后台可添加 | 按需 |
| 申请需登录 | 游客不可提交 | 建议开启 |
| 人工审核 | 开启则提交后待审；关闭则直接展示 | 建议开启 |
| 侧栏标题 | 右侧区块标题 | 友情链接 |
| 侧栏显示条数 | 最多展示已通过友链数 | 12 |
| 本站识别关键词 | 每行一条；巡检对方页是否包含 | 留空则用域名+站点名 |
| 巡检间隔(小时) | 定时任务间隔 | 24 |
| 连续失败下架次数 | 0=只记录不自动下架 | 3 |
| Web 巡检密钥 | /friends/cron?key= 触发巡检；留空禁用 Web | 建议设置 |
五、后台重点配置
路径：插件列表 → 友情链接
| 操作 | 说明 |
|---|---|
| 新增/编辑 | 名称、URL、Logo、简介、联系方式、排序 |
审核 audit | 待审 → 通过/拒绝（可填拒绝原因） |
状态 status | 展示/下架/拒绝等 |
巡检 check | 单条或批量检测互链 |
| 删除 | 删除记录 |
状态说明： 0 待审、1 展示、2 拒绝、3 下架。
六、前台用户流程
七、后台审核与运维
| 任务 | 说明 |
|---|---|
| 审核新申请 | 核对站点质量与互链 |
| 定时巡检 | 计划任务访问 /friends/cron?key=密钥 或命令行 php think friends:check |
| 处理下架 | 巡检失败累计达阈值自动下架；可手动恢复 |
| 排序 | 调小 sort 让重要友链靠前 |
巡检逻辑：FriendsService::checkOne HTTP 拉取对方页，匹配 site_keywords 或自动域名/站点名。
八、特殊说明
8.1 前台路由
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /friends | 友链页（若有） |
| GET | /friends/apply | 申请页 |
| POST | /friends/submit | 提交申请 |
| GET | /friends/cron | Web 巡检（需 key） |
8.2 钩子
renderSlot('plaza_right_bottom')：仅 ctx['plaza_home'] 为真时输出renderAssets()：申请弹窗 HTML + friends-modal.css + 内联提交脚本8.3 展示位置说明
友链挂在 右侧栏底部（FriendsService::renderAsideHtml('right')）；移动抽屉不再挂友链（公告区替代）。
九、推荐上线清单
十、常见问题
Q：侧栏看不到友链？ 仅 广场首页 展示；需已通过记录或开放申请按钮。检查 enabled 与 plaza_home 上下文。
Q：提交后一直不显示？ 可能待审；或互链检测失败但未阻断展示（人工审核仍须后台通过）。
Q：巡检总是失败？ 对方未加链接、页面需登录、防火墙拦截、关键词不匹配；调整 site_keywords。
Q：cron 无效？ cron_key 留空会禁用 Web 入口；URL 需带正确 key 参数。
Q：重复域名无法申请？ 同 URL 在待审或已通过状态下不可重复提交。
更新记录 （1）
-
v1.0.1
2026-08-24
首次发布