前言

最近开发着友链功能，看到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

  如果这样子设置的

  PHP

  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

  如果你是这样子设置的

  PHP

  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 用于指定输出的链接类别，以实现链接的分类输出

一般来说，我都是不设置$links_num的，最多$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> 不过，后者要求分类必须以字母开头。

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