DEDECMS标签手册(4)

global 全局配置变量标签

（>=DedeCMS 3，DedeCMS 4，DedeCMS 5） 名称：global

功能：获取系统全局配置变量内容 语法：

{dede:global.cfg_webname/}

[field:global.cfg_webname/] 用于底层模板中 文件：

系统模板引擎 默认底层模板： 无

参数： 无

底层字段： 无

hotwords 搜索关键词

（>=DedeCMS 3，DedeCMS 4，DedeCMS 5） 名称：hotwords

功能：获取网站搜索的热门关键字 语法：

{dede:hotwords num=6 subday=365 maxlength=16/} 文件：

\\include\\taglib\\hotwords.lib.php

function lib_hotwords(&$ctag,&$refObj) 默认底层模板： 无

参数：

num=6 关键词数目

subday=365 调用天数以内的关键词 maxlength=16 关键词最大长度 底层字段： 无

json JSON数据调用

（>=DedeCMS 5.7） 名称：json

功能：调用某个远程连接的json接口，方便同远程站点之间进行通信来调取内容 语法：

{dede:json url='http://yoursite/json.php' cache=300} [field:id/]-[field:title/]
{/dede:json}

文件：

\\include\\taglib\\json.lib.php

function lib_json(&$ctag,&$refObj) 默认底层模板： 无

参数：

url='' 远程json接口地址

注：所传递的数据需要是UTF-8编码格式，否则可能会出现乱码。 cache=300 缓存时间，0为不缓存 底层字段：

json传递数组字段 范例：

我们首先编写一个简单的服务器端API，将其存放在系统根目录/api下，由于系统是GB2312编码，所以服务端编写的时候我们进行了一些编码转换的处理，保证服务端访问的编码是UTF-8即可。

$cfg_NotPrintHead = false;

header(\

include_once (dirname(__FILE__).\ error_reporting(E_ALL || ~E_NOTICE); require_once(DEDEINC.'/json.class.php');

$reval = array();

$dsql->SetQuery(\ $dsql->Execute('me');

while ($row = $dsql->GetArray('me')) { $row['title'] = gb2utf8($row['title']); $reval[] = $row; }

$json = new Services_JSON(SERVICES_JSON_SUPPRESS_ERRORS); echo $json->encode($reval); ?>

通过地址http://www.dede.com/api/arcticle.php我们可以访问到刚才编写的服务端文件。

下面我们就可以通过标签来进行访问。

{dede:json url='http://www.dede.com/api/arcticle.php' cache=0} [field:id/]-[field:title/]
{/dede:json}

测试标记结果如下：

如果您是想获取单条记录，可以构造如下的数组：

$row[] = $dsql->GetOne(“SELECT * FROM fw_archives WHERE id=88”);

然后将这个数组通过JSON格式化进行处理。

loop 万能调用标签

（>=DedeCMS 3，DedeCMS 4，DedeCMS 5） 名称：loop

功能：调用任意表的数据标签 语法：

{dede:loop table='dede_archives' sort='' row='4' if=''} [field:title/] {/dede:loop}

文件：

\\include\\taglib\\loop.lib.php

function lib_loop(&$ctag,&$refObj) 默认底层模板： 无

参数：

table='' 数据表名称 tablename='' 同table row=8 调用数据的行数 sort='' 用于排序的字段 if='' 查询的条件 ifcase='' 同if

orderway='desc' 排序方式，desc降序、asc升序 底层字段：

这个标记的底层模板变量即是被查询表的所有字段 范例：

我们来查询用户id为1的用户发布的文档，可以用下面的标签来表示： {dede:loop table='fw_archives' sort='mid' row='4' if='mid=1'} [field:title/]([field:mid/])
{/dede:loop} 查询结果如下：