typecho友情链接使用说明
原链接:
原分类:网站建设, Linux
以下是我自己在sidebar.php中添加的
<div class="widget">
<h3><?php _e('链接'); ?></h3>
<ul>
<?php Links_Plugin::output(); ?>
<li><a href="https://blog.pcwuyu.com/">PC物语</a></li>
</ul>
</div>
之后为官方文档
功能描述
本版本的友情链接可以支持以下的功能:
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
值为NUL
L或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>
不过,后者要求分类必须以字母开头。
最后要注意的是:分类名只能包含字母及数字!
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。