Destoon 标签调用大全个人整理版.docx

调用分类：

主要方法

$maincat=get_maincat（0,$CATEGORY）;

get_maincat（0,$CATEGORY）——在include/global_func.php中

$childcat=get_maincat（0,$CATEGORY,1）;—调用超级栏目下的1级目录

0代表最最根目录1代表level为1的目录level手动设置默认都为1

如果0改为3则为catid为3的目录

小注意：

$CATEGORY=cache_read（‘category-’.$moduleid.’.php’）;此文件在模块页的common.inc.php页面中

调用

{loop$maincat$k$v}

{if$k%$DT[page_subcat]==0}{/if}

{set_style（$v[catname],$v[style]）}（{$ITEMS[$v[catid]]}）

{if$k%$DT[page_subcat]==（$DT[page_subcat]-1）}{/if}

{/loop}

注意：

在其模块module文件夹下的php页面里必须有$maincat

$MOD[linkurl]是模块也首页地址$v[linkurl]其下列表页加catid

Category:

Destoon标签调用

Comments（0）

非常好的DestoonB2B标签调用手册Postedbyjinpeng998on星期日,1107月,2010

DestoonB2B标签调用手册什么是标签调用？

标签调用是根据调用条件（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&c=3&order=addtimedesc&pagesize=10″）}–>

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

SELECT*

FROMdestoon_sell

WHEREstatus=3

ORDERBYaddtimeDESC

LIMIT0,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

fields

fields指查询的字段，默认为星号。

可以传递例如fields=title,addtime，但是一般情况下无需传递，Destoon独有的标签缓存机制会自动缓存查询结果，不必担心效率问题。

order

order指数据的排序方法（此项需了解SQL语法）。

例如order=addtimedesc表示按添加时间降序排列、order=itemiddesc表示按itemid降序排列、order=rand（）表示随机数据等。

pagesize

pagesize指调用数据的数量，如果不传递，默认为10。

template

template指指定的标签模板，如果不传递，默认为list，位于模板目录/tag/list.htm，如果传递为null，表示不应用标签模板。

参见上述数据显示过程。

其他常见用法举例

控制标题长度

在标签里传递length参数，例如&length=20表示20个字符长度（GBK一个汉字占2个字符，UTF-8一个汉字占3个字符），一般情况建议用css隐藏多余字符（定义height和overflow:

hidden）

传递length参数，系统仅对title字段自动截取，如果需要截取其他字段，可用dsubstr函数

例如{dsubstr（$t[company],20,‘…’）}表示截取company字段为20个字符，截取后，结尾追加…

设置日期显示格式

可以在标签里传递datetype参数：

1表示年；

2表示月-日；

3表示年-月-日；

4表示月-日时:

分；

5表示年-月-日时:

分；

6表示年-月-日时:

分:

秒

也可以在模板里直接使用date函数，例如{date（‘Y-m-d’,$t[addtime]）}表示将时间转换为年-月-日格式

调用某一分类的信息

在标签里传递catid参数，例如&catid=5表示调用分类ID为5的所有信息。

如果调用多个分类，用逗号分隔分类ID，例如&catid=5,6,7表示调用分类ID为5、6、7的所有信息。

分类调用默认包含子分类的信息，如果不需要包含子分类，可设置&child=0参数。

例如&catid=5&child=0表示只调用分类ID为5的信息，不包括子分类的信息。

调用某一地区的信息

调用地区信息和上述调用分类信息的方法完全相同，将其中的catid换为areaid即可。

显示信息所在分类

{$CATEGORY[$t[catid]][catname]}

控制列数

此项常用于图片的布局，可使用cols参数。

例如调用12张图片，一行显示4个，共3行，则传递&pagesize=12&cols=4

支持cols参数的标签模板限thumb-table.htm和list-table.htm

其中，thumb-table.htm显示图片列表，list-table.htm显示文字列表

如果新建支持cols的标签模板或直接循环$tags，可参考以上两个模板的写法

上述效果可以也可以通过CSS实现，无需使用表格，请自行书写

显示文章的简介

使用{$t[introduce]}变量，如果要截取字数，例如80字符，可使用{dsubstr（$t[introduce],80,‘…’）}

小结

标签看似复杂难懂，实际上在理解各个参数的含义和调用流程后，您会了解到标签实际简单自由、灵活易用、功能强大。

默认模板里已提供了大量的调用范例和标签模板，可以在学习中参阅和调试。

标签调用是制作模板必备的知识，希望您能早日掌握。

第二部

1.标签格式的大致说明

–{tag

（“moduleid=9&table=article_9&length=40&condition=status=3&pagesize=

10&datetype=2&order=ad

dtimedesc&target=_blank”）}–>

moduleid=9是资讯模块ID,模块ID去模块管理查看；

article是资讯模块目录名；

&length=40是标签截取字数

&pagesize=10是调用条数

&datetype=2是显示时间添加时间

2.调用最新加入企业

–{tag（“moduleid=4&table=company&condition=groupid>4&pagesize=10&order=useriddesc&template=list-com”）}–>

3.如何调用其中一个企业会员的供求信息及资讯

在condition=里加andusername=’xxx’xxx为会员登录名

4.如何调用供应求购产品下的某个分类

调用分类下的信息可以设置&catid=行业id&child=1child=1表示同时调用下属的行业

5.调用二级栏目信息列表

–{tag（“moduleid=$moduleid&table=article_$moduleid&catid=$catid&child=1

&condition=status=3&order=”.$MOD[order].”&pagesize=6&datetype=2&target=_blank”）}–>

如果你是在文章模块里调用可以用上面的代码$catid改为你要调用的栏目id即可

如果需要同时调用栏目下的信息child=1即可否则child=0

如果是在网站其他地方调用，可以用下面的代码：

–{tag

（“moduleid=9&table=article_9&catid=$catid&child=1&condition=status=3&order=addtime

desc&pagesize=6&datetype=2&target=_blank”）}–>

注意moduleid的值要与你调用的模块id保持一致

补充：

下面这个在首页调用成功

–{tag

（“moduleid=9&table=article_9&catid=$catid&child=1&condition=status=3&order=addtime

desc&pagesize=6&datetype=2&target=_blank”）}–>

但是我想要资讯页内部的模版列表，也就是每条只显示22个字。

6.首页资讯栏目这里怎么调用

“9”为你模块的ID

{php$C=get_mainc