- 20
- 6月
最新版本下载地址
default模板修改实例：
更新历史
* version 1.0.4 at 2010-06-30
* 修正数据表的前缀问题
* 在Pattern里加上所有的数据表字段
*
* version 1.0.3 at 2010-06-20
* 修改图片链接的支持方式。
* 增加链接分类功能
* 增加自定义字段，以便用户自定义扩展
* 增加多种链接输出方式。
* 增加较详细的帮助文档
* 增加在自定义页面引用标签，方便友情链接页面的引用
*
* version 1.0.2 at 2010-05-16
* 增加SQLite支持
*
* version 1.0.1 at 2009-12-27
* 增加显示链接描述
* 增加首页链接数量限制功能
* 增加图片链接功能
* version 1.0.0 at 2009-12-12
* 实现友情链接的基本功能
* 包括: 添加 删除 修改 排序
功能描述
本版本的友情链接可以支持以下的功能：
1、方便地在侧边栏添加友情链接。
2、支持两种输出方式。一种为函数输出方式，主要用于侧边栏的友情链接，或者模板开发者设计的友情链接模板等。另一种方式为HTML标签式输出，主要方便用户建立自己的友情链接页面。
3、支持文字链接、图片链接、图文混合链接等。内设这三种默认的输出方式，支持自定议设定输出规则。
4、支持链接分类，方便管理。
5、支持增加自定义字段，方便用户做一些个性扩展。
使用帮助
插件的安装：
解压至插件目录后，激活即可。
如果已经安装旧版本的本插件，需要禁用后重新激活。
友情链接插件主要有两种调用方式。
第一种为函数调用法。函数的原型为：
output($pattern=NULL, $links_num=0, $sort=NULL)
其中，$pattern是输出规则。输出规则是Links插件的一种特殊语法。使用输出规则，可以定制出属于自己的链接输出方式。例如：
<li><a href="{url}" title="{title}" target="_blank">{name}</a></li>
这就是一个输出规则的例子。经过插件解析后，{url}将会被替换成链接地址，{title}将会被替换链连描述，{name}将会被替换成链接名称。
Links插件目前支持的输出规则有：
{lid}链接在数据表中存放的ID
{url}将会被替换成链接地址
{sort}链接的分类名称
{title}{description}将会被替换链连描述，两者效果一样
{name}将会被替换成链接名称
{image}将会被替换成链接图片
{user}自定义字段
插件自带三种输出规则：显示文字、显示图片及图文混排。
当$pattern值为NULL或SHOW_TEXT时，则规则为显示文字。
<li><a href="{url}" title="{title}" target="_blank">{name}</a></li>\n
当$pattern值为SHOW_IMG时，则规则为显示图片。
<li><a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /></a></li>\n
当$pattern值为SHOW_MIX时，则规则为显示图片和文字
<li><a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /><span>{name}</span></a></li>\n
$links_num是用于控制链接输出的条数的。当$links_num为缺省值0时，表示不进行限制，输出满足条件的所有链接。
$sort用于指定输出的链接类别，以实现链接的分类输出。缺省值NULL表示输出所有类别的链接。
第二种输出为HTML标签调用法。可以在文章或页面中加入HTML标签来实现链接的调用。
其调用原型为：
<links $links_num $sort>$pattern</links>
$links_num $sort $pattern的功能及缺省值与第一种一样。不过，为了$links_num和$sort缺省值的识别，建议$sort采用的命名方式为：以字母开头，仅包括字母和数字。
使用向导：在侧边栏添加友情链接
在0.8默认主题上，已经集成了本插件的调用接口。因此，不需要任何的修改即可直接使用。如果主题没有本插件接口，可按照以下方式进行调用。
最简单的调用方式为：
<?php Links_Plugin::output(); ?>
此时，会列出所有的链接。
如果想调用的为图片链接，则调用方式为：
<?php Links_Plugin::output("SHOW_IMG"); ?>
如果是图文的混合链接，则调用方式为：
<?php Links_Plugin::output("SHOW_MIX"); ?>
如果想限制侧边栏的链接数量，比如说为10个，则可调用：
<?php Links_Plugin::output("SHOW_TEXT", 10); ?>
图片链接依此类推。
如果想列出某个类别的链接，则可调用：
<?php Links_Plugin::output("SHOW_TEXT", 0, "testsort"); ?>
使用向导：建立独立的友情链接页面
建立独立的友情页面，可以直接用类似建立侧边栏的方式，在模板设计阶段，就设计好链接模板。也可以在后台的页面创建进行链接引用。
最简单的引用方式为：
<links></links>
如果想调用的为图片链接，则调用方式为：
<links>SHOW_IMG</links>
如果是图文的混合链接，则调用方式为：
<links>SHOW_MIX</links>
如果想限制侧边栏的链接数量，比如说为10个，则可调用：
<links 10>SHOW_TEXT</links>
图片链接依此类推。
如果想列出某个类别的链接，则可调用：
<links 0 testsort></links>
也可以用
<links testsort></links>
不过，后者要求分类必须以字母开头。
最后要注意的是：分类名只能包含字母及数字！
貌似不太会用，独立页面，比如http://www.aimbu.com/links.html
要怎么在后台编辑独立页面呢
貌似会了。原来是没更新数据库。
要CSS美化怎么弄呢
这个插件不错
要全部恢复原来的了……原来的被我改成面目全非了。杯具。
噗哈哈，这个是必装插件来的……
话说，自定义字段……怎么输出哦？结果源码里没有对应字段……
@猜猜
已经加上了。
怎么样做出上在前台接收别人的链接申请、后台审核呢。
@呼死你
留言申请、后台添加
怎么用啊，放入插件后，在后台添加链接后，主页不显示啊
为什么是 友情链接插件启用失败。错误号：1
@osoul
请参考默认模板，进行内容添加
@hobodog
MySQL or SQLite？可能SQLite有部分细节还未处理好。需要进一步调试。
是SQLite
@hobodog
SQLite我也是简单看了一点，还不是太懂。如果有需要的话，可以留下联系方式，方便的话，可以在线联调一下。
添加链接的时候经常出现500错误，是插件问题还是服务器问题呢
@水煮鱼
可以打开Debug模式看看出错原因。
找到原因了，links表的lid字段没有设置为auto_increment
第一次可以用
第二次装的时候不能激活....
能不能添加一下把链接图片的大小控制一下
@IceHawk
可以自行用CSS控制，也可以在使用插件时，通过Pattern来配置。
看了typecho本身的数据结构，http://docs.typecho.org/database
其中提到可以将contents来放链接。
插件要是直接填这个表应该也不错吧。
有时候，安装typecho并不是用默认的typecho_作为数据库的表前缀。
要是做成sqiite独立版的也不错啊,以后升级什么的也不用管了,拿来就能继续用
下一版里直接把教程写道插件里面吧，外链总感觉怪怪的
如果想把侧边栏和独立页面里的链接改成两列显示，怎么改？教教好不
@花落
可以用CSS设置li标签的宽度来实现的
我用了,怎么只能显示两个,多了的不能显示,晕死!
博主您好 已经安装上您的插件很好用 比如我想让他显示两列 怎么操作？谢谢
我的现在显示一列 http://www.cwang.info
@无线发烧友
需要去控制CSS的宽度来实现多列。
我想请问友情链接添加图片为什么不能直接上传呢？需要是url的，这样好不方便哟
@裕波
主要是为了保证插件的简单与灵活性
@Hanny 可以加你QQ吗？
哈哈，不支持logo上传的话，操作起来麻烦。
还有自定义字段可以多几个自定义字段吗？
@裕波
是有点麻烦，看个人需求了。自定义字段多的话，可以考虑用数组打包。
我的QQ是529977518，不过可能不是很有时间帮你解决问题哦~