destoon_b2b标签大全.doc

Destoon 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独有的标签缓存机制会自动缓存查询结果，不必担心效率问题。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级为 头条相关目录/文件/admin 系统核心后台管理 image 后台风格 template 后台模板/api 系统及第三方接口 kf 在线客服 map 电子地图 oauth 一键登录 pay 支付接口 stats 第三方统计 trade 担保交易 ucenter UCenter/file backup 数据库备份 cache 缓存 captcha 验证码字体 chat 聊天记录 config 配置 data 导数据导入 email 邮件列表 flash Flash文件 font 中文字体 image 公用图片 ipdata IP数据库 log 日志 md5 MD5镜像 mobile 手机列表 script javascript session SESSION setting 配置数据 temp 临时目录 update 系统更新 upload 上传文件/include 核心类库/install 安装程序/lang 语言包/module 功能模块 article 文章模块 article/admin 文章管理 article/admin/template 文章管理模板 article/common.inc.php 文章模块初始化 article/global.func.php 文章核心函数 article/article.class.php 文章核心类 article/index.inc.php 文章首页 article/index.htm.php 静态文章首页 article/list.inc.php 文章列表页 article/list.htm.php 静态文章列表页 article/show.inc.php 文章内容页 article/show.htm.php 静态文章内容页 article/search.inc.php 文章搜索 article/task.inc.php 文章计划任务/skin 风格皮肤 default 默认风格 default/image 图片文件 default/style.css CSS文件/template 模板文件 default 默认模板 default/index.htm 首页模板/upgrade 系统升级/admin.php 后台入口/common.inc.php 系统初始化/config.inc.php 系统配置/index.html 静态首页/index.php 动态首页/version.inc.php 版本控制Destoon（PH版本B2B）会员整合Ucenter/Discuz!/PHPWind教程操作方法如下：首先进入 Destoon网站后台 -会员管理 -模块设置 -会员整合假如需要整合的主站地址为 论坛为 1、整合Ucenter进入 Ucenter管理 -添加新应用选择安装方式 选择 自定义安装应用名称 填写 Destoon应用的 URL 填写 通信密钥 自行设定 建议 字母和数字组合应用类型 选择 其他是否开启同步登录 选择 是是否接受通知 选择 是- 提交备注：a. 未涉及选项，保持默认即可b. Destoon端未设置前会提示通信失败，先忽略进入 Destoon网站后台 -会员管理 -模块设置 -会员整合- 启用会员整合 选择 Ucenter- API 地址 填写 Ucenter的安装地址 (默认为/uc_server,注意具体地址可以在ucenter 应用的 UCenter 配置信息里面的 define(UC_API)一行看到)- 主机IP 填写 IP 或留空- 如果数据库不在同一服务器，选择远程连接- 如果在同一服务器需要填写Ucenter 数据库信息- 应用ID(APP ID) 填写 Ucenter 中 Destoon