DTcms帮助文档.doc

DTcms帮助文档DTcms 模板语法和C#非常接近，4.0和3.0版本中，标签语法大同小异，依然符合于技术开发人员的编程习惯。如果你是一名程序员，下面的语法我相信只需要看一次便可牢牢记住各种标签的使用规则，所以你不必担心DTcms模板难掌握。如果非程序员，难度有所加大，毕竟我们考虑到了整个系统的扩展性和二次开发，所以比较偏向于技术开发人员。页面嵌套标签如果想在一个模板页面中嵌入另一个模板页的内容可使用该标签，注意避免被嵌套的页面嵌套主模板页，这样会造成迭代循环。另外，嵌套的深度最多只能5层。其中src所指定的路径为当前相对路径，如src=common/_header.html当前模板路径标签因为3.0版本中增加分站的功能，所以这里和2.1及前版本的模板标签有所不同。输出不包含/，如：templates/green/images/logo.png，同一模板目录下使用第一个种标签即可 嵌入C#代码标签如果其它标签无法实际你想要的效果，你可以试一下直接写C#代码，如意不能使用Response.Write /C#代码引用命名空间标签如果需要引用命名空间则需要使用该标签，注意此标签不能放在嵌套的页面且需要放置在模板页的最顶部!-示例：-普通变量标签模板页的变量概念实际上就是C#的变量，在模板页调用时需加上大括号，这里往往和模板页的JS的方法体互相冲突，所以在写JS时，遇到大括号一定要换行。varnamevar.item数据变量标签数据变量一般在循环列表时使用到，另外在显示内容时也会用到var.var.item.loop循环标签loop循环标签主要是数据列表中使用的，其中自带有行号变量datarow_loop_id，该变量是从1开始参数说明：datarow：DataRow类型的变量，同一页面内不可重复，否则编译出错datatable：DataTable类型的变量，使用前请确保该参数已声明赋值 .foreach循环标签foreach标签和C#的语法是一样的，写法也差不多，相信技术人员一看就懂。注意与loop标签不同的是它没有自带的行号变量，需要手动声明。参数说明：type：数据类型，如DataRowitem：数据类型的变量名，自定义变量名list：数组、结构、对象、引用类型 .for循环标签for标签和C#的语法也是一样的，一般很少用到。参数说明：i：整型变量count：整型变量%for(int i=0;i .if判断语句标签if判断语句与C#的语法一样，3.0支持二种写法，保留旧的写法 . . . .continue退出当前循环标签循环标签中分支用以结束当前循环，直接进入下一次循环的标签，使用方式同传统程序一致。%for(int i=0;i break结束循环标签在循环标签中用以结束循环，进入后续程序的标签，使用方式同传统程序一致 。%for(int i=0;i 5)% 获取GET传输参数标签获取URL地址GET传输的参数值requestvarname截取字符串长度标签当一个字符串的长度大于你想要的值时可使用该标签参数说明：num：int类型，字符串长度日期格式转换标签把日期字符串转换成你想要的格式参数说明：strFormat：日期格式整型格式转换标签当一个字符串的想转换成一个整型的数字时可使用该标签strtoint(.)直接输出内容标签当一个方法返回的是字符串内容，而我们又想直接在模板页中直接输出可使用该标签。该标签支持两种写法，推荐用第一种。1.5 声明变量与赋值标签和C#语法基本一致，需要声明或在需要接受一个方法返回的内容时可以使用该标签。参数说明：type：可选，变量的类型，如果有type则首先创建对象再赋值，否则直接赋值ref：变量名，同一页面内不可重复expression：变量、常量或方法都可以通用标签在所有模板页面都可以使用，如果您下载的是DTcms的源码版，请查看DTcms.Web.UI项目下的Label文件夹，如果默认标签不够用的情况下，你也可以在里面新增一些自定义的标签，但记住编译一下整个项目。一、系统配置标签(变量)系统配置的一些信息，实际上是源码DTcms.Model项目中的sys_config.cs里面的属性，里面都有详细的备注与注释标签描述示例config.webname主站名称动力启航config.weburl主站域名config.webcompany公司名称XX软件有限公司config.webaddress公司地址XX省XX市XX区XX号config.webtel联系电onfig.webfax传真号onfig.webmail管理员邮箱config.webcrod网站备案号粤TC/ICP备XX号config.webpath网站安装目录，/代表放在根目录/config.webmanagepath网站后台管理目录adminconfig.staticstatus是否开启生成静态，0不开启，1伪静态，2全静态1config.staticextension生成静态扩展名htmlconfig.mobilestatus手机网站状态，0关闭1开启1config.mobiledomain手机网站绑定域名config.memberstatus开启会员功能，0不开启，1开启1mentstatus开启评论审核，0不审核，1开启审核机制0config.logstatus后台管理日志，0关闭，1开启1config.webstatus是否关闭网站，0正常，1关闭0config.webclosereason网站关闭原因描述网站正在维护，请稍候访问.config.webcountcode网站统计代码，支持HTML.config.smsapiurl短信API地址http:/.config.smsusername短信平台登录账户名testconfig.smspassword短信平台登录密码，MD5加密字符串a34de42fededferkc63feconfig.smsnickname手机短信签名动力启航config.emailsmtp邮件STMP服务器config.emailsslSSL加密连接1config.emailport邮件SMTP端口25config.emailfrom发件人地址config.emailusername邮箱账号config.emailpassword邮箱密码，内置加密算法config.emailnickname发件人昵称网站管理员config.filepath附件上传目录名uploadconfig.filesave附件保存方式，1按年月日保存，2按年月/日/保存1config.fileextension附件上传类型，以逗号分隔开gif,png,docconfig.videoextension视频上传类型，以逗号分隔开mp4,flvconfig.attachsize附件上传大小，单位为KB2048config.videosize视频上传大小，单位为KB2048config.imgsize图片上传大小，单位为KB1024config.imgmaxheight图片最大高度(像素)1024config.imgmaxwidth图片最大宽度(像素)1024config.thumbnailheight生成缩略图高度(像素)1024config.thumbnailwidth生成缩略图宽度(像素)1024config.watermarktype图片水印类型，0关闭，1文字，2图片1config.watermarkposition图片水印位置，1-99config.watermarkimgquality图片生成质量，0-10080config.watermarkpic图片水印文件watermark.pngconfig.watermarktransparency水印透明度，1-105config.watermarktext水印文字动力启航config.watermarkfont文字字体Arialconfig.watermarkfontsize水印文字大小(像素)12当前站点的配置信息，只能在当前模板页面中使用这些标签，它和上面的系统配置不同，例如当前访问的是站点A，加载的就是站点A的配置信息。标签描述示例网站名称动力启航site.domain网站域名site.logo网站LOGO/upload/20131220/201312203234212.pany公司名称XX软件有限公司site.address公司地址XX省XX市XX区XX号site.tel联系电ite.fax传真号ite.email管理员邮箱site.crod网站备案号粤TC/ICP备XX号site.copyright网站版权信息，支持HTML版权所有 动力启航site.seo_titleSEO标题动力启航_开源site.seo_keywordSEO页面关健词，255字符内开源,C#开源site.seo_descriptionSEO页面描述，255字符内DTcms 100%开源的CMS二、全局通用标签(方法)位于DTcms.Web.UI/BasePage.cs类里面的方法，如果你是一个程序员，随时可以根据自己的要求添加你自己的方法2.1 统一链接标签主要对DTcms.Webxmlconfigurls.config文件里的节点读取和匹配。参数说明：key：URL配置的名称params：Object参数列表2.2 分页页码标签输入分页页码按钮链接，需要和pagination.css一起使用。参数说明：pagesize：每页显示条数pageindex：当前页码totalcount：总记录数key：URL配置的名称params： Object参数列表get_page_link(pagesize, pageindex, totalcount, key, params)pagelist2.3 调用插件列表标签主要用于主模板面调用插件方法，为了防止插件卸载后页面出错，建立使用该方法调用。参数说明：assemblyName：命名空间全局限定名className：类名methodName：方法名称params：Object参数get_plugin_method(assemblyName, className, methodName, params) 留言标题：drtitle三、频道调用标签(方法)位于DTcms.Web.UI/Label/article.cs类里面的方法，如果你是一个程序员，随时可以根据自己的要求添加你自己的方法频道列表页已声明变量：page(当前页码)、category_id(当前类别ID)、totalcount(数据的总记录)、pagelist(分页字符串)，可直接使用这些变量频道详细页已声明变量：id(当前文章ID)、call_index(调用别名)、model(当前文章Model实体类，可查阅数据字典)，可直接使用这些变量3.1 查询最新文章列表标签可根据条件查询前几条最新文章列表，用循环语句输出。参数说明：channel_name：频道名称top：显示的条数，0为显示所有strwhere：SQL查询语句get_article_list(channel_name, top, strwhere) 新闻标题：drtitle 新闻标题：drtitle3.2 按分类查询最新文章列表标签可根据分类ID与条件查询前几条最新文章列表，用循环语句输出。参数说明：channel_name：频道名称category_id：栏目分类IDtop：显示的条数，0为显示所有strwhere：SQL查询语句get_article_list(channel_name, category_id, top, strwhere) 新闻标题：drtitle 4)% 新闻标题：ndrtitle3.3 查询并排序文章列表标签可根据分类ID与条件查询前几条最新文章列表并进行排序，用循环语句输出。参数说明：channel_name：频道名称category_id：栏目分类ID，0显示所有分类top：显示的条数，0为显示所有strwhere：SQL查询语句orderby：SQL排序语句，asc顺序desc倒序get_article_list(channel_name, category_id, top, strwhere, orderby) 新闻标题：drtitle3.4 文章列表分页标签此标签只允许在频道列表页中使用，分页需结合pagination.css。参数说明：channel_name：频道名称category_id：栏目分类ID，0显示所有分类page_size：每页显示数量page_index：当前页码，系统默认为pagestrwhere：SQL查询语句totalcount：数据总数，系统默认为totalcountpagelist：分页字符串变量，系统默认为pagelistkey：URL配置名称params：URL传输参数get_article_list(channel_name, category_id, page_size, page_index, strwhere, out totalcount, out pagelist, key, params) 新闻标题：drtitle3.5 根据调用别名取得内容标签此标签适用于单页，在只需要显示该文单详细内容时使用。参数说明：call_index：该条文章的调用别名，string类型get_article_content(call_index)3.6 根据文章的ID返回图片路径标签此标签适用于只知道文章的ID情况下想得到该文章的图片路径。参数说明：article_id：文章ID，int类型get_article_img_url(article_id)img src= /3.7 返回对应信息扩展字段值标签使用此标签时会判断当前用户是否登录，如尚未登录则返回-1。参数说明：article_id：文章ID，int类型field_name：扩展字段名get_article_field(article_id, field_name)扩展字段值：四、类别调用标签(方法)位于DTcms.Web.UI/Label/category.cs类里面的方法，如果你是一个程序员，随时可以根据自己的要求添加你自己的方法4.1 返回当前类别名称标签一般用于频道列表页或者详细页，可根据类别ID查找类别的标题。参数说明：category_id：栏目ID，int类型default_value：默认值，当该类别不存在时显示默认值，string类型get_category_title(category_id, default_value)当前类别：4.2 返回类别一个实体类标签此标签适用于只知道类别ID想查找该类别的其它信息时使用，返回类型为DTcms.Model.article_category。参数说明：category_id：栏目ID，int类型get_category_model(category_id) 类别名称：cmodel.title 类别SEO标题：cmodel.seo_title4.3 返回类别面包屑导航标签此标签适用于频道的列表页或详细页，根据当前的类别ID显示面包屑导航。参数说明：urlKey：url配置的名称，string类型category_id：栏目ID，int类型get_category_menu(url_key, category_id)4.4 类别列表标签显示该类别下所有的子类别，当父类别的ID为0时显示该频道所有类别，以循环输出。参数说明：channel_name：当前频道的名称，string类型parent_id：父类别的ID，0为所有类别，int类型get_category_list(channel_name, parent_id) 类别名称：drtitle 类别名称：drtitle4.5 类别列表(只显示一级分类)标签根据父ID查询子类别列表，注意只返回一层，不查找子类的子类，以循环输出。参数说明：channel_name：当前频道的名称，string类型parent_id：父类别的ID，0为顶级分类，int类型get_category_child_list(channel_name, parent_id) 二级类别名称：drtitle 三级类别名称：dr2title 五、评论调用标签(方法)位于DTcms.Web.UI/Label/article_comment.cs类里面的方法，如果你是一个程序员，随时可以根据自己的要求添加你自己的方法5.1 返回评论数据总数标签根据当前文章的ID查询该文章的评论总数。参数说明：article_id：当前文章ID，int类型strwhere：SQL查询语句get_comment_count(article_id, strwhere) 评论总数：5.2 评论列表标签根据条件显示前几条评论列表，用循环输出。参数说明：article_id： 当前文章ID，int类型top：显示条数，为0时显示所有，int类型strwhere： SQL查询语句get_comment_list(article_id, top, strwhere) 第dr_loop_id楼：drcontent5.3 评论分页列表标签根据条件显示当前页的评论列表，用循环输出，一般情况下很少使用到该标签。参数说明：article_id： 当前文章ID，int类型page_size：每页显示的记录数量，int类型page_index：当前的页码，int类型strwhere： SQL查询语句totalcount： 数据总记录数get_comment_list(article_id, page_size, page_index, strwhere, out totalcount) 第dr_loop_id楼：drcontent六、会员调用标签(方法)位于DTcms.Web.UI/Label/users.cs类里面的方法，如果你是一个程序员，随时可以根据自己的要求添加你自己的方法。6.1 第三方登录应用列表标签适用于在会员登录模板页面列出所有的第三方登录方式应用列表供用户选择参数说明：top： 显示条数，0为显示所有，int类型strwhere： SQL查询语句get_oauth_app_list(top, strwhere) 6.2 根据用户名显示头像路径标签适用于在会员模板页面根据用户名显示头像。参数说明：user_name： 用户名，string类型get_user_avatar(user_name) img src= /6.3 统计短消息数量标签根据SQL查询条件返回对应的短消息总记录数，相关字段说明请查阅DTcms.Model/user_message.cs类文件。参数说明：strwhere： SQL查询语句get_user_message_count(strwhere) 未读短消息：%=get_user_message_count(type条已读短消息：%=get_user_message_count(type条6.4 短消息列表标签根据SQL查询条件返回对应的短消息列表，用循环输出。参数说明：top： 显示条数，0为显示所有，int类型strwhere： SQL查询语句get_user_message_list(top, strwhere) %set DataTable dt=get_user_message_list(0, type 短消息标题：drtitle6.5 短信息分页列表标签根据SQL查询条件返回对应的短消息分页列表，用循环输出。参数说明：page_size： 每页显示条数，int类型page_index： 当前页码，int类型strwhere： SQL查询语句totalcount： 记录总数，out参数，int类型get_user_message_list(page_size, page_index, strwhere, out totalcount) 短消息标题：drtitle记录总数：totalcount页码：pagelist6.6 积分明细分页列表标签根据SQL查询条件返回对应的积分明细分页列表，用循环输出。参数说明：page_size： 每页显示条数，int类型page_index： 当前页码，int类型strwhere： SQL查询语句totalcount： 记录总数，out参数，int类型get_user_point_list(page_size, page_index, strwhere, out totalcount) .记录总数：totalcount页码：pagelist6.7 余额明细分页列表标签根据SQL查询条件返回对应的余额明细分页列表，用循环输出。参数说明：page_size： 每页显示条数，int类型page_index： 当前页码，int类型strwhere： SQL查询语句totalcount： 记录总数，out参数，int类型get_user_amount_list(page_size, page_index, strwhere, out totalcount) .记录总数：totalcount页码：pagelist6.8 充值记录分页列表标签根据SQL查询条件返回对应的充值记录分页列表，用循环输出。参数说明：page_size： 每页显示条数，int类型page_index： 当前页码，int类型strwhere： SQL查询语句totalcount： 记录总数，out参数，int类型get_user_recharge_list(page_size, page_index, strwhere, out totalcount) .记录总数：totalcount页码：pagelist6.9 邀请码列表标签根据SQL查询条件返回对应的邀请码列表，用循环输出。参数说明：top： 显示条数，0为显示所有，int类型strwhere： SQL查询语句get_user_invite_list(top, strwhere) .6.10 邀请码的状态标签根据邀请码字符串