destoon调用标签大全2013版.doc

Destoon B2B标签调用手册作者八世纪供求网（www.80g.cc）什么是标签调用？标签调用是根据调用条件(condition)从数据表(table)读取调用数量(pagesize)条数据，并按排序方式(order)排序，最终通过标签模板的布局输出数据。可以看出，标签的工作分两个部分，一是读取数据，二是显示数据。标签函数原型标签函数保存于 include/tag.func.phptag($parameter, $expires = 0)$parameter 表示传递给tag函数的字符串，系统自动将其转换为多个变量例如传递 table=destoon&pagesize=10&hello=world系统相当于得到$table = destoon;$pagesize = 10;$hello = world;三个变量$expires 表示标签缓存过期时间0 缓存$expires秒；0 - 系统默认标签缓存时间；-1 - 不缓存；-2 - 缓存SQL结果；一般情况保持默认不需要传递。数据读取过程例如以下标签： 会被转换为如下的SQL语句：SELECT *FROM destoon_sellWHERE status=3ORDER BY addtime DESCLIMIT 0,10读出的数据会保存在 $tags 数组里数据显示过程1、通过标签模板显示传递&template=abc给标签函数，例如： 默认的标签模板保存在模板目录/tag/目录里，例如&template=abc将调用模板目录/tag/abc.htm模板来显示数据如果标签模板放于其他目录，例如def，则传递&dir=def&template=abc，系统将调用模板目录/def/abc.htm模板2、直接在模板里循环数据 此写法传递标签模板为null，并且直接返回数据给$tags数组，此时可以直接在模板里循环了以下为一个完整的示例：loop $tags $t./loop第一种写法一般用于多次调用的数据，第二种写法一般用于只调用一次的数据。常用参数及含义moduleidmoduleid指模块ID，可在后台模块管理里查询。对于直接调用模块的数据，设置正确的模块ID后，将不需要传递table参数，系统会自动获取。例如传递moduleid=5，系统将识别为调用供应信息，自动设置table参数为selltabletable指表名，可在后台数据库维护里查询。对于Destoon系统表，不需要加表的前缀；对于非Destoon系统表，需要填写完整的表名，且传递prefix参数例如对于Destoon系统表，传递table=sell，如果表前缀为destoon_，系统将识别表名为 destoon_sell对于非Destoon系统表，传递table=tb_abc&prefix=或者table=abc&prefix=tb_，系统将识别表名为 tb_abcfieldsfields指查询的字段，默认为*。可以传递例如 fields=title,addtime，但是一般情况下无需传递，Destoon独有的标签缓存机制会自动缓存查询结果，不必担心效率问题。conditioncondition指查询的条件，如果不传递，则为1，代表任意条件的数据(此项需了解SQL语法)。Destoon所有模块遵循统一标准开发，所以很多条件是通用的。例如 status=3表示正常通过的信息、status=3 and level=1表示级别为1的信息、status=3 and thumb表示有标题图片的信息等。orderorder指数据的排序方法(此项需了解SQL语法)。例如order=addtime desc表示按添加时间降序排列、order=itemid desc表示按itemid降序排列、order=rand()表示随机数据等。pagesizepagesize指调用数据的数量，如果不传递，默认为10。templatetemplate指指定的标签模板，如果不传递，默认为list，位于模板目录/tag/list.htm，如果传递为null，表示不应用标签模板。参见上述数据显示过程。其他常见用法举例多表联合查询例如查询会员名为destoon的会员和公司资料，可以使用：tag(table=destoon_member m,destoon_company c&prefix=&condition=m.userid=c.userid and m.username=destoon&template=list-com)destoon_member和destoon_company是表的实际名称(包含表前缀)，prefix=表示系统不再自动在表名前加前缀控制标题长度在标签里传递length参数，例如&length=20表示20个字符长度(一个汉字占2个字符)，一般情况建议用css隐藏多余字符(定义height和overflow:hidden)传递length参数，系统仅对title字段自动截取，如果需要截取其他字段，可用dsubstr函数例如 dsubstr($tcompany, 20, .) 表示截取company字段为20个字符，截取后，结尾追加.设置日期显示格式可以在标签里传递datetype参数：1 表示 年； 2 表示 月-日；3 表示 年-月-日；4 表示 月-日 时:分；5 表示 年-月-日 时:分；6 表示 年-月-日 时:分:秒也可以在模板里直接使用date函数，例如date(Y-m-d, $taddtime) 表示将时间转换为 年-月-日 格式调用某一分类的信息在标签里传递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$tcatidcatname控制列数此项常用于图片的布局，可使用cols参数。例如调用12张图片，一行显示4个，共3行，则传递&pagesize=12&cols=4支持cols参数的标签模板限thumb-table.htm和list-table.htm其中，thumb-table.htm显示图片列表，list-table.htm显示文字列表如果新建支持cols的标签模板或直接循环$tags，可参考以上两个模板的写法上述效果可以也可以通过CSS实现，无需使用表格，请自行书写显示文章的简介使用$tintroduce变量，如果要截取字数，例如80字符，可使用dsubstr($tintroduce, 80, .)函数原型tag($parameter, $expires = 0)$parameter 表示传递给tag函数的字符串，系统自动将其转换为多个变量例如传递 table=destoon&pagesize=10，系统相当于得到$table = destoon；$pagesize = 10；两个变量$expires 表示缓存过期时间0 缓存$expires秒；0 - 系统默认时间；-1 - 不缓存；-2 - 缓存SQL；一般情况保持默认即可。常量DT_SKIN系统风格网址。DT_PATH网站首页网址。变量$tags以数组类型保存标签调用的数据，可通过loop语法遍历显示。$pages保存数据分页代码，仅在调用了分页时有效。$MODULE5nameID为5的模块名称。$MODULE5linkurlID为5的模块网址。$CATEGORY5catnameID为5的分类名称(仅变量$CATEGORY存在时有效)。$CATEGORY5linkurlID为5的分类网址(仅变量$CATEGORY存在时有效)。常用字段title 标题； linkurl 链接； catid 分类ID； introduce 简介； addtime 添加时间； 常用函数 dsubstr($string, $length, $suffix = )将字符串$string截取为$length长,尾部追加$suffix(例如.)date($format, $timestamp)将时间戳$timestamp转化为$format(例如Y-m-d)格式标签模板模板保存于./template/default/tag/目录；建议不要删除或者修改自带的模板，推荐在自带模板基础上新建模板并应用。1.标签格式的大致说明moduleid=9是资讯模块ID, 模块ID去模块管理查看；article是资讯模块目录名；&length=40是标签截取字数&pagesize=10是调用条数&datetype=2是显示时间添加时间2.调用最新加入企业4&pagesize=10&order=userid desc&template=list-com”)3.如何调用其中一个企业会员的供求信息及资讯在condition=里加 and username=xxx xxx为会员登录名4.如何调用 供应 求购 产品 下的 某个分类调用分类下的信息可以设置 &catid=行业id&child=1 child=1表示同时调用下属的行业5.调用二级栏目信息列表如果你是在文章模块里调用 可以用上面的代码 $catid 改为你要调用的栏目id即可如果需要同时调用栏目下的信息 child=1即可 否则 child=0如果是在网站其他地方调用，可以用下面的代码：注意moduleid的值要与你调用的模块id保持一致补充：下面这个在首页调用成功但是我想要资讯页内部的模版列表，也就是每条只显示22个字。6.首页资讯栏目这里怎么调用“9”为你模块的IDphp $C = get_maincat(0, cache_read(category-9.php);loop $C $k $v$vcatname/loop7.公司列表 不能控制字数！你可以直接修改 list-com.htm$tcompany 为 dsubstr($tcompany, $length)8.TAG常用标签$CATEGORY$tcatidcatname 所属栏目名称； timetodate($taddtime, $datetype) 发布时间9.其他你可以通过&template= 来指定标签模版如果没用这个参数 默认是list位于模版目录tag目录资讯 级别level 1级为 推荐文章 ；2级为 幻灯图片；3级为 推荐图文；4级为 头条文章；5级为 头条相关 推荐 niaoshi66 退出山歌千里之行始于足下，分享生活琐事，让你的生活乱起来2012-06-05 17:10destoon 标签大全一览1.全局标签网站名称：$DTsitename网站地址：DT_PATH网站LOGO： if $MODULE$moduleidlogoDT_SKINimage/logo_$moduleid.gifelseif $DTlogo$DTlogoelseDT_SKINimage/logo.gif/if版权信息：$DTcopyright风格路径：DT_PATH客服电话：$DTtelephoneICP备案号：if $DTicpno$DTicpno /ifVIP会员名称：VIP真实货币名称：$DTmoney_name真实货币单位：$DTmoney_unit虚拟积分名称：$DTcredit_name虚拟积分单位：$DTcredit_unitTitle(网站标题)：$seo_titleMeta Keywords(网页关键词)：$head_keywordsMeta Description(网页描述)：$head_description2.连接地址默认各个模块连接：会员：$MODULE2linkurl 供应：$MODULE5linkurl 求购：$MODULE6linkurl 行情：$MODULE7linkurl 公司：$MODULE4linkurl 展会：$MODULE8linkurl 资讯：$MODULE21linkurl 招商：$MODULE22linkurl 品牌：$MODULE13linkurl 人才：$MODULE9linkurl 知道：$MODULE10linkurl 专题：$MODULE11linkurl 图库：$MODULE12linkurl视频：$MODULE14linkurl下载：$MODULE15linkurl发布信息：$MODULE2linkurl$DTfile_my企业商铺：$MODULE2linkurlhome.php查看站内信：$MODULE2linkurlmessage.php管理买卖交易：$MODULE2linkurltrade.php完善企业资料：$MODULE2linkurledit.php?tab=2注册：$MODlinkurl$DTfile_register登录：$MODULE2linkurl$DTfile_login找回密码：$MODlinkurlsend.phpVIP页面：$MODULE2linkurlgrade.phpWAP浏览：if extend_setting(wap_enable) WAP浏览/ifRSS订阅：if extend_setting(feed_enable) | RSS订阅/if行情速递：$MODULE7linkurlrewrite(price.php?product=all)企业新闻：$MODULE4linkurlrewrite(news.php?more=1)公告：extendurl(announce)推广：extendurl(spread)广告：extendurl(ad)友情链接：extendurl(link)申请友情链接：extendurl(link)rewrite(index.php?action=reg)留言本：extendurl(guestbook)投票：extendurl(vote)3.首页调用导航菜单：liif $moduleid首页loop $MODULE $mif $mismenu$mname/if/loop调用登录模块：if $DTpage_logintemplate user, chip/if调用分类模块：php $mid = 5;template catalog, chip4.各个模块数据的调用免费发布信息网供应：最新供应信息：1.2.loop $tags $k $tarea_pos($tareaid, /, 1)$ttitle/loop签调用理论上需要网站管理人员有一定的HTML+CSS知识，并对PHP+MySQL有初步的了解。调用过程实际是按照调用条件从数据表读取调用数量条数据，并依排序方式排序，最终通过标签模板的布局输出数据。函数原型 tag($parameter, $expires = 0) $parameter 表示传递给tag函数的字符串，系统自动将其转换为多个变量 例如传递 table=destoon&pagesize=10，系统相当于得到$table = destoon；$pagesize = 10；两个变量 $expires 表示缓存过期时间 0 缓存$expires秒；0 – 系统默认时间；-1 – 不缓存；-2 – 缓存SQL；一般情况保持默认即可。变量 $tags 以数组类型保存标签调用的数据，可通过loop语法遍历显示。$pages 保存数据分页代码，仅在调用了分页时有效。 $path 模块路径。 常用字段 title 标题； linkurl 链接； catid 分类ID； introduce 简介； addtime 添加时间；常用函数 dsubstr($string, $length, $suffix = ”) 将字符串$string截取为$length长,尾部追加$suffix(例如.)set_style($string, $style = ”, $tag = span) 将字符串$string置于$tagHTML标签中并设置style为$style linkurl($linkurl, $absurl = 0) 将相对路径$linkurl修补为绝对路径(防止链接错误)date($format, $timestamp) 将时间戳$timestamp转化为$format(例如Y-m-d)格式标签模板 模板保存于./template/default/tag/目录； 建议不要删除或者修改自带的模板，推荐在自带模板基础上新建模板并应用。Category:Destoon标签调用Comments (0)destoon显示地区Posted byjinpeng998on 星期一, 12 07月, 2010显示地区：需要的函数是 include/module.func.php/get_mainarea($areaid, $area);php页面：$AREA=cache_read(area.php); /读取缓存文件静态页面调用： php $mainarea = get_mainarea(0, $AREA)loop $mainarea $k $vif $k%2=0/if$vareanameif $k%2=1/if/loop还有一种方法就是 直接标签调用，不错的，直接从destoon数据库里取出信息Category:Destoondestoon显示地区Comments (0)destoon 学习标签调用Posted byjinpeng998on 星期日, 11 07月, 2010链接：$tlinkurl供应模块 更多：$MODULE-模块ID-linkurl 模块ID把 鼠标放在其下链接上 出现 moduleid=？ 就能看到图片路径：$t;资讯模块 更多：$MODlinkurl$clinkurl查看 名称是属于哪个字段？选中–右键看name值 eg name=postbrand 即为brand字段每个模块的首页 都是其 template/文件夹下的 index.htmpagesize=”.$MODpagesize.” 可写成 pagesize=4；记住不要加 单引号 or 双引号调用分页：分页标签：分页：if $showpage & $pages$pages/if调用分类：主要方法$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 $vif $k%$DTpage_subcat=0/ifset_style($vcatname,$vstyle) ($ITEMS$vcatid)if $k%$DTpage_subcat=($DTpage_subcat-1)/if/loop注意：在其模块 module 文件夹下的 php页面里必须有 $maincat$MODlinkurl 是模块也首页地址 $vlinkurl其下列表页 加 catidCategory:Destoon标签调用Comments (0)非常好的Destoon B2B标签调用手册Posted byjinpeng998on 星期日, 11 07月, 2010Destoon B2B标签调用手册什么是标签调用？标签调用是根据调用条件(condition)从数据表(table)读取调用数量(pagesize)条数据，并按排序方式(order)排序，最终通过标签模板的布局输出数据。可以看出，标签的工作分两个部分，一是读取数据，二是显示数据。标签函数原型标签函数保存于 include/tag.func.phptag($parameter, $expires = 0)$parameter 表示传递给tag函数的字符串，系统自动将其转换为多个变量例如传递 table=destoon&pagesize=10&hello=world系统相当于得到$table = destoon;$pagesize = 10;$hello = world;三个变量$expires 表示标签缓存过期时间0 缓存$expires秒；0 – 系统默认标签缓存时间；-1 – 不缓存；-2 – 缓存SQL结果；一般情况保持默认不需要传递。数据读取过程例如以下标签：会被转换为如下的SQL语句：SELECT *FROM destoon_sellWHERE status=3ORDER BY addtime DESCLIMIT 0,10读出的数据会保存在 $tags 数组里数据显示过程 1、通过标签模板显示传递&template=abc给标签函数，例如：默认的标签模板保存在模板目录/tag/目录里，例如&template=abc将调用模板目录/tag/abc.htm模板来显示数据如果标签模板放于其他目录，例如def，则传递&dir=def&template=abc，系统将调用模板目录/def/abc.htm模板 2、直接在模板里循环数据此写法传递标签模板为null，并且直接返回数据给$tags数组，此时可以直接在模板里循环了以下为一个完整的示例：loop $tags $t/loop第一种写法一般用于多次调用的数据，第二种写法一般用于只调用一次的数据。常用参数及含义moduleidmoduleid指模块ID，可在后台模块管理里查询。对于直接调用模块的数据，设置正确的模块ID后，将不需要传递table参数，系统会自动获取。例如传递moduleid=5，系统将识别为调用供应信息，自动设置table参数为selltabletable指表名，可在后台数据库维护里查询。对于Destoon系统表，不需要加表的前缀；对于非Destoon系统表，需要填写完整的表名，且传递prefix参数例如对于Destoon系统表，传递table=sell，如果表前缀为destoon_，系统将识别表名为 destoon_sell对于非Destoon系统表，传递table=tb_abc&prefix=或者table=abc&prefix=tb_，系统将识别表名为 tb_abcfieldsfields指查询的字段，默认为星号。可以传递例如 fields=title,addtime，但是一般情况下无需传递，Destoon独有的标签缓存机制会自动缓存查询结果，不必担心效率问题。 orderorder指数据的排序方法(此项需了解SQL语法)。例如order=addtime desc表示按添加时间降序排列、order=itemid desc表示按itemid降序排列、order=rand()表示随机数据等。pagesizepagesize指调用数据的数量，如果不传递，默认为10。templatetemplate指指定的标签模板，如果不传递，默认为list，位于模板目录/tag/list.htm，如果传递为null，表示不应用标签模板。参见上述数据显示过程。其他常见用法举例控制标题长度在标签里传递length参数，例如&length=20表示20个字符长度(GBK一个汉字占2个字符，UTF-8一个汉字占3个字符)，一般情况建议用css隐藏多余字符(定义height和overflow:hidden)传递length参数，系统仅对title字段自动截取，如果需要截取其他字段，可用dsubstr函数例如 dsubstr($tcompany, 20, ) 表示截取company字段为20个字符，截取后，结尾追加设置日期显示格式可以在标签里传递datetype参数： 1 表示 年；2 表示 月-日；3 表示 年-月-日；4 表示 月-日 时:分；5 表示 年-月-日 时:分；6 表示 年-月-日 时:分:秒也可以在模板里直接使用date函数，例如date(Y-m-d, $taddtime) 表示将时间转换为 年-月-日 格式调用某一分类的信息在标签里传递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$tcatidcatname控制列数此项常用于图片的布局，可使用cols参数。例如调用12张图片，一行显示4个，共3行，则传递&pagesize=12&cols=4支持cols参数的标签模板限thumb-table.htm和list-table.htm其中，thumb-table.htm显示图片列表，list-table.htm显示文字列表如果新建支持cols的标签模板或直接循环$tags，可参考以上两个模板的写法上述效果可以也可以通过CSS实现，无需使用表格，请自行