DTcms帮助文档格式.docx
《DTcms帮助文档格式.docx》由会员分享,可在线阅读,更多相关《DTcms帮助文档格式.docx(15页珍藏版)》请在冰豆网上搜索。
loop循环标签
loop循环标签主要是数据列表中使用的,其中自带有行号变量datarow__loop__id,该变量是从1开始
参数说明:
datarow:
DataRow类型的变量,同一页面内不可重复,否则编译出错
datatable:
DataTable类型的变量,使用前请确保该参数已声明赋值
--loop循环标签-->
%loopdatarowdatatable%>
...
%/loop%>
foreach循环标签
foreach标签和C#的语法是一样的,写法也差不多,相信技术人员一看就懂。
注意与loop标签不同的是它没有自带的行号变量,需要手动声明。
type:
数据类型,如DataRow
item:
数据类型的变量名,自定义变量名
list:
数组、结构、对象、引用类型
--foreach循环标签-->
%foreach(typeiteminlist)%>
%/foreach%>
for循环标签
for标签和C#的语法也是一样的,一般很少用到。
i:
整型变量
count:
--for循环标签-->
%for(inti=0;
i<
=count;
i++)%>
%/for%>
if判断语句标签
if判断语句与C#的语法一样,支持二种写法,保留旧的写法
--第一种格式写法(推荐)-->
%if(...)%>
%elseif(...)%>
%/if%>
--第二种格式写法(旧写法)-->
%if...%>
%elseif...%>
continue退出当前循环标签
循环标签中分支用以结束当前循环,直接进入下一次循环的标签,使用方式同传统程序一致。
--continue标签-->
%continue%>
--使用示例,当i等于5时退回并进入下一条循环-->
%if(i==5)%>
break结束循环标签
在循环标签中用以结束循环,进入后续程序的标签,使用方式同传统程序一致。
--break标签-->
%break%>
--使用示例,当i大于5时结束循环-->
%if(i>
5)%>
获取GET传输参数标签
获取URL地址GET传输的参数值
--request标签,varname为参数名-->
{request[varname]}
截取字符串长度标签
当一个字符串的长度大于你想要的值时可使用该标签
num:
int类型,字符串长度
--cutstring标签,{...}为变量-->
%cutstring({...},num)%>
日期格式转换标签
把日期字符串转换成你想要的格式
strFormat:
日期格式
--datetostr标签,{...}为变量-->
%datetostr({...},strFormat)%>
--示例一:
输出年月日格式的日期-->
%datetostr({varname},yyyy年MM月dd日)%>
--示例二:
输出年月日时分秒格式的日期-->
%datetostr({varname},yyyy年MM月dd日HH时mm分ss秒)%>
整型格式转换标签
当一个字符串的想转换成一个整型的数字时可使用该标签
--strtoint标签,{...}为字符串变量-->
{strtoint({...})}
直接输出内容标签
当一个方法返回的是字符串内容,而我们又想直接在模板页中直接输出可使用该标签。
该标签支持两种写法,推荐用第一种。
--第一种写法(推荐)-->
%=方法名(参数一,参数二,...)%>
--第二种写法(旧写法)-->
%write方法名(参数一,参数二,...)%>
声明变量与赋值标签
和C#语法基本一致,需要声明或在需要接受一个方法返回的内容时可以使用该标签。
可选,变量的类型,如果有type则首先创建对象再赋值,否则直接赋值
ref:
变量名,同一页面内不可重复
expression:
变量、常量或方法都可以
%set[type]ref=expression%>
--示例一-->
%setintnum=1%>
--再次使用时不用再声明-->
%setnum=2%>
--示例二-->
%setDataTabledt=get_list(参数一,参数二,...)%>
%set[(type)]{ref}=expression%>
%set(int){num}=1%>
%set{num}=2%>
%set(DataTable){dt}=get_list(参数一,参数二,...)%>
通用标签在所有模板页面都可以使用,如果您下载的是DTcms的源码版,请查看项目下的Label文件夹,如果默认标签不够用的情况下,你也可以在里面新增一些自定义的标签,但记住编译一下整个项目。
一、系统配置标签(变量)
系统配置的一些信息,实际上是源码项目中的里面的属性,里面都有详细的备注与注释
标签
描述
示例
{}
主站名称
动力启航
主站域名
公司名称
XX软件有限公司
公司地址
XX省XX市XX区XX号
联系电话
传真号码
管理员
网站备案号
粤TC/ICP备XX号
网站安装目录,/代表放在根目录
/
网站后台管理目录
admin
是否开启生成静态,0不开启,1伪静态,2全静态
1
生成静态扩展名
html
手机网站状态,0关闭1开启
手机网站绑定域名
开启会员功能,0不开启,1开启
开启评论审核,0不审核,1开启审核机制
后台管理日志,0关闭,1开启
是否关闭网站,0正常,1关闭
网站关闭原因描述
网站正在维护,请稍候访问...
网站统计代码,支持HTML
script>
...<
/script>
短信API地址
,MD5加密字符串
a34de42fededferkc63fe
手机短信签名
邮件STMP服务器
加密连接
邮件SMTP端口
25
发件人地址
邮箱账号
邮箱密码,内置加密算法
发件人昵称
网站管理员
附件上传目录名
upload
附件保存方式,1按年月日保存,2按年月/日/保存
附件上传类型,以逗号分隔开
gif,png,doc
视频上传类型,以逗号分隔开
mp4,flv
附件上传大小,单位为KB
2048
视频上传大小,单位为KB
图片上传大小,单位为KB
1024
图片最大高度(像素)
图片最大宽度(像素)
生成缩略图高度(像素)
生成缩略图宽度(像素)
图片水印类型,0关闭,1文字,2图片
图片水印位置,1-9
9
图片生成质量,0-100
80
图片水印文件
水印透明度,1-10
5
水印文字
文字字体
Arial
水印文字大小(像素)
12
当前站点的配置信息,只能在当前模板页面中使用这些标签,它和上面的系统配置不同,例如当前访问的是站点A,加载的就是站点A的配置信息。
网站名称
网站域名
网站LOGO
/upload
.
记录总数:
{totalcount}
页码:
{pagelist}
余额明细分页列表标签
根据SQL查询条件返回对应的余额明细分页列表,用循环输出。
page_size:
每页显示条数,int类型
page_index:
当前页码,int类型
strwhere:
SQL查询语句
totalcount:
记录总数,out参数,int类型
get_user_amount_list(page_size,page_index,strwhere,outtotalcount)
--示例:
显示用户名为test余额明细分页列表-->
--取得一个DataTable,page为当前页码变量,totalcount为已声明的变量-->
%setDataTabledt=get_user_amount_list(10,page,"
user_name='
test'
"
outtotalcount)%>
--取得分页页码列表,action为变量,相关说明请查阅get_page_link分页标签-->
%setstringpagelist=get_page_link(10,page,totalcount,"
useramount"
action,"
__id__"
)%>
--使用循环输出-->
%foreach(DataRowdrin%>
充值记录分页列表标签
根据SQL查询条件返回对应的充值记录分页列表,用循环输出。
get_user_recharge_list(page_size,page_index,strwhere,outtotalcount)
显示用户名为test充值记录分页列表-->
%setDataTabledt=get_user_recharge_list(10,page,"
邀请码列表标签
根据SQL查询条件返回对应的邀请码列表,用循环输出。
top:
显示条数,0为显示所有,int类型
get_user_invite_list(top,strwhere)
显示用户名为test的所有邀请码列表-->
%setDataTabledt=get_user_invite_list(0,"
邀请码的状态标签
根据邀请码字符串返回一个布尔值,True为可用,False为不可用。
str_code:
需要验证的邀请码字符串,string类型
get_invite_status(str_code)
验证邀请码字符串“ER98FE888”是否有效-->
%setboolstatus=get_invite_status("
ER98FE888"
%if(status==true)%>
该邀请码有效
%else%>
该邀请码已使用过或已过期
七、订单调用标签(方法)
位于类里面的方法,如果你是一个程序员,随时可以根据自己的要求添加你自己的方法。
统计订单数量标签
根据查询条件统计订单总记录数。
get_user_order_count(strwhere)
查询用户名为test未完成的订单总数-->
未完成订单:
%=get_user_order_count("
status<
3anduser_name='
订单列表标签
根据查询条件显示前几行订单列表,用循环输出。
get_order_list(top,strwhere)
查询用户名为test所有未完成的订单列表-->
%setDataTabledt=get_order_list(0,"
订单分页列表标签
根据SQL查询条件返回对应的订单分页列表,用循环输出。
get_order_list(page_size,page_index,strwhere,outtotalcount)
显示用户名为test订单分页列表-->
%setDataTabledt=get_order_list(10,page,"
userorder"
订单商品列表标签
根据订单的ID查找对应的商品列表,返回的是List<
实体对象
order_id:
订单ID,int类型
get_order_goods_list(order_id)
--查询订单ID为5的商品信息-->
%setList<
ls=get_order_goods_list(5)%>
%foreachmodeltinls)%>
返回订单状态标签
根据订单ID查询当前订单处理状态描述,例如:
待付款。
get_order_status(order_id)
查询订单ID为5的状态描述-->
订单状态:
%=get_order_status(5)%>
返回订单是否需要在线支付标签
根据订单ID查询当前订单是否需要在线支付,返回布尔值,True代表需要在线支付,False代表不需要在线支付。
get_order_payment_status(order_id)
查询订单ID为5是否需要在线支付-->
%setboolstatus=get_order_payment_status(5)%>
.
九、配送方式调用标签(方法)
配送方式列表标签
根据查询条件显示前几行配送方式列表,用循环输出。
get_express_list(top,strwhere)
查询所有配送方式列表-->
%setDataTabledt=get_express_list(0,"
返回配送方式标题标签
根据配送方式的ID查询该配送方式的标题名称。
express_id:
配送方式的ID,int类型
get_express_title(express_id)
查询配送方式ID为5的标题名称-->
配送方式:
%=get_express_title(5)%>
十、支付方式调用标签(方法)
支付方式列表标签
根据查询条件显示前几行支付方式列表,用循环输出。
get_payment_list(top,strwhere)
%setDataTabledt=get_payment_list(0,"
返回支付方式标题标签
根据支付方式的ID查询该支付方式的标题名称。
payment_id:
支付方式的ID,int类型
get_payment_title(payment_id)
查询支付方式ID为5的标题名称-->
支付方式:
%=get_payment_title(5)%>
返回支付费用金额标签
根据支付方式的ID查询该支付方式的手续费用,返回一个decimal类型的货币格式。
total_amount:
参与计算的商品总金额,decimal类型
get_payment_poundage_amount(payment_id,total_amount)
查询支付方式ID为5,商品金额为100的支付手续费用-->
支付手续费:
%=get_payment_poundage_amount(5,100)%>