destoon开发文档.docx

1、destoon开发文档 常用的destoon常量、模版标签大全以及一些开发心得 本人接触DT时间不算太长，只因为新换的这份工作，网站就是用的destoon,也算是从零开始吧，destoon不算很难，跟大部分的网站系统都差不多，大概熟悉一下基本上就可以开始上手开发了。一、先介绍一下destoon的目录结构，下边是destoon中一些核心的文件admin 系统核心后台管理 image 后台风格 template 后台模板 /api 系统及第三方接口 kf 在线客服 map 电子地图 oauth 一键登录 pay 支付接口 stats 第三方统计 trade 担保交易 ucenter UCenter

2、 /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 功能模块 articl

3、e 文章模块 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 文章内容页

4、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.

5、php 动态首页 /version.inc.php 版本控制 Destoon也算是mvc框架吧，（如果不知道什么事MVC可以先去XX一下）举个例子，根目录下的文件夹/company里面的文件是MVC中的C,它控制对应module/company中的文件也就是我们说的M，最后我们通过V也是就是tempalte/default/company对应的文件来显示我们的界面，整个流程基本就是这样的。只要把这个流程弄清楚了，其他的就是写代码编程序的问题了。二、主要的模版标签以及调用的方法 1.全局标签网站名称：$DTsitename网站地址：DT_PATH网站LOGO： if $MODULE$module

6、idlogoDT_SKINimage/logo_$moduleid.gifelseif $DTlogo$DTlogoelseDT_SKINimage/logo.gif/if版权信息：$DTcopyright风格路径：DT_PATH客服电话：$DTtelephone 本文转自蹲屋吧笑话网 ICP备案号：if $DTicpno$DTicpno /ifVIP会员名称：VIP真实货币名称：$DTmoney_name真实货币单位：$DTmoney_unit虚拟积分名称：$DTcredit_name虚拟积分单位：$DTcredit_unitTitle(网站标题)：$seo_titleMeta Keywor

7、ds(网页关键词)：$head_keywordsMeta Description(网页描述)：$head_description这些全局标签是随时拿出来都可以用的，不仅是在php文件中，在htm文件中也都是可以拿来用的，所以为了快速的、简洁的写代码，这些全局变量我们一定要熟识。2.连接地址默认各个模块连接：会员：$MODULE2linkurl 供应：$MODULE5linkurl 求购：$MODULE6linkurl 行情：$MODULE7linkurl 公司：$MODULE4linkurl 展会：$MODULE8linkurl 资讯：$MODULE21linkurl 招商：$MODULE22

8、linkurl 品牌：$MODULE13linkurl 人才：$MODULE9linkurl 知道：$MODULE10linkurl 专题：$MODULE11linkurl 图库：$MODULE12linkurl视频：$MODULE14linkurl下载：$MODULE15linkurl发布信息：$MODULE2linkurl$DTfile_my企业商铺：$MODULE2linkurlhome.php查看站内信：$MODULE2linkurlmessage.php管理买卖交易：$MODULE2linkurltrade.php完善企业资料：$MODULE2linkurledit.php?tab=

9、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(new

10、s.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_login t

11、emplate user, chip /if调用分类模块： php $mid = 5; template catalog, chip4.各个模块数据的调用供应：最新供应信息：1.2.loop $tags $k $t 本文转自蹲屋吧笑话网 area_pos($tareaid, /, 1)$ttitle/loop标签调用理论上需要网站管理人员有一定的HTML+CSS知识，并对PHP+MySQL有初步的了解。调用过程实际是按照调用条件从数据表读取调用数量条数据，并依排序方式排序，最终通过标签模板的布局输出数据。函数原型 tag($parameter, $expires = 0) $parameter

12、 表示传递给tag函数的字符串，系统自动将其转换为多个变量 例如传递 table=destoon&pagesize=10，系统相当于得到$table = destoon；$pagesize = 10；两个变量 $expires 表示缓存过期时间 0 缓存$expires秒；0 – 系统默认时间；-1 – 不缓存；-2 – 缓存SQL；一般情况保持默认即可。变量 $tags 以数组类型保存标签调用的数据，可通过loop语法遍历显示。$pages 保存数据分页代码，仅在调用了分页时有效。 $path 模块路径。 常用字段 title 标题； linkurl 链接

13、； 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) 将时间戳$ti

14、mestamp转化为$format(例如Y-m-d)格式标签模板 模板保存于./template/default/tag/目录； 建议不要删除或者修改自带的模板，推荐在自带模板基础上新建模板并应用。有时候难免会出现系统自带模版不能满足需求的情况，这时候你可以在此目录下新建一个模版文件，然后按照自己的需求写出自己的模板。destoon显示地区 显示地区：需要的函数是 include/module.func.php/get_mainarea($areaid, $area);php页面：$AREA=cache_read(area.php); /读取缓存文件静态页面调用： php $mainarea

15、= get_mainarea(0, $AREA)loop $mainarea $k $vif $k%2=0/if$vareanameif $k%2=1/if/loop还有一种方法就是 直接标签调用，不错的，直接从destoon数据库里取出信息调用分页：分页标签： 本文转自蹲屋吧笑话网 分页：if $showpage & $pages$pages/if调用分类：主要方法$maincat = get_maincat(0, $CATEGORY);get_maincat(0, $CATEGORY)在include/global_func.php 中$childcat = get_maincat(0,

16、$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

17、/loop注意：在其模块 module 文件夹下的 php页面里必须有 $maincat$MODlinkurl 是模块也首页地址 $vlinkurl其下列表页 加 catid什么是标签调用？标签调用是根据调用条件(condition)从数据表(table)读取调用数量(pagesize)条数据，并按排序方式(order)排序，最终通过标签模板的布局输出数据。可以看出，标签的工作分两个部分，一是读取数据，二是显示数据。标签函数原型标签函数保存于 include/tag.func.phptag($parameter, $expires = 0)$parameter 表示传递给tag函数的字符串，系

18、统自动将其转换为多个变量例如传递 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

19、 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第

20、一种写法一般用于多次调用的数据，第二种写法一般用于只调用一次的数据。常用参数及含义moduleidmoduleid指模块ID，可在后台模块管理里查询。对于直接调用模块的数据，设置正确的模块ID后，将不需要传递table参数，系统会自动获取。例如传递moduleid=5，系统将识别为调用供应信息，自动设置table参数为selltabletable指表名，可在后台数据库维护里查询。对于Destoon系统表，不需要加表的前缀；对于非Destoon系统表，需要填写完整的表名，且传递prefix参数例如对于Destoon系统表，传递table=sell，如果表前缀为destoon_，系统将识别表名为

21、destoon_sell对于非Destoon系统表，传递table=tb_abc&prefix=或者table=abc&prefix=tb_，系统将识别表名为 tb_abcfieldsfields指查询的字段，默认为*。可以传递例如 fields=title,addtime，但是一般情况下无需传递，Destoon独有的标签缓存机制会自动缓存查询结果，不必担心效率问题。Condition 本文转自蹲屋吧笑话网 condition指查询的条件，如果不传递，则为1，代表任意条件的数据(此项需了解SQL语法)。Destoon所有模块遵循统一标准开发，所以很多条件是通用的。例如 status=3表示正常

22、通过的信息、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，表示不应用标签模板。参见上

23、述数据显示过程。其他常见用法举例控制标题长度在标签里传递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 表示 月-日 时:

24、分；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参数。例如调用