destoon官方标签大全

什么是标签调用？

标签调用是根据调用条件(condition)从数据表(table)读取调用数量(pagesize)条数据，并按排序方式(order)排序，最终通过标签模板的布局输出数据。
可以看出，标签的工作分两个部分，一是读取数据，二是显示数据。
标签函数原型

标签函数保存于 include/tag.func.php
tag($parameter, $expires = 0)
$parameter 表示传递给tag函数的字符串，系统自动将其转换为多个变量
例如传递 table=destoon&pagesize=10&hello=world
系统相当于得到
$table = ‘destoon';
$pagesize = 10;
$hello = ‘world';
三个变量
$expires 表示标签缓存过期时间>0 缓存$expires秒；0 – 系统默认标签缓存时间；-1 – 不缓存；-2 – 缓存SQL结果；
一般情况保持默认不需要传递。

数据读取过程

例如以下标签：

<!–{tag(“table=sell&condition=status=3&order=addtime desc&pagesize=10″)}–>

会被转换为如下的SQL语句：

SELECT *FROM destoon_sellWHERE status=3ORDER BY addtime DESCLIMIT 0,10

读出的数据会保存在 $tags 数组里
数据显示过程

1、通过标签模板显示
传递&template=abc给标签函数，例如：

<!–{tag(“table=…&template=abc”)}–>

默认的标签模板保存在模板目录/tag/目录里，例如&template=abc将调用模板目录/tag/abc.htm模板来显示数据
如果标签模板放于其他目录，例如def，则传递&dir=def&template=abc，系统将调用模板目录/def/abc.htm模板

2、直接在模板里循环数据

<!–{php $tags=tag(“table=…&template=null”);}–>

此写法传递标签模板为null，并且直接返回数据给$tags数组，此时可以直接在模板里循环了
以下为一个完整的示例：

<!–{php $tags=tag(“table=…&template=null”);}–>{loop $tags $t}…{/loop>

第一种写法一般用于多次调用的数据，第二种写法一般用于只调用一次的数据。
常用参数及含义

moduleid
moduleid指模块ID，可在后台模块管理里查询。对于直接调用模块的数据，设置正确的模块ID后，将不需要传递table参数，系统会自动获取。
例如传递moduleid=5，系统将识别为调用供应信息，自动设置table参数为sell

table
table指表名，可在后台数据库维护里查询。对于Destoon系统表，不需要加表的前缀；对于非Destoon系统表，需要填写完整的表名，且传递prefix参数
例如对于Destoon系统表，传递table=sell，如果表前缀为destoon_，系统将识别表名为 destoon_sell
对于非Destoon系统表，传递table=tb_abc&prefix=或者table=abc&prefix=tb_，系统将识别表名为 tb_abc