DESTOON B2B标签(tag)调用手册

　　什么是标签调用？

　　标签调用是根据调用条件(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("moduleid=5&condition=status=3&order=addtime desc&pagesize=10")}-->

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

　　SELECT *

　　FROM destoon_sell

　　WHERE status=3

　　ORDER BY addtime DESC

　　LIMIT 0,10

　　读出的数据会保存在 $tags 数组里

　　通常情况下不需要写table=xxx，应该写moduleid=模块ID，系统会自动对应模块的表

　　数据显示过程

　　1、通过标签模板显示

　　传递&template=abc给标签函数，例如：

　　<!--{tag("moduleid=...&template=abc")}-->

　　默认的标签模板保存在模板目录/tag/目录里，例如&template=abc将调用模板目录/tag/abc.htm模板来显示数据。

　　如果标签模板存放于其他目录，例如def，则传递&dir=def&template=abc，系统将调用模板目录/def/abc.htm模板Destoon批量删除关键词 。

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

　　<!--{php $tags=tag("moduleid=...&template=null");}-->

　　此写法传递标签模板为null，并且直接返回数据给$tags数组，此时可以直接在模板里循环了。

　　以下为一个完整的示例：

　　<!--{php $tags=tag("moduleid=...&template=null");}-->

　　{loop $tags $t}

　　...

　　{/loop}

　　第一种写法一般用于多次调用的数据Destoon批量更新文章 ，第二种写法一般用于只调用一次的数据。