友情链接插件帮助文档——懵仙兔兔

友情链接插件 version 1.2.5 by 懵仙兔兔

更新下载地址：https://2dph.com/archives/typecho-links.html

功能描述

本版本的友情链接可以支持以下的功能：

• 1、自建独立数据表，干净无上限的添加友情链接信息。
• 2、支持两种输出方式：函数方式，用于主题模板侧边栏等嵌入位置显示；HTML标签方式，用于独立页面等编辑内容显示。
• 3、三种输出模式：文字友链、图片友链、图文混合友链等。内设三种默认输出规则，支持自定议设定输出规则。
• 4、管理面板：支持友链的分类，拖拽排序以及友链启用禁用等
• 5、支持友链邮箱解析头像链接（数字QQ邮箱自动优先解析无QQ号头像链接，其次有QQ号链接。其他邮箱解析Gravatar头像），方便用户添加无图片的友链。
• 6、支持增加自定义字段，方便用户做一些个性扩展。

使用帮助

插件的安装：

使用方法：

解压至 usr/plugins/ 插件目录后，确保文件夹名为 Links。
如果已经安装旧版本的本插件，需要禁用后重新激活。
激活插件，点击菜单-管理-友情链接，在面板右侧填写各项信息依次添加。
在主题sidebar.php文件种的适当位置写入 <?php $this->links(); ?> 即可显示。

注意事项：

以上调用函数内支持用英文逗号隔开4个参数，即$this->links( "模式", "数目", "分类", "尺寸" )，赋值如下表：

友情链接插件主要有两种调用方式。
第一种为函数调用法。函数的原型为：

1

output($pattern=NULL, $links_num=0, $sort=NULL)

其中，$pattern是输出规则。输出规则是Links插件的一种特殊语法。使用输出规则，可以定制出属于自己的友链输出方式。例如：

1

<li><a href="{url}" title="{title}" target="_blank">{name}</a></li>

这就是一个输出规则的例子。经过插件解析后，{url}将会被替换成友链地址，{title}将会被替换友链描述，{name}将会被替换成友链名称。

Links插件目前支持的输出规则有：

1
2
3
4
5
6
7

{lid}友链在数据表中存放的ID
{url}将会被替换成友链地址
{sort}友链的分类名称
{title}{description}将会被替换友链描述，两者效果一样
{name}将会被替换成友链名称
{image}将会被替换成友链图片
{user}自定义字段

插件自带三种输出规则：显示文字、显示图片及图文混排。
当$pattern值为NULL或SHOW_TEXT时，则规则为显示文字。

1

<li><a href="{url}" title="{title}" target="_blank">{name}</a></li>

当$pattern值为SHOW_IMG时，则规则为显示图片。

1

<li><a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /></a></li>

当$pattern值为SHOW_MIX时，则规则为显示图片和文字

1

<li><a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /><span>{name}</span></a></li>

$links_num是用于控制友链输出的条数的。当$links_num为缺省值0时，表示不进行限制，输出满足条件的所有友链。

$sort用于指定输出的友链类别，以实现友链的分类输出。缺省值NULL表示输出所有类别的友链。

第二种输出为HTML标签调用法。 可以在文章或页面中加入HTML标签来实现友链的调用。
其调用原型为：

1

<links $links_num $sort>$pattern</links>

$links_num $sort $pattern的功能及缺省值与第一种一样。不过，为了$links_num和$sort缺省值的识别，建议$sort采用的命名方式为：以字母开头，仅包括字母和数字。

使用向导：在侧边栏添加友情链接

在0.8默认主题上，已经集成了本插件的调用接口。因此，不需要任何的修改即可直接使用。如果主题没有本插件接口，可按照以下方式进行调用。

最简单的调用方式为：

1

<?php Links_Plugin::output(); ?>

此时，会列出所有的友链。
如果想调用的为图片友链，则调用方式为：

1

<?php Links_Plugin::output("SHOW_IMG"); ?>

如果是图文的混合友链，则调用方式为：

1

<?php Links_Plugin::output("SHOW_MIX"); ?>

如果想限制侧边栏的友链数量，比如说为10个，则调用方式为：

1

<?php Links_Plugin::output("SHOW_TEXT", 10); ?>

图片友链依此类推。

如果想列出某个类别的友链，则调用方式为：

1

<?php Links_Plugin::output("SHOW_TEXT", 0, "testsort"); ?>

如果想指定图片尺寸，则调用方式为：

1

<?php $this->links("SHOW_IMG", 0, "ALL", 64); ?>

Links_Plugin::output 可用 $this->links 代替

使用向导：建立独立的友情链接页面

建立独立的友情页面，可以直接用类似建立侧边栏的方式，在模板设计阶段，就设计好友链模板。也可以在后台的页面创建进行友链引用。

最简单的引用方式为：

1

<links></links>

如果想调用的为图片友链，则调用方式为：

1

<links>SHOW_IMG</links>

如果是图文的混合友链，则调用方式为：

1

<links>SHOW_MIX</links>

如果想限制侧边栏的友链数量，比如说为10个，则可调用：

1

<links 10>SHOW_TEXT</links>

图片友链依此类推。
如果想列出某个类别的友链，则调用方式为：

1

<links 0 testsort></links>

也可以用

1

<links testsort></links>

不过，后者要求分类必须以字母开头。

如果想指定图片尺寸，则调用方式为：

1

<links 0 ALL 64>SHOW_IMG</links>

也可以用

1

<links ALL 64>SHOW_IMG</links>

最后要注意的是： 分类名只能包含字母及数字！