友情链接插件使用帮助
友情链接插件使用帮助
插件简介
Links 是 Typecho 的一款友情链接管理插件，支持在后台管理友情链接，并在前台文章中快速插入友情链接列表。
功能特性
- 友情链接的增、删、改、排序
- 按分类筛选链接
- 支持文字、图片、混合三种输出模式
- 支持自定义 HTML 模板
- 支持在文章和评论内容中通过标签插入
- 支持自定义扩展字段
安装与启用
- 将
Links 文件夹上传至usr/plugins/目录 - 在后台「插件」管理页面启用「友情链接」插件
- 启用后系统会自动创建
typecho_links数据表 - 插件设置面板位于「管理」→「友情链接」
后台管理
启用插件后，在左侧菜单「管理」中可以找到「友情链接」管理页面。
添加链接
您可以手动填写以下字段添加链接：
| 字段 | 说明 |
|---|---|
| 链接名称 | 必填，显示的文字 |
| 链接地址 | 必填，以 http:// 或 https:// 开头 |
| 链接分类 | 选填，建议以英文字母开头，只包含字母与数字 |
| 链接图片 | 选填，留空则使用默认图片 |
| 链接描述 | 选填，鼠标悬停时显示的说明文字 |
| 自定义数据 | 选填，用于主题模板扩展 |
快速添加预设好友
友情链接页面的「添加柚子」按钮可快速添加我的博客链接信息。
编辑与删除
- 点击链接名称可进入编辑模式
- 勾选多条链接后可批量删除
拖拽排序
在列表中拖拽链接行即可拖动排序，松开后自动保存排序结果。
前台输出
方式一：在主题模板中直接调用
在主题的模板文件中使用 PHP 函数调用：
<?php Links_Plugin::output(); ?>方式二：通过标签在文章内容中使用
在文章或评论内容中插入标签：
<links>自定义模板</links>标签语法：
<links num="数量" sort="分类">模板内容</links>参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
| num | 否 | 显示的数量，0 或不填则显示全部 |
| sort | 否 | 按分类筛选，不填则显示全部分类 |
可用占位符：
| 占位符 | 说明 |
|---|---|
| {lid} | 链接主键 ID |
| {name} | 链接名称 |
| {url} | 链接地址 |
| {sort} | 链接分类 |
| {title} / {description} | 链接描述 |
| {image} | 链接图片地址 |
| {user} | 自定义扩展数据 |
预设模式
插件内置三种预设输出模式：
Links_Plugin::output("SHOW_TEXT"); // 纯文字模式
Links_Plugin::output("SHOW_IMG"); // 纯图片模式
Links_Plugin::output("SHOW_MIX"); // 图文混合模式不传参数时默认等同于 SHOW_TEXT：
<li><a href="{url}" title="{title}" target="_blank">{name}</a></li>SHOW_MIX 模式模板
<li><a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /><span>{name}</span></a></li>自定义模板示例
<?php Links_Plugin::output('SHOW_TEXT', 10, 'friends'); ?>在文章中使用自定义模板：
<links num="5" sort="tech"><li><a href="{url}" target="_blank"><img src="{image}" />{name}<p>{description}</p></a></li></links>数据库结构
数据表名：typecho_links
| 字段 | 类型 | 说明 |
|---|---|---|
| lid | int(10) unsigned | 主键 |
| name | varchar(200) | 链接名称 |
| url | varchar(200) | 链接网址 |
| sort | varchar(200) | 链接分类 |
| image | varchar(200) | 链接图片地址 |
| description | varchar(200) | 链接描述 |
| user | varchar(200) | 自定义扩展数据 |
| order | int(10) unsigned | 排序值 |
历史版本
[m3ui_collapse title="点击查看"]v1.2.0 (2026-07-01) — 适配 Typecho 1.3，命名空间化二改维护
v1.1.1 (2014-12-14) — 适配 Typecho 1.0，修正删除 BUG
v1.1.0 (2013-12-08) — 适配 Typecho 0.9
v1.0.4 (2010-06-30) — 修正表前缀问题
v1.0.3 (2010-06-20) — 增加分类、自定义字段、图片链接等功能
[/m3ui_collapse]
关于二改与维护
本插件基于 Hanny（寒泥）最初开发的 Links 插件 1.1.1 版本进行二改维护，主要适配 Typecho 1.3 版本并在后续版本中持续跟进 Typecho 核心更新。
- 原作者：Hanny 寒泥
- 二改维护：Yuuz12
- 使用帮助：https://yuuz12.top/archives/210.html
