Hanny的Links的使用

·(已编辑)· / ·

194

阅读·

喜欢

这篇文章上次修改于，可能部分内容已经不适用，如有疑问可询问作者。

关键洞察

AI · GEN

前言

最近开发着友链功能，看到Hanny大佬有一款挺牛的Links插件，于是就拿来用了

然而我一看使用文档，真的看了个寂寞。看不懂？！

Start 折腾

Hanny给的东西理解不算难，但是你需要认真看文档才行，接下来我就按照文档来一一解释

Links文档：http://www.imhan.com/archives/typecho-links/

1 函数原型

Hanny一开始就给了个函数原型，真的是完全没有看懂

PHP

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

你这个直接放进PHP里吧，又不对，这不是一个直接就可以调用的函数。

然而走到后面我才看懂，原来，他的意思是插件里面有这个函数，所以实际上应该是这样子的

PHP

Links_Plugin::output($pattern=NULL, $links_num=0, $sort=NULL);

这个样子才是正确的使用方法

2 $pattern

$pattern他叫做输出规则，说白了就是你需要按什么模板输出，之后你所需要的链接，图片用一个{xxx}来代替

你将你写好的模板替换掉刚刚上面的函数原型的$pattern=NULL，这个时候你就已经配置好输出规则了

假设你是这么写的

PHP

// 我在这里将$links_num=0, $sort=NULL都直接忽略了（都是可以省略的）
Links_Plugin::output('<li><a href="{url}" title="{title}" target="_blank">{name}</a></li>')

那么他输出友链就会像是这个样子：

CodeBlock Loading...

如果你需要图片的话就只需要在输出规则里加上img，图片链接就是{image}

输出规则的变量Hanny都有写

CodeBlock Loading...

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

2.1 自带的输出规则

Links想的很周到，连规则都自带了

意思就是说，你只需要通过设置变量的值，就可以直接拥有了友链输出的模板

他有四种规则：

NULL, SHOW_TEXT
如果你是这样子设置的：
CodeBlock Loading...

你的友链输出就会是这个样子的（仅文字）
CodeBlock Loading...
SHOW_IMG
如果这样子设置的
CodeBlock Loading...

你的输出将会是这个样子（仅图片）
CodeBlock Loading...
SHOW_MIX
如果你是这样子设置的
CodeBlock Loading...

插件将会把图片&文字都输出
CodeBlock Loading...

其他的两个变量

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

$sort 用于指定输出的链接类别，以实现链接的分类输出

一般来说，我都是不设置$links_num的，最多$sort就分一下内页

u1s1,Links的功能真的好多

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

3 HTML标签调用

这个我就不多介绍了，调用是这个样子的

CodeBlock Loading...

变量名都看的懂吧？

🌰总结例子

一、PHP调用

最简单的调用方式为：

CodeBlock Loading...

此时，会列出所有的链接。

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

CodeBlock Loading...

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

CodeBlock Loading...

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

CodeBlock Loading...

图片链接依此类推。

如果想列出某个类别的链接，则可调用：

CodeBlock Loading...

如果想自己做个输出模板的，则可这样子写：

CodeBlock Loading...

2、HTML调用

最简单的引用方式为：

CodeBlock Loading...

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

CodeBlock Loading...

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

CodeBlock Loading...

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

CodeBlock Loading...

图片链接依此类推。

如果想列出某个类别的链接，则可调用：

CodeBlock Loading...

也可以用

CodeBlock Loading...

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

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

前言

最近开发着友链功能，看到Hanny大佬有一款挺牛的Links插件，于是就拿来用了

然而我一看使用文档，真的看了个寂寞。看不懂？！

Start 折腾

Hanny给的东西理解不算难，但是你需要认真看文档才行，接下来我就按照文档来一一解释

Links文档：http://www.imhan.com/archives/typecho-links/

1 函数原型

Hanny一开始就给了个函数原型，真的是完全没有看懂

PHP

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

你这个直接放进PHP里吧，又不对，这不是一个直接就可以调用的函数。

