2026年7月

友情链接插件使用帮助

插件简介

Links 是 Typecho 的一款友情链接管理插件，支持在后台管理友情链接，并在前台文章中快速插入友情链接列表。

功能特性

  • 友情链接的增、删、改、排序
  • 按分类筛选链接
  • 支持文字、图片、混合三种输出模式
  • 支持自定义 HTML 模板
  • 支持在文章和评论内容中通过标签插入
  • 支持自定义扩展字段

安装与启用

  1. 将 Links 文件夹 上传至 usr/plugins/ 目录
  2. 在后台「插件」管理页面启用「友情链接」插件
  3. 启用后系统会自动创建 typecho_links 数据表
  4. 插件设置面板位于「管理」→「友情链接」

后台管理

启用插件后，在左侧菜单「管理」中可以找到「友情链接」管理页面。

添加链接

您可以手动填写以下字段添加链接：

字段说明
链接名称必填，显示的文字
链接地址必填，以 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

字段类型说明
lidint(10) unsigned主键
namevarchar(200)链接名称
urlvarchar(200)链接网址
sortvarchar(200)链接分类
imagevarchar(200)链接图片地址
descriptionvarchar(200)链接描述
uservarchar(200)自定义扩展数据
orderint(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 核心更新。