模板函数getlists

注意:AKCMS已于2019年12月27日宣布停止更新,此文档仅供老用户参考,不建议新用户选择AKCMS建站。
注意:AKCMS6.1.2已取消授权机制,文档中关于授权、服务、技术支持等的内容均已失效。

getlists,按照设置输出一个列表

参数:

template:显示模板,如果不指定此参数默认为“[item]<br>”
sc:分隔符,默认为“,”(半角)
list:列表,不指定无法工作
num:显示数量,默认为-1,代表不限制
orderby:排序方式,有三种可选值:id、id_reverse、random,分别代表顺序、反序、乱序(
sourcetype:(6.0新增)如果指定这个参数说明不是通过分隔符分隔的,支持两种类型:serialize、json

模板:

[id]:序号
[item]:项目
[iteminurl]:经过urlencode处理过的项目(如果要放到URL中可以使用这个)
[iteminhtml]:经过htmlspecialchars处理过的项目

实例

例一:

在模板中加入以下代码:

<{getlists num="2" list="1,2,3,4,5,6,7"}>

实际上显示的是:

1<br>2<br>

因为没有指定模板,所以默认取[item]<br>,又因为我们设定了num="2",所以只显示前两项。

例二:

假设莫篇文章有四个关键字:曼联,英超,意甲,中超。在文章正文页模板item_display.htm中加入调用全部关键字的标签:

<{getlists template="[item]&nbsp;" list=$keywords}>

显示在网页中的最终代码是:

曼联&nbsp;英超&nbsp;意甲&nbsp;中超&nbsp;

如果想给每一个关键字加上链接,可以这样写标签:
<{getlists template="<a href=()/tag/[item]/()>[item]</a>&nbsp;" list=$keywords}>

显示的最终代码:
<a href="/tag/曼联/">曼联</a>&nbsp;<a href="/tag/英超/">英超</a>&nbsp;<a href="/tag/意甲/">意甲</a>&nbsp;<a href="/tag/中超/">中超</a>&nbsp;

或者把标签这样写:
<{getlists template="<a href=()/tag/[iteminurl]/()>[item]</a>&nbsp;" list=$keywords}>

显示的最终代码:
<a href="/tag/%C2%FC%C1%AA/">曼联</a>&nbsp;<a href="/tag/%D3%A2%B3%AC/">英超</a>&nbsp;<a href="/tag/%D2%E2%BC%D7/">意甲</a>&nbsp;<a href="/tag/%D6%D0%B3%AC/">中超</a>&nbsp;