Surl 外链管理插件 · 使用说明

适用版本：v1.2 ｜环境：Typecho 1.2+ / 1.3，PHP 7.4+（兼容 8.3）
简单介绍：把站点所有外部链接统一管理起来 —— 每条链接一个固定跳转地址 + 二维码，改目标不换码，前台自带链接导航页，写文章时一键插入。

一、安装与启用

解压 Surl.zip，将 Surl 文件夹上传至站点 usr/plugins/ 目录
进入 控制台 → 插件，找到「Surl 外链管理」，点击启用
- 启用时自动创建数据表、注册路由与后台面板
从 v1.0/v1.1 升级：直接覆盖插件文件夹后，先禁用再启用一次即可
- 禁用时插件会自动备份配置，重新启用时自动恢复，无需重新设置（数据表与链接数据全程保留）

二、基本使用流程

后台新增外链 → 获得固定跳转地址 / 二维码 → 印刷 / 发布 / 文中引用
     ↑                                            ↓
后台随时修改目标网址 ←—— 二维码与旧链接始终有效 ——← 用户访问 /go/别名/

新增外链：控制台 → 外链管理 → 填写标题、分类、标签、外链网址 → 「新增并生成二维码」
获取地址：列表中复制该链接的跳转地址（如 https://你的域名/index.php/go/plan-001/），或点击二维码查看大图下载
修改目标：随时点「编辑」更换目标网址 —— 跳转地址和二维码都不变，已印出的二维码永远指向最新内容
删除外链：点「删除」并确认。注意：删除后该跳转地址与二维码立即失效

三、跳转方式设置

进入 控制台 → 插件 → Surl → 设置：

直接跳转（默认）：访问跳转地址后立即 302 到目标，适合日常使用
提示页跳转：先展示品牌中转页（标题、说明、目标地址、「立即跳转」按钮），N 秒后自动跳转。适合想展示品牌、或希望用户明确感知"正在离开本站"的场景
- 「提示页停留时间」：自动跳转秒数
- 「中转页标题文字」：支持 %s 占位符，如 即将前往：%s；留空默认「正在为您跳转：链接标题」
- 「中转页提示文字」：留空默认「您即将离开本站，前往外部链接」

每条链接的访问次数会在后台列表自动累计。

四、撰写文章时使用（撰写页面板）

在 撰写文章 / 撰写页面 页面右侧（选项栏下方）可看到「链接库」面板：

┌ 链接库 ─────────────────────────┐
│ [搜索标题/别名/分类/标签/网址] [搜索] │
│  医疗险A计划        [插入] [删除]  │
│  意外险B计划        [插入] [删除]  │
│ [＋ 新建外链]                     │
└────────────────────────────────┘

插入已有链接：点「插入」，Markdown 链接 [标题](跳转地址) 会插入到编辑器光标处
边写边建：点「＋新建外链」展开表单，填标题与网址（分类/别名/标签可选），保存后即可插入
清理：不再需要的链接可直接在面板删除（有确认提示）

为什么插入的是 index.php/go/... 而不是真实网址？
这是插件的核心价值：文章中的链接走站内跳转，日后在后台修改目标网址，所有已发布文章的跳转目标即时更新，且每条链接都有访问统计。

五、前台链接导航页

启用后自动开通，无需配置：

总览页：https://你的域名/index.php/surl/（开启伪静态后为 /surl/）
分类页 / 标签页：从导航栏或后台「分类 / 标签」页签获取地址
搜索：页面顶部搜索框，或地址栏加 ?q=关键词

页面元素：

顶部品牌栏 + 分类导航栏（各分类带数量角标，当前分类高亮）
链接卡片：左侧标题/分类/标签信息，右侧二维码；支持「复制链接」与「访问链接」
二维码点击查看大图

手机端：分类收进右上角菜单按钮（点开抽屉选择分类），搜索收进搜索按钮；链接卡片与大屏一致保持左右排列，不会变成难读的纵向长条。

切换主题：插件设置 →「前台主题」→ 青绿 / 橙红 / 白净，保存即时生效。

六、二维码说明

二维码内容是站内跳转地址，不是目标网址：
- 改目标网址 → 二维码不变，已印制的继续有效
- 改别名 → 跳转地址变化，二维码随之变化（编辑弹窗中有提示，请谨慎）
后台每条链接、每个分类页、每个标签页都提供二维码（小图点击看大图）
重要：切换「伪静态」设置会改变跳转地址形式（index.php/go/… → go/…），已有二维码内容随之改变。如二维码已印刷分发，请保持伪静态设置不变

七、伪静态

插件设置中的「伪静态」与 Typecho「设置 → 永久链接」保持一致即可：

Typecho 未开启伪静态：插件选「关闭」，地址带 index.php
Typecho 已开启伪静态：插件选「开启」，地址更简洁（/go/别名/、/surl/）

八、常见问题（FAQ）

Q1：启用了，前台地址 404？
确认访问地址是否与「伪静态」设置匹配（未开伪静态时要带 index.php）；确认 Typecho「设置 → 永久链接」保存过一次（重写规则已生成）。

Q2：禁用插件会丢数据吗？
设置项「禁用插件时」默认保留数据表，链接数据与配置都安全（配置还会自动备份）。选「删除数据表」则数据无法恢复，请慎重。

Q3：升级插件怎么操作？
覆盖插件文件夹 → 禁用 → 启用。配置自动恢复，链接数据保留。

Q4：别名可以自定义吗？
可以。新增或编辑时填写即可，全站唯一（如 plan-001）；留空则自动生成。中文别名同样支持（地址自动编码）。

Q5：撰写页面板没显示？
确认页面是「撰写文章 / 撰写页面」页；升级覆盖文件后需禁用再启用一次插件（重新注册面板钩子）。

Q6：一个外链可以属于多个分类/标签吗？
分类是单值（每条链接一个分类），标签是多值（逗号分隔多个）。

Q7：跳转地址会被搜索引擎收录吗？
不会。跳转地址输出 noindex, nofollow，中转页同样设置，不影响站点 SEO。

Q8：能用于印刷物料吗？
可以，这正是插件的设计场景：二维码指向固定的站内跳转地址，活动页地址变更时后台改一下即可，物料无需重印。

附：设置项速查

设置项	位置	何时改
前台主题（青绿/橙红/白净）	插件设置	想换前台配色
伪静态	插件设置	Typecho 永久链接开启后同步（注意二维码影响）
每页显示条数	插件设置	后台列表很长时
跳转方式 / 停留时间 / 中转页文案	插件设置	需要"离开提示"或品牌展示时
禁用插件时（删表/保留）	插件设置	通常保持默认「保留数据表」

文章目录

Surl 外链管理插件 · 使用说明

Typecho Surl 外链管理插件使用说明