然而走到后面我才看懂，原来，他的意思是插件里面有这个函数，所以实际上应该是这样子的

PHP

Links_Plugin::output($pattern=NULL, $links_num=0, $sort=NULL);

这个样子才是正确的使用方法

2 $pattern

$pattern他叫做输出规则，说白了就是你需要按什么模板输出，之后你所需要的链接，图片用一个{xxx}来代替

你将你写好的模板替换掉刚刚上面的函数原型的$pattern=NULL，这个时候你就已经配置好输出规则了

假设你是这么写的

PHP

// 我在这里将$links_num=0, $sort=NULL都直接忽略了（都是可以省略的）
Links_Plugin::output('<li><a href="{url}" title="{title}" target="_blank">{name}</a></li>')

那么他输出友链就会像是这个样子：

HTML

<li>
  <a href="友链的链接" title="友链的名字" target="_blank">友链的名字</a>
</li>
<li>
  <a href="友链的链接" title="友链的名字" target="_blank">友链的名字</a>
</li>
...一直循环直到最后一个

CodeBlock Loading...

如果你需要图片的话就只需要在输出规则里加上img，图片链接就是{image}

输出规则的变量Hanny都有写

PHP

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

CodeBlock Loading...

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

2.1 自带的输出规则

Links想的很周到，连规则都自带了

意思就是说，你只需要通过设置变量的值，就可以直接拥有了友链输出的模板

他有四种规则：

NULL, SHOW_TEXT

如果你是这样子设置的：

PHP

Links_Plugin::output("NULL");
//或者是
Links_Plugin::output("SHOW_TEXT");

CodeBlock Loading...

你的友链输出就会是这个样子的（仅文字）

HTML

<li>
  <a href="友链的链接" title="友链的名字" target="_blank">友链的名字</a>
</li>
<li>
  <a href="友链的链接" title="友链的名字" target="_blank">友链的名字</a>
</li>
...一直循环直到最后一个

CodeBlock Loading...

SHOW_IMG

如果这样子设置的

PHP

Links_Plugin::output("SHOW_IMG");

CodeBlock Loading...

你的输出将会是这个样子（仅图片）

HTML

<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>
...一直循环

CodeBlock Loading...

SHOW_MIX

如果你是这样子设置的

PHP

Links_Plugin::output("SHOW_MIX");

CodeBlock Loading...

插件将会把图片&文字都输出

HTML

  <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>
...一直循环

CodeBlock Loading...

其他的两个变量

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

$sort 用于指定输出的链接类别，以实现链接的分类输出

一般来说，我都是不设置$links_num的，最多$sort就分一下内页

u1s1,Links的功能真的好多

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

3 HTML标签调用

这个我就不多介绍了，调用是这个样子的

HTML

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

CodeBlock Loading...

变量名都看的懂吧？

🌰总结例子

一、PHP调用

最简单的调用方式为：

PHP

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

CodeBlock Loading...

此时，会列出所有的链接。

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

PHP

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

CodeBlock Loading...

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

PHP

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

CodeBlock Loading...

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

PHP

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

CodeBlock Loading...

图片链接依此类推。

如果想列出某个类别的链接，则可调用：

PHP

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

CodeBlock Loading...

如果想自己做个输出模板的，则可这样子写：

PHP

<?php Links_Plugin::output('<li><a href="{url}">{title}</a></li>');?>

CodeBlock Loading...

2、HTML调用

最简单的引用方式为：

HTML

<links></links>

CodeBlock Loading...

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

HTML

<links>SHOW_IMG</links>

CodeBlock Loading...

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

HTML

<links>SHOW_MIX</links>

CodeBlock Loading...

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

HTML

<links 10>SHOW_TEXT</links>

CodeBlock Loading...

图片链接依此类推。

如果想列出某个类别的链接，则可调用：

HTML

<links 0 testsort></links>

CodeBlock Loading...

也可以用

HTML

<links testsort></links>

CodeBlock Loading...

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

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