Hanny的Links的使用
前言
最近开发着友链功能,看到Hanny大佬有一款挺牛的Links插件,于是就拿来用了
然而我一看使用文档,真的看了个寂寞。看不懂?!
Start 折腾
Hanny给的东西理解不算难,但是你需要认真看文档才行,接下来我就按照文档来一一解释
Links文档:http://www.imhan.com/archives/typecho-links/
1 函数原型
Hanny一开始就给了个函数原型,真的是完全没有看懂
output($pattern=NULL, $links_num=0, $sort=NULL)
你这个直接放进PHP
里吧,又不对,这不是一个直接
就可以调用的函数。
然而走到后面我才看懂,原来,他的意思是插件里面有这个函数,所以实际上应该是这样子的
Links_Plugin::output($pattern=NULL, $links_num=0, $sort=NULL);
这个样子才是正确的使用方法
2 $pattern
$pattern
他叫做输出规则,说白了就是你需要按什么模板输出,之后你所需要的链接,图片用一个{xxx}来代替
你将你写好的模板替换掉刚刚上面的函数原型的$pattern=NULL
,这个时候你就已经配置好输出规则了
假设你是这么写的
// 我在这里将$links_num=0, $sort=NULL都直接忽略了(都是可以省略的)
Links_Plugin::output('<li><a href="{url}" title="{title}" target="_blank">{name}</a></li>')
那么他输出友链就会像是这个样子:
<li>
<a href="友链的链接" title="友链的名字" target="_blank">友链的名字</a>
</li>
<li>
<a href="友链的链接" title="友链的名字" target="_blank">友链的名字</a>
</li>
...一直循环直到最后一个
如果你需要图片的话就只需要在输出规则里加上img,图片链接就是{image}
输出规则的变量Hanny都有写
{lid}链接在数据表中存放的ID
{url}将会被替换成链接地址
{sort}链接的分类名称
{title}{description}将会被替换链连描述,两者效果一样
{name}将会被替换成链接名称
{image}将会被替换成链接图片
{user}自定义字段
要注意的是:分类名只能包含字母及数字!
2.1 自带的输出规则
Links想的很周到,连规则都自带
了
意思就是说,你只需要通过设置变量
的值,就可以直接
拥有了友链输出的模板
他有四种规则:
NULL, SHOW_TEXT
如果你是这样子设置的:
php Links_Plugin::output("NULL"); //或者是 Links_Plugin::output("SHOW_TEXT");
你的友链输出就会是这个样子的(仅文字)
<li> <a href="友链的链接" title="友链的名字" target="_blank">友链的名字</a> </li> <li> <a href="友链的链接" title="友链的名字" target="_blank">友链的名字</a> </li> ...一直循环直到最后一个
SHOW_IMG
如果这样子设置的
Links_Plugin::output("SHOW_IMG");
你的输出将会是这个样子(仅图片)
<li> <a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /></a> </li> <li> <a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /></a> </li> ...一直循环
SHOW_MIX
如果你是这样子设置的
Links_Plugin::output("SHOW_MIX");
插件将会把图片&文字都输出
<li> <a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /> <span>{name}</span> </a> </li> <li> <a href="{url}" title="{title}" target="_blank"><img src="{image}" alt="{name}" /> <span>{name}</span> </a> </li> ...一直循环
其他的两个变量
$links_num
是用于控制
链接输出的条数
的。当$links_num
为缺省值0时,表示不进行限制,输出所有链接。
$sort
用于指定
输出的链接类别
,以实现链接的分类输出
一般来说,我都是不设置sort就分一下内页
u1s1,Links的功能真的好多
要注意的是:分类名只能包含字母及数字!
3 HTML标签调用
这个我就不多介绍了,调用是这个样子的
<links $links_num $sort>$pattern</links>
变量名都看的懂吧?
🌰总结例子
一、PHP调用
最简单的调用方式为:
php
<?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
<?php Links_Plugin::output("SHOW_TEXT", 0, "testsort"); ?>
如果想自己做个输出模板的,则可这样子写:
<?php Links_Plugin::output('<li><a href="{url}">{title}</a></li>');?>
2、HTML调用
最简单的引用方式为:
html
<links></links>
如果想调用的为图片链接,则调用方式为:
html
<links>SHOW_IMG</links>
如果是图文的混合链接,则调用方式为:
html
<links>SHOW_MIX</links>
如果想限制侧边栏的链接数量,比如说为10个,则可调用:
html
<links 10>SHOW_TEXT</links>
图片链接依此类推。
如果想列出某个类别的链接,则可调用:
html
<links 0 testsort></links>
也可以用
html
<links testsort></links>
不过,后者要求分类必须以字母开头。
最后要注意的是:分类名只能包含字母及数字!