标签说明
CSCMSv4模板标签详细调用说明
本篇主要介绍CSCMSv4模板标签的基础生成方法
CSCMSv4的基础标签生成:
{cscms:标示 table="数据表名称" field="需要显示的字段" loop="20" order="desc"}
当前循环序号:[标示:i](从1开始)
字段调用方式:[标示:字段名称]
{/cscms:标示}
标示:为小写字母或者数字;
table:数据表名称:也就是需要调用的数据表(不包含表前缀);
field:需要显示的字段:数据表字段名称,需要查询所有字段留空或者*即可;
sql:需要运行的完整SQL语句;
loop:调用数量,分页用pagesize;
start:数据起始位置,缺省值为1
sort:排序方式,随机为rand, 缺省值为id;
order:正/反 asc desc或者 id desc/id asc 缺省值为desc;
字段名称=”auto” :显示当前分类数据(需要板块的支持)
——新增标签——
where:需要需要查询的条件语句;
limit:调用数量,如:10 / 5,10(和loop只需一个即可)
//最新20首歌曲实例
{cscms:dance table="dance" field="id,name" loop="20" order="desc"}
<a href="[dance:url zdy=dance,id,play,id]">[dance:i].[dance:name]</a>
{/cscms:dance}
//或者最新推荐20首按人气排序
{cscms:dance table="dance" field="id,name" whrer="reco>0" order="hits desc" limit="20"}
<a href="[dance:url zdy=dance,id,play,id]">[dance:i].[dance:name]</a>
{/cscms:dance}
//下面为一级嵌套二级案列
{cscms:class table="dance_list" field="id,name" fid="0" sort="xid" order="desc"}
<a href="[class:url zdy=dance,id,lists,id]">[class:i].[class:name]</a><br><br>
{cscmstype:dance2 table="dance" field="id,name" cid="auto" loop="20" order="desc"}
<a href="[dance2:url zdy=dance,id,play,id]">[dance2:i].[dance2:name]</a><br>
{/cscmstype:dance2}
{/cscms:class}
下面是一些基础全局标签
v4标签示例
{cscms:indexhead} //主站的头部
{cscms:indexleft} //主站的左部
{cscms:indexright} //主站的右部
{cscms:indexbottom} //主站的下部
{cscms:indextempurl} //主站模板目录
---------------------------------------------
{cscms:head} //头部
{cscms:left} //左部
{cscms:right} //右部
{cscms:bottom} //下部
{cscms:tempurl} //当前模板目录
{cscms:webname} //站点名称
{cscms:weburl} //站点域名,不带 http://
{cscms:path} //站点地址,带 http://
{cscms:stat} //统计代码
{cscms:notice} //站点公告
{cscms:regxy} //注册协议
{cscms:title} //全局SEO标题
{cscms:keywords} //全局SEO关键词
{cscms:description} //全局SEO介绍
{cscms:mail} //管路员邮箱
{cscms:qq} //管理员QQ
{cscms:tel} //管理员电话
{cscms:icp} //网站备案号
{cscms:login} //判断当前是否登录 已经登录: ok 未登录:no
{cscms:uid} //当前登录的会员ID,未登录显示0
{cscms:logkuang} //全局会员登陆框,调用模板 ulogin.html uinfo.html
全局部分链接标签:
v4标签示例
{cscms:gbooklink} //网站留言
{cscms:solink} //搜索链接
{cscms:codes} //验证码地址
{cscms:userlink} //会员版块
{cscms:loginlink} //会员登录
{cscms:reglink} //会员注册
{cscms:passlink} //密码找回
{cscms:qqlink} //QQ登录
{cscms:weixinlink} //微信登录(目前只支持官方登陆)
{cscms:weibolink} //微博登录
{cscms:kaixinlink} //开心账号登录
{cscms:baidulink} //百度账号登录
{cscms:doubanlink} //豆瓣账号登录
{cscms:renrenlink} //人人账号登录
下面是内部字段自定义标签:
格式化时间:[标示:addtime style=Y-m-d H:i:s] 可以多个或者单个,=time 显示 XX小时前
获取当前IP地理位置:[标示:ip style=city]
图片地址:[标示:pic dir=版块目录],版块目录为上传调用目录,比如歌曲图片:[dance:pic dir=dance]
字符截取:[标示:name len=10],len=显示数量
外部字段自定义标签:
IP地理位置:[标示:addres zd=ip],ip为存储IP记录的字段名
数据统计:[标示:count zdy=数据表,要查询的字段,当前字段],如查询当前会员的歌曲数量:[user:count zdy=dance,uid,id]
会员信息:[标示:user zd=要查询的字段名],如查询会员QQ,[dance:user zd=qq],版块必须包含字段uid或者uidb,uida
会员等级:[标示:user level=1],1星星数,2下个级别需要经验,3下个级别剩余经验,4剩余百分比,5等级名称
歌手信息:[标示:singer zd=字段名],如歌手名称:[dance:singer zd=name],版块数据表字段必须包含singerid
自定义链接:
版块链接:[标示:murl]
网站链接:[标示:url link=类别,排序方式],如歌曲播放链接:[dance:url link=play,id],只能在当前版块调用
会员主页:[标示:url ulink=控制器,方法],如会员主页:[dance:url ulink=index]
会员中心:[标示:url userlink=控制器,方法],如修改资料 [user:url userlink=edit]
自定义URL:[标示:url zdy=版块,调用字段,控制器,方法],如在主页调用歌曲版块的播放地址:[dance:url zdy=dance,id,play,id]
-PHP标签:
v4标签示例
{cscmsphp}
//.....php代码.......
{/cscmsphp}
if 判断:
v4标签示例
{if:条件==条件}
.....
{else}
.....
{end if}
JS动态调用统计标签:
v4标签示例
{cscmscount param="数据表|要查询的字段=内容|要查询的字段=内容|..."}
比如查询当前在线会员:{cscmscount param="user|zx=1"}
会员主页模板列表:
v4标签示例
{cscmsweb}
[web:pic] //模板图片地址
[web:name] //模板名称
[web:dir] //模板目录
[web:path] //模板路径
[web:vip] //需要会员组ID
[web:level] //需要等级ID
[web:cion] //需要金币
{/cscmsweb}
一级嵌套二级:
v4标签示例
{cscms:标示 table="数据表名称" field="需要显示的字段" loop="20" order="desc"}
当前循环序号:[标示:i](从1开始)
字段调用方式:[标示:字段名称]
{cscmstype:标示2 table="数据表名称" field="需要显示的字段" 条件="内容" loop="20" order="desc"}
当前循环序号:[标示2:i](从1开始)
字段调用方式:[标示2:字段名称]
{/cscmstype:标示2}
{/cscms:标示}s
字母调用方法:
v4标签示例
{cscmszm:27}
[zm:name] 字母
{/cscmszm}
自定义标签:
v4标签示例
自定义标签:{cscmsself:标示} 标示为后台新增
自定义JS标签解析: {cscmsjs:标示} 标示为后台新增
自定义页面标签解析: {cscmspage:标示} 标示为后台新增
自定义模板文件标签:
v4标签示例
{cscms:opt-版块名-文件表示}
如:{cscms:opt-hits} 那么就是调用的当前模板目录的 opt-hits.html文件
如:{cscms:opt-dance-hits} 那么就是调用的dance版块模板目录的 opt-hits.html文件
解析会员中心版块链接导航:
v4标签示例
{cscmsmenu:user}
[menu:name] //版块名称
[menu:dir] //版块目录
{cscmsmenu:auto}
[menu:i] //排序重1开始
[menu:link] //链接地址
[menu:name] //链接名称
{/cscmsmenu:auto}
{/cscmsmenu}
全局分页标签:
v4标签示例
{cscms:pagenow} //当前页码(从1开始)
{cscms:pagecout} //总页数
{cscms:pagedata} //总数量
{cscms:pagesize} //每页显示多少条记录
{cscms:pageup} //上一页连接
{cscms:pagedown} //下一页连接
{cscms:pagefirst} //首页连接
{cscms:pagelast} //尾页连接
{cscms:pagelist} //翻页标签
{cscms:pagenum len=8} //显示页数,当前页CSS元素为 on
前台JS函数
本篇主要介绍前台模板内置的js函数,这些函数可在任意的前台模板中调用,注意:所有内置的js函数都包含在cscms对象中
工具类集合
集成工具:jQuery、Layui
为方便用户快捷上手开发,我们在程序中集成了jQuery和Layui;jQuery是一款快速、简洁的JavaScript框架,可适应各种场景的需要;Layui是一款丰富的前端框架,具有优秀的web弹层组件
对于jQuery:直接使用jQuery的语法即可
对于Layui:我们在cscms对象中加载了element、form、upload、laydate、layer、layedit这6个模块,若使用某模块时,则用cscms.模块名来调用即可;以下仅为部分功能展示,更多功能可参考layui的官方文档
函数示例
//具备layui的所有功能,仅调用略有不同
//举例:msg弹出提示
cscms.layer.msg('这是cscms的弹出提示');
cscms.layer.msg('这是cscms的成功时的弹出提示',{icon:2});
cscms.layer.msg('这是cscms的失败时的弹出提示',{icon:2});
//举例:alert确认框
cscms.layer.alert('内容');
//举例:confirm询问框
cscms.layer.confirm('您是如何看待前端开发?', {
btn: ['重要','奇葩'] //按钮
}, function(){
layer.msg('的确很重要', {icon: 1});
}, function(){
layer.msg('也可以这样', {
time: 20000, //20s后自动关闭
btn: ['明白了', '知道了']
});
});
获取当前主域名:cscms.get_host()
该函数的返回值为当前网站的域名
函数示例
var domain = cscms.get_host();
console.log(domain);
弹出窗口:cscms.get_open(url,title,w,h)
该函数用来在屏幕中央弹出一个新窗口
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 窗口链接地址 | 准备在窗口中展示内容的URL地址 |
| title | 窗口标题 | 弹出新窗口的标题,即提示用户该窗口是做什么的 |
| w | 窗口宽度 | 弹出窗口的宽度,单位px |
| h | 窗口高度 | 弹出窗口的高度,单位px |
函数示例
//用小窗口打开cscms官网
cscms.get_open('www.chshcms.com','CSCMS v4.x官网','500px','300px');
页面滚动:cscms.scroll(id)
该函数用于滚动到页面的指定位置,如:评论的输入框id为cscms_pl_content,则使用cscms.scroll(‘cscms_pl_content’)就可以把页面滚动到输入框的位置,若给顶部和底部设置id,也同样可以滚动到顶部或底部
| 参数 | 属性值 | 备注 |
|---|---|---|
| id | 滚动到指定位置 | 需要为一个元素设置id,然后调用 cscms.sroll(id) 即可滚动到该位置 |
异步加载js:cscms.inc_js(path)
该函数用于异步加载js,参数path为该js的绝对路径
| 参数 | 属性值 |
|---|---|
| path | js的绝对路径 |
初始化后执行:cscms.mode(func)
该函数用来在layui模块初始化完成后执行相关操作,初始化操作是在页面的底部进行的,并且初始化需要等待几毫秒;若在页面的中间或者上面使用layer的功能,需要等待初始化完成后才能执行,一般情况下是不需要该操作的,仅在页面加载完成前或页面加载完成时立即执行的layui相关的操作才会需要该函数
| 参数 | 属性值 | 备注 |
|---|---|---|
| func | 需要执行的操作 | 把操作代码当作字符串传入 |
| title | 窗口标题 | 弹出新窗口的标题,即提示用户该窗口是做什么的 |
函数示例
//页面加载为完成时执行cscms.layer.msg('弹出提示')的操作
cscms.mode("cscms.layer.msg('弹出提示')");
文件上传一:cscms.getUpload(url,id,elem,accept,sign)
该上传函数没有上传进度展示,主要用于偏小的文件上传,比如会员logo、图片等
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 处理上传文件url | 指定上传的URL,完整路径 |
| id | 元素id | 点击响应上传的元素的id,如点击button按钮进行上传,则id即为button的id;可留空,默认pic |
| elem | 返回值保存元素的id | 上传成功后,返回文件的路径url,若让url在一个input中显示,则即为该input元素的id;可留空,默认pics |
| accept | 指定文件格式 | 多个格式用|分割,如图片格式:jpg|jpeg|bmp|gif,可留空,默认为图片 |
| sign | 返回值保存方式 | 0:直接覆盖,1:末尾追加,可留空,默认0 |
函数示例
<form action="www.xxx.com/picdata/save">
<input id="pic" value="" />
<button id="pics">上传图片</button>
<script type="text/javascript">
cscms.mode("cscms.getUpload('www.xxx.com/upload/save','pic','pics','jpg|gif|png',0)");
</script>
</form>
文件上传二:cscms.get_upurl(dir,fid,type,tsid)
该上传函数会展示一个弹框,宽高自适应,手机宽为屏幕90%、高为350px;电脑宽为500px、高350px;且具有进度条显示,可用于需要进度条的上传方式
| 参数 | 属性值 | 备注 |
|---|---|---|
| dir | 板块标识 | 上传文件的板块标识,如音乐板块dance |
| fid | 返回值保存元素的id | 上传成功后,返回文件的路径url,若让url在一个input中显示,则即为该input元素的id |
| type | 指定文件格式 | 多个格式用|分割,如图片格式:jpg|jpeg|bmp|gif;可留空,默认为图片 |
| tsid | 提示性语句id | 如上传完成后想在<span id=”up_msg”></span>中提示,则tisd的值为up_msg,可留空 |
函数示例
<form action="www.xxx.com/picdata/save">
<input id="pic" value="" />
<span id="up_msg">等待上传...</span>
<button onclick="cscms.get_upurl('dance','pic','jpg|png|gif|bmp|jpeg','up_msg')">上传图片</button>
</form>
日期时间:cscms.getTime(elem,type)
该函数用于选择日期时间,只需要给input设置一个id即可,然后在<script></script>中绑定该id即可
| 参数 | 属性值 | 备注 |
|---|---|---|
| elem | 日期input的id | 需要选择时间的input的id值 |
| type | 日期的类型 | date:短日期如2017-01-01 ;datetime:长日期如:2017-01-01 00:00:00,可留空,默认为date短时间 |
函数示例
<input id="mydate" value="" />
<script>
cscms.mode("cscms.getTime('mydate','datetime')");
</script>
后台JS函数
本篇主要介绍后台内置的js函数,注意:所有内置的js函数都包含在cscms对象中
集成工具:jQuery、Layui
为方便用户快捷上手开发,我们在程序中集成了jQuery和Layui;jQuery是一款快速、简洁的JavaScript框架,可适应各种场景的需要;Layui是一款丰富的前端框架,具有优秀的web弹层组件
对于jQuery:直接使用jQuery的语法即可
对于Layui:我们在cscms对象中加载了element、form、upload、laydate、layer、layedit这6个模块,若使用某模块时,则用cscms.模块名来调用即可;以下仅为部分功能展示,更多功能可参考layui的官方文档
函数示例
//具备layui的所有功能,仅调用略有不同
//举例:msg弹出提示
cscms.layer.msg('这是cscms的弹出提示');
cscms.layer.msg('这是cscms的成功时的弹出提示',{icon:2});
cscms.layer.msg('这是cscms的失败时的弹出提示',{icon:2});
//举例:alert确认框
cscms.layer.alert('内容');
//举例:confirm询问框
cscms.layer.confirm('您是如何看待前端开发?', {
btn: ['重要','奇葩'] //按钮
}, function(){
layer.msg('的确很重要', {icon: 1});
}, function(){
layer.msg('也可以这样', {
time: 20000, //20s后自动关闭
btn: ['明白了', '知道了']
});
});
初始化后执行:cscms.mode(func)
该函数用来在layui模块初始化完成后执行相关操作,初始化操作是在页面的底部进行的,并且初始化需要等待几毫秒;若在页面的中间或者上面使用layer的功能,需要等待初始化完成后才能执行,一般情况下是不需要该操作的,仅在页面加载完成前或页面加载完成时立即执行的layui相关的操作才会需要该函数
| 参数 | 属性值 | 备注 |
|---|---|---|
| func | 需要执行的操作 | 把操作代码当作字符串传入 |
| title | 窗口标题 | 弹出新窗口的标题,即提示用户该窗口是做什么的 |
函数示例
//页面加载为完成时执行cscms.layer.msg('弹出提示')的操作
cscms.mode("cscms.layer.msg('弹出提示')");
下拉框页面跳转:cscms.goto_page(url)
该函数用于下拉框的页面跳转,下拉框select的id必须设置为goto_page;然后只需在跳转按钮上设置onclick=”cscms.goto_page(‘www.xxx.com/test/index?page=’)”即可,url和页面是拼接关系
弹出窗口:cscms.get_open(url,title,w,h)
该函数用来在屏幕中央弹出一个新窗口
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 窗口链接地址 | 准备在窗口中展示内容的URL地址 |
| title | 窗口标题 | 弹出新窗口的标题,即提示用户该窗口是做什么的 |
| w | 窗口宽度 | 弹出窗口的宽度,单位px |
| h | 窗口高度 | 弹出窗口的高度,单位px |
函数示例
//用小窗口打开cscms官网
cscms.get_open('www.chshcms.com','CSCMS v4.x官网','500px','300px');
全选反选函数:cscms.select_all()
该函数用于复选框的全选和反选,只需在复选框的input上增加class=”xuan”,然后在全选反选的按钮上设置onclick=”cscms.select_all()”即可
单项删除:cscms.del_one(url,id)
该函数用来删除某条数据,并在成功后移除该数据行,假设要删除id=1024的数据则,该数据行的id为row_1024;如删除id=1024的数据,则只需在删除按钮上设置onclick=”cscms.del_one(‘www.xxx.com/index.php/del’,1024)”
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 执行删除的url | 如:音乐板块为/index.php/dance/admin/dance/del |
| id | 数据id | 该数据行的id |
单选状态切换:cscms.show_hide(cls,name)
该函数用于切换显示状态的,即当单选结果变化时,切换与其相关的元素的状态;比如:有两个单选按钮,网站开启和网站关闭,一个input输入框作为关闭网站时的提示信息;那么点击网站开启,隐藏input;点击网站关闭,显示input;这时就可使用该函数实现
| 参数 | 属性值 | 备注 |
|---|---|---|
| cls | 元素的class | 凡是需要显示或者隐藏的元素都需加上该clss |
| name | 单选框的name | 同组单选框的name属性值 |
文件上传:cscms.getUpload(url,id,elem,accept,sign)
该上传函数没有上传进度展示,主要用于偏小的文件上传,比如会员logo、图片等
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 处理上传文件url | 指定上传的URL,完整路径 |
| id | 元素id | 点击响应上传的元素的id,如点击button按钮进行上传,则id即为button的id;可留空,默认pic |
| elem | 返回值保存元素的id | 上传成功后,返回文件的路径url,若让url在一个input中显示,则即为该input元素的id;可留空,默认pics |
| accept | 指定文件格式 | 多个格式用|分割,如图片格式:jpg|jpeg|bmp|gif,可留空,默认为图片 |
| sign | 返回值保存方式 | 0:直接覆盖,1:末尾追加,可留空,默认0 |
函数示例
<form action="www.xxx.com/picdata/save">
<input id="pic" value="" />
<button id="pics">上传图片</button>
<script type="text/javascript">
cscms.mode("cscms.getUpload('www.xxx.com/upload/save','pic','pics','jpg|gif|png',0)");
</script>
</form>
链接访问函数:cscms.go_url(url)
该函数为链接访问函数,返回json数据,error=0为成功,其他则为失败,格式参见getjson函数;当返回值data对象中 data.info.url 存在时则跳转到 data.info.url;否则弹出提示 data.info.msg
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 访问链接地址 |
提交选中项:cscms.sel_submit(url,cid)
该函数用于提交选中的项,注意:相应复选框的input上应有class=”xuan”,提交方法为post,提交参数id为数组,cid参数表示是否提交分类id,默认为空不提交
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 接收数据的 | |
| cid | 提交分类参数 | 默认为空,不提交分类参数,当值不等于0不为空时表示提交分类参数,参数名为cid,参数值由$(‘#zhuan option:selected’) .val()获取,多用于分类转移的操作 |
询问提交:cscms.go_confirm(url,title,sign)
该函数访问链接之前会弹出一个询问框,若确定则继续访问,若取消则停止访问
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 接收数据的 | |
| title | 提示语句 | 展示给用户,让用户选择确定还是取消 |
| sign | 0,1,2 | 0:确定后用cscms.go_url(url)提交;1:确定后用cscms.sel_submit(url)提交;2:确定后用cscms.sel_submit(url,sign)提交 |
选中生成:cscms.go_html(url)
该函数用于将选中数据项生成静态html,需在复选框的input上增加class=”xuan”
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 链接地址 | 生成静态文件的地址 |
星级推荐:cscms.get_tj(url,td_,id,sid)
该函数用于对数据设置推荐级别
| 参数 | 属性值 | 备注 |
|---|---|---|
| url | 推荐处理地址 | |
| td_ | 父元素id参数 | 一般可设置父元素的id属性为’tj_’拼接数据id,则参数td_即可为’tj_’ |
| id | 数据项的id | |
| sid | 推荐星数 | 0:不推荐;1:推荐1星;2:推荐2星;3:推荐3星;4:推荐4星;5:推荐5星 |
批量修改:cscms.pl_edit(url,title,w,h)
该函数用于显示批量修改界面,复选框input需有class=”xuan”属性
| 参数 | 属性值 |
|---|---|
| url | 批量处理地址 |
| title | 修改框的标题 |
| w | 弹出修改框的宽度 |
| h | 弹出修改框的高度 |
日期时间:cscms.getTime(elem,type)
该函数用于选择日期时间,只需要给input设置一个id即可,然后在<script></script>中绑定该id即可
| 参数 | 属性值 | 备注 |
|---|---|---|
| elem | 日期input的id | 需要选择时间的input的id值 |
| type | 日期的类型 | date:短日期如2017-01-01 ;datetime:长日期如:2017-01-01 00:00:00,可留空,默认为date短时间 |
函数示例
<input id="mydate" value="" />
<script>
cscms.mode("cscms.getTime('mydate','datetime')");
</script>
前台PHP函数
PHP 函数库
本篇主要介绍常用的PHP函数,此类函数既可以在控制器中使用也可以在模板中使用,但在前台模板中使用PHP语法必须用标签 {cscmsphp}{/cscmsphp} 包裹起来;举例:获取任意字段函数getzd,在模板中需写成{cscmsphp}getzd(‘user’,’name’,1024,’id’);{/cscmsphp};在后台模板中使用PHP语法可用标签 包裹起来;举例:获取任意字段函数getzd,写成<?=getzd(‘user’,’name’,1024,’id’)?>
PHP 常用函数
获取任意字段:getzd($table,$ziduan,$id,$cha)
从数据库中获取任意字段信息,即获取数据表$table中字段$cha的值等于$id的那条数据中字段$ziduan的值
例如:已知会员id等于1024,则查询会员名称,函数表示为getzd(‘user’,’name’,1024,’id’)
| 参数 | 属性值 | 备注 |
|---|---|---|
| $table | 数据表名 | 准备获取数据所在的表名称,必填项 |
| $ziduan | 字段名 | 该数据表中的字段名称 |
| $id | 查询条件字段的值 | 必填项 |
| $cha | 查询条件字段名称 | 可以留空,默认为id |
| 返回值 | 查询字段值 | 存在为字符串类型,否则为null |
函数示例
//查询会员id=1024的会员的名称
getzd('user','name',1024);
getzd('user','name',1024,'id');
//查询会员名称为cscms的会员的昵称
getzd('user','nichen','cscms','name');
判断是否关注对方:getgz($uid)
判断当前登陆会员是否关注过对方
| 参数 | 属性值 | 备注 |
|---|---|---|
| $uid | 会员id | 对方会员的id |
| 返回值 | 0、1 | 0:未关注,1:已关注 |
获取会员等级:getlevel($jinyans=0,$type=0)
回去会员的等级,情况一:获取等级数:如10,20,30;情况二:获取等级符号:如星星,月亮,太阳;情况三:获取达到下一个等级需要的经验值;情况四:获取达到下一个等级剩余的经验值;情况五:获取达到下一个等级的百分比;情况六:获取等级名称,如:初级,高级;
| 参数 | 属性值 | 备注 |
|---|---|---|
| $jinyans | 会员经验值 | 会员的经验值,会员表的jinyan字段 |
| $type | 获取结果类型 | 0:情况一;1:情况二;2:情况三;3:情况四;4:情况五;5:情况六 |
| 返回值 | 由对应情况决定 |
函数示例
//假设会员cscms的经验值为1000,获取其等级数
getlevel(1000,0);
//假设会员cscms的经验值为1000,获取其星星数
getlevel(1000,1);
//假设会员cscms的经验值为1000,获取其达到下一个级别需要的经验值
getlevel(1000,3);
获取随机颜色:random_color()
获取一个随机的颜色,如:#FFFFFF,#ABCDEF
函数示例
random_color();
获取数据总数:getcount($table=”,$day=0)
获取某数据表最近N天新增的数据数量
| 参数 | 属性值 | 备注 |
|---|---|---|
| $table | 数据表 | 数据表名,如:dance,vod |
| $day | 天数 | 最近多少天,如:最近7天 |
| 返回值 | 返回数量 |
前台页面返回信息:msg_url($title,$url,$time)
跳转一个提示页面
| 参数 | 属性值 | 备注 |
|---|---|---|
| $title | 页面提示信息 | 给用户的提示信息 |
| $url | 提示完成后要跳转的地址 | 不能为空 |
| $time | 停留的时间 | 单位毫秒,可以为空,默认值3000 |
函数示例
//提示用户未登录,2秒后跳转到首页
msg_url('尚未登录','/',2000);
获取token令牌:get_token($name,$s,$time)
获取或销毁一个令牌
| 参数 | 属性值 | 备注 |
|---|---|---|
| $name | 令牌标识 | 任意取名,如:userlogin,dance |
| $s | 类型:0,1,2 | 0:写入token;1:判断token是否一致,2,:销毁token;可以为空,默认值为0 |
| $time | 因$s不同而不同 | $s=0时,作为token有效时长,可以为空,默认为3600秒;$s=2时,作为比较的token值 |
| 返回值 | true / false |
函数示例
//保存一个名为userreg的token
get_token('userreg');
//保存一个名为userreg的token,时长5分钟
get_token('userreg',0,3000);
//判断名为userreg的token值是否等于'tismytoken'
get_token('userreg',2,'tismytoken');
//销毁名为userreg的token
get_token('userreg',1);
获取IP地址:getip()
获取当前用户的ip地址
函数示例
getip();
加载语言:L($key)
加载语言函数,自动根据语言版本获取不同的值
| 参数 | 属性值 | 备注 |
|---|---|---|
| $key | 语言键名 | 根据键名,不同语言版本不同 |
函数示例
//假设英文版plub_01的键值为title,中文版为标题;当前设置为中文版则L('plub_01')的值为标题,当前设置为英文版则L('plub_01')的值为title
L('plub_01');
写文件:write_file($path, $data, $mode)
将数据写入指定路径的文件中
| 参数 | 属性值 | 备注 |
|---|---|---|
| $path | 文件绝对路径 | 文件的绝对路径,不能为空 |
| $data | 文件内容 | 写入的内容,字符串类型,不能为空 |
| $mode | 文件的访问类型 | 参加PHP原生函数fopen的第二个参数mode |
| 返回值 | 文件绝对路径 | 写入成功返回true,否则返回false |
递归创建文件夹:mkdirss($dir)
用递归的方式创建文件夹
| 参数 | 属性值 | 备注 |
|---|---|---|
| $dir | 文件绝对路径 | 文件的绝对路径,不能为空 |
JSON数据:getjson($info,$error,$sign,$callback)
返回指定格式的JSON数据
| 参数 | 属性值 | 备注 |
|---|---|---|
| $info | 返回数据数组或字符串 | 可以为字符串也可以是数组 |
| $error | 标识 | 阿拉伯数字,默认为1 |
| $sign | 默认为0 | 1表示前台操作;0表示后台 |
| $callback | 默认为空 | 为方便传递callback参数 |
函数示例
//其中info中的内容可自定义,在前台可用msg引用info的内容,即data.msg.url与data.info.url是等同的
{
"error": 0
,"info": {
' url':''
}
}
PHP 链接函数
链接生成函数:get_link($uri)
通用链接生成函数,该函数根据uri生成链接,地址不会根据静态规则改变,所以最好用于非静态页面的URL,如会员中心;若站点为动态、伪静态,则无影响
| 参数 | 属性值 | 备注 |
|---|---|---|
| $uri | 链接uri参数 | 如获取歌曲id=1024的播放页,其uri为dance/play/id/1024;则地址为get_link(‘dance/play/id/1024’) |
版块连接地址解析:cscmslink($dir)
该函数用于解析板块的链接,链接地址为板块首页,如跳转到音乐板块:cscmslink(‘dance’)
| 参数 | 属性值 | 备注 |
|---|---|---|
| $dir | 板块名称 | 如获取音乐板块链接:cscmslink(‘dance’);如获取视频板块链接:cscmslink(‘vod’); |
版块人气地址解析:hitslink($path,$dir)
该函数用于生成访问增加人气的链接地址,如:歌曲板块的增加人气的地址为hits控制器中ids方法,则给id=1024的歌曲增加人气的地址为:hitslink(‘hits/ids/1024′,’dance’);
| 参数 | 属性值 | 备注 |
|---|---|---|
| $path | uri路径 | 控制器/方法/参数1/参数2…;如:hits/ids/1024 |
| $dir | 板块名称 | 如音乐板块:dance;视频板块:vod;新闻板块:news等 |
连接地址解析函数:linkurl($fid,$sort,$id,$pid,$dir)
该函数用于解析链接地址,站点静态模式时可解析静态链接规则,推荐使用
| 参数 | 属性值 | 备注 |
|---|---|---|
| $fid | 控制器 | 板块控制器,如:音乐播放为play |
| $sort | 排序或方法 | 如音乐播放为id; |
| $id | 数据id | 如:音乐id,视频id |
| $pid | 分页页数 | 默认值为1 |
| $dir | 板块名称 | 如:音乐板块dance,视频板块vod |
函数示例
//生成id=1024的音乐的播放页面
linkurl('play','id',1024,'dance');
//生成id=1024的视频的简介
linkurl('show','index',1024,'vod');
会员主页相关链接:userlink($Classid,$Uid,$Name,$ID,$Pages)
该函数用于解析会员主页相关链接地址
| 参数 | 属性值 | 备注 |
|---|---|---|
| $Classid | 板块名称 | 板块名称:如index:会员主页的首页;dance:音乐板块,vod:视频板块 |
| $Uid | 会员id | 纯数字,不要留空 |
| $Name | 会员名称 | 不能留空 |
| $ID | 板块分类ID | 板块下某分类的ID,如dance分类流行歌曲的id,可以留空,留空代表所以分类 |
| $Pages | 分页数 | 可以留空,留空代表第一页 |
函数示例
//会员cscms,id=1024的会员主页的首页
userlink('index',1024,'cscms');
//会员cscms,id=1024的会员主页的音乐板块地址
userlink('dance',1024,'cscms');
//会员cscms,id=1024的会员主页的音乐板块,流行歌曲(id=2)的列表
userlink('dance',1024,'cscms',2);
//会员cscms,id=1024的会员主页的音乐板块,流行歌曲(id=2)的第三页列表
userlink('dance',1024,'cscms',2,3);
会员中心相关链接:spacelink($url,$dir)
该函数用于解析会员中心相关链接地址
| 参数 | 属性值 | 备注 |
|---|---|---|
| $url | 链接路径 | 控制器/方法/参数1/参数2…;如:fav/index/1 |
| $dir | 板块名称 | 主板块:sys;音乐:dance;等等… |
函数示例
//会员中心首页
spacelink('space');
spacelink('space','sys');
//会员中心会员分享的歌曲
spacelink('dance','dance');
//会员中心会员收藏的歌曲
spacelink('fav','dance');
spacelink('fav/index/1','dance');
图片链接解析:piclink($Table,$Url,$dx)
该函数用于解析会员主页相关链接地址
| 参数 | 属性值 | 备注 |
|---|---|---|
| $Table | 存储标识 | 会员头像:logo;音乐板块:dance;专辑:dancetopic等等… |
| $Url | 图片地址 | 地址等于空时,为系统默认图片 |
| $dx | 1或者空 | 当存储标识等于logo,$dx=1时,获取系统女性头像;可以留空 |
函数示例
//会员cscms的会员的图片,图片地址为/2017/01/01/22.jpg
piclink('logo','/2017/01/01/22.jpg');
//获取音乐专辑图片的真实地址,图片地址为/2017/01/01/abc123dd.jpg
piclink('dancetopic','/2017/01/01/abc123dd.jpg');
获取附件真实连接地址:annexlink($url)
该函数用于解析附件的真实连接地址
| 参数 | 属性值 | 备注 |
|---|---|---|
| $url | 附件地址 | 可解析网盘和FTP中的附件 |
会员中心分页解析:userpage($sqlstr,$nums,$pagesize,$pagenum,$url,$pages,$dir)
该函数用于解析会员中心分页
| 参数 | 属性值 | 备注 |
|---|---|---|
| $sqlstr | sql语句 | 获取数据的mysql语句 |
| $nums | 数据总数量 | 数据条数统计值 |
| $pagesize | 每页数据条数 | |
| $url | 页数跳转的链接地址 | 链接与页数是拼接起来的,如第一页:$url.’1′ |
| $pages | 当前页数 | 该页有class=”on”,可用来调整样式 |
| $dir | 板块名称 | 如:音乐板块dance |
会员主页分页解析:homepage($sqlstr,$nums,$pagesize,$pagenum,$op,$uid,$user,$id,$pages)
该函数用于解析会员主页分页
| 参数 | 属性值 | 备注 |
|---|---|---|
| $sqlstr | sql语句 | 获取数据的mysql语句 |
| $nums | 数据总数量 | 数据条数统计值 |
| $pagesize | 每页数据条数 | |
| $op | 板块名称 | 板块名称:如index:会员主页的首页;dance:音乐板块,vod:视频板块 |
| $uid | 会员id | 纯数字,不要留空 |
| $user | 会员名称 | 不能留空 |
| $id | 板块分类id | 板块下某分类的id,如dance分类流行歌曲的id,可以留空,留空代表所以分类 |
| $pages | 分页数 | 可以留空,留空代表第一页 |
后台分页解析:admin_page($url,$page,$pages)
该函数用于解析后台数据列表的分页
| 参数 | 属性值 | 备注 |
|---|---|---|
| $url | 链接地址 | 分页实际地址为:$url拼接页数,如:$url.$i;$i为页数 |
| $page | 当前数据的页码 | |
| $pages | 数据的总页数 |
-
数据库表结构(不包含板块)
会员相关数据表
-
本篇主要介绍cscms多元化内容管理系统中与会员相关的数据表。其中包括 管理员表、 管理员角色表、 管理员登录表、 会员表、 会员登录表、 会员组表、 会员等级表、 会员OAuth2授权表
管理员相关
管理员表:admin;记录后台管理员信息
字段名 字段类型 说明 id smallint(5) 数据ID,自增 adminname varchar(64) 管理员账号 adminpass varchar(64) 管理员密码 admincode varchar(6) 管理员密钥 logip varchar(128) 最后登录IP lognums int(10) 登录次数;默认值:0 logtime int(10) 最后登录时间;时间戳,默认值:0 card varchar(255) 口令卡 sid smallint(3) 角色id;默认值:0 管理员角色表:adminzu;记录不同的管理员权限分组
字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(64) 角色名称 sys text 默认权限 app text 板块权限 管理员登录表:admin_log;记录会员登录日志
字段名 字段类型 说明 id int(10) 数据ID;自增 uid smallint(5) 管理员id loginip varchar(50) 登录IP logintime int(10) 登录时间;时间戳,默认:0 useragent varchar(255) 客户端信息 会员表:user;记录站点注册会员信息
字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(20) 用户账号 uid bigint(20) UCID;默认值:0 tid tinyint(1) 是否推荐;0:不推荐;1:推荐;默认值:0 sid tinyint(1) 是否锁定;0:不锁定;1:锁定;默认值:0 yid tinyint(1) 是否激活;0:未激活;1:已激活;默认值:0 zid int(6) 会员组ID rzid tinyint(1) 是否认证;0:未认证;1:已认证;默认值:0 pass varchar(32) 用户密码 code varchar(6) 用户密钥 logip varchar(20) 登录IP lognum smallint(5) 登录次数 logtime int(10) 登录时间;时间戳 addtime int(10) 注册时间;时间戳 zutime int(10) 会员组到期时间;时间戳 qq varchar(50) 会员QQ tel varchar(15) 会员电话 sex tinyint(1) 性别;0:男;1:女;2:保密;默认值:0 city varchar(30) 会员所在地区 email varchar(50) 会员邮箱 logo varchar(255) 会员头像 nichen varchar(50) 昵称 cion int(10) 金币,默认值:0 rmb decimal(10,2) 金钱,默认值:0 vip tinyint(1) 是否VIP;0:不是;1:是;默认值:0 viptime int(10) vip会员到期时间;时间戳 qianm varchar(255) 个性签名 zx tinyint(1) 在线状态;0:离线;1:在线;默认值:0 logms int(10) 最后操作时间 qdts smallint(5) 签到天数 qdtime int(10) 签到时间;时间戳 level int(6) 会员等级 jinyan int(10) 会员经验 hits int(10) 空间人气 yhits int(10) 空间月人气 zhits int(10) 空间周人气 rhits int(10) 空间日人气 zanhits int(10) 被赞人气 addhits int(10) 发表数据次数 regip varchar(20) 注册IP skins varchar(128) 模板路径 bgpic varchar(255) 主页背景/td> 会员登录表:user_log;记录会员登录日志信息
字段名 字段类型 说明 id int(10) 数据id,自增 uid int(10) 会员ID loginip varchar(50) 登录IP logintime int(10) 登录时间 useragent varchar(255) 客户端信息 会员组表:userzu
字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(100) 名称 xid smallint(5) 排序ID color varchar(10) 名称颜色 pic varchar(255) 组图标 info varchar(255) 会员组介绍 cion_y int(10) 包年金币 cion_m int(10) 包月金币 cion_d int(10) 包天金币 fid tinyint(1) 上传附件权限;0:无权限;1:有权限;默认值:0 aid tinyint(1) 发表数据权限;0:无权限;1:有权限;默认值:0 sid tinyint(1) 发表数据审核;0:需要审核;1:不需审核;默认值:0 vid tinyint(1) 自助升级权限;0:无权限;1:有权限;默认值:0 mid tinyint(1) 发送私信权限;0:无权限;1:有权限;默认值:0 did tinyint(1) 下载免费权限;0:无权限;1:有权限;默认值:0 会员等级表:userlevel;记录会员等级信息
字段名 字段类型 说明 id smallint(5) 数据id,自增 xid smallint(5) 排序ID name varchar(100) 等级名称 stars smallint(3) 星星数量 jinyan int(10) 所需经验 会员OAuth2授权表:useroauth
字段名 字段类型 说明 id int(10) 数据id,自增 cid tinyint(2) 类型ID;1:QQ;2:微博;3:百度;4:人人;5:开心;6:豆瓣 uid int(10) 会员ID csid int(10) cscms官方返回ID nickname varchar(255) 授权返回昵称 avatar varchar(255) 授权返回头像地址 oid varchar(255) 授权返回ID access_token varchar(255) 授权token refresh_token varchar(255) 授权刷新token expire_at int(10) 授权到期时间 会员社交相关数据表
-
本篇主要介绍cscms多元化内容管理系统中与会员社交相关的数据表,主要是会员的一下操作记录。其中包括 会员消息表、 留言表、 评论表、 粉丝表、 好友表、 访客表、 会员动态表、 会员说说表
会员消息表:msg;记录会员收到的站内信
字段名 字段类型 说明 id int(10) 数据ID,自增 did tinyint(1) 是否已读;0:未读;1:已读;默认值:0 name varchar(255) 标题 neir text 内容 uida int(10) 接收者会员ID uidb int(10) 发送者会员ID addtime int(10) 发送时间;时间戳 留言表:gbook;记录网站留言信息
字段名 字段类型 说明 id int(10) 数据id,自增 cid tinyint(1) 类型ID;0:网站留言;1:留言回复;默认值:0 fid int(10) 上级ID uida int(10) 会员ID uidb int(10) 留言者ID neir text 内容 ip varchar(20) 留言IP addtime int(10) 留言时间;时间戳 评论表:pl;用户评论记录
字段名 字段类型 说明 id int(10) 数据id,自增 user varchar(64) 会员名称 uid int(10) 会员ID content text 评论内容 ip varchar(18) 评论IP did int(10) 数据ID dir varchar(64) 所属板块 cid tinyint(2) 板块分支ID fid int(10) 上级ID addtime int(10) 评论时间;时间戳 粉丝表:fans;记录会员拥有的粉丝信息
字段名 字段类型 说明 id int(10) 数据id,自增 uida int(10) 会员ID uidb int(10) 粉丝ID addtime int(10) 时间戳 好友表:friend;记录会员拥有的好友信息
字段名 字段类型 说明 id int(10) 数据id,自增 uida int(10) 会员ID uidb int(10) 好友ID addtime int(10) 时间戳 访客表:funco;记录会员空间的访客信息
字段名 字段类型 说明 id int(10) 数据id,自增 uida int(10) 会员ID uidb int(10) 访客ID addtime int(10) 时间戳 会员动态表:;记录会员动态
字段名 字段类型 说明 id int(10) 数据id,自增 uid int(10) 会员ID dir varchar(64) 版块标示 yid tinyint(1) 是否显示 title varchar(255) 类型标题 did int(10) 数据ID name varchar(255) 数据标题 link varchar(255) 数据链接 addtime int(10) 增加时间;时间戳 会员说说表:blog
字段名 字段类型 说明 id int(10) 数据id,自增 uid int(10) 会员ID hits int(10) 浏览次数 phits int(10) 评论次数 neir text 说说内容 addtime int(10) 发表时间;时间戳 会员消费收入数据表
本篇主要介绍cscms多元化内容管理系统中与会员消费记录、收入记录相关的数据表,主要是会员的一下操作记录。其中包括 消费记录表、 收入记录表、 支付记录表、 充值卡表、 模板使用记录表、 宣传记录表
消费记录表:spend
字段名 字段类型 说明 id int(10) 数据id,自增 dir varchar(64) 所属板块 title varchar(255) 消费内容 sid tinyint(1) 分类ID uid int(10) 会员ID nums int(10) 数量 ip varchar(15) IP地址 addtime int(10) 消费时间;时间戳 收入记录表:income
字段名 字段类型 说明 id int(10) 数据id,自增 dir varchar(64) 所属板块 title varchar(255) 收入内容 sid tinyint(1) 分类ID uid int(10) 会员ID nums int(10) 数量 ip varchar(15) IP地址 addtime int(10) 收入时间;时间戳 支付记录表:pay
字段名 字段类型 说明 id int(10) 数据id,自增 dingdan varchar(64) 订单号 type varchar(30) 支付方式 uid int(10) 会员ID rmb decimal(10,2) 金额 pid tinyint(1) 状态 ip varchar(15) IP addtime int(10) 下单时间;时间戳 充值卡表:paycard
字段名 字段类型 说明 id int(10) 数据id,自增 card varchar(20) 卡号 pass varchar(10) 卡密 uid int(10) 会员ID rmb decimal(10,2) 金额 usertime int(10) 使用时间 addtime int(10) 生成时间 模板使用记录表:web_pay
字段名 字段类型 说明 id int(10) 数据id,自增 mid int(10) 模板唯一ID name varchar(255) 模板标题 uid int(10) 会员ID cion int(10) 扣除金币 addtime int(10) 时间戳 字段名 字段类型 说明 id int(10) 数据id,自增 ip varchar(20) 访问IP agent varchar(255) 访问客户端 uid int(10) 会员ID cion int(10) 赠送金币 jinyan int(10) 赠送经验 addtime int(10) 访问时间;时间戳 系统工具类数据表
本篇主要介绍cscms多元化内容管理系统中一下系统工具相关的数据表。其中包括 友情链接表、 自定义JS表、 静态标签表、 自定义页面表、 板块表、 session数据表、 全站TAGS标签表、 采集规则表、 采集新增规则表、 采集数据表、 采集历史记录表
友情链接表:link
字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(64) 名称 url varchar(255) 地址 pic varchar(255) LOGO cid tinyint(1) 类型;0:文字;1:图片;默认值:1 sid tinyint(1) 主页是否显示;0:不显示;1:显示;默认值:1 xid smallint(5) 排序号 自定义JS表:ads
字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(64) 标签标示 js varchar(100) JS路径 html text 标签代码 neir varchar(200) 标签介绍 addtime int(10) 增加时间;时间戳 静态标签表:label
字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(64) 唯一标示 selflable text 标签内容 neir varchar(128) 标签介绍 addtime int(10) 时间戳 自定义页面表:page
字段名 字段类型 说明 id int(10) 数据id,自增 sid tinyint(1) 运行方式 name varchar(64) 唯一标示 neir varchar(128) 页面介绍 url varchar(100) 页面路径 html text 页面内容 addtime int(10) 时间戳 板块表:plugins
字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(100) 板块名称 author varchar(20) 作者 dir varchar(30) 目录 version varchar(10) 版本号 description varchar(200) 介绍 sid tinyint(1) 类型 ak text ak session数据表:session
字段名 字段类型 说明 sessionid varchar(40) session的ID uid int(10) 会员ID plub varchar(18) 分类ID data text session数据 ip varchar(15) IP地址 addtime int(10) 时间戳 字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(30) 名称 分类ID fid int(8) 分类ID xid int(3) 排序ID hits int(10) 人气 采集规则表:caiji
字段名 字段类型 说明 id smallint(5) 数据id,自增 name varchar(50) 规则名称 url varchar(250) 站点地址 code varchar(10) 网页编码 dir varchar(64) 所属板块 cfid tinyint(1) 重复记录操作;0:不入库;1:新增数据;2:智能覆盖;默认值:0 picid tinyint(1) 是否保存图片;0:不保存,1:保存;默认值:1 dxid tinyint(1) 是否倒序采集;0:不倒序;1:倒序 rkid tinyint(1) 入库方式;0:入临时库;1:入主数据库;默认值:0 htmlid tinyint(1) 是否查看源码;0:不查看;1:查看;默认值:0 cjurl text 采集目标地址 ksid int(10) 开始页码 jsid int(10) 结束页码 listks text 列表开始标记 listjs text 列表结束标记 picmode tinyint(1) 图片模式设置;0:不做设置;1:列表页获取;2:正文获取 picks text 图片开始标记 picjs text 图片结束标记 linkks text 链接开始标记 linkjs text 链接结束标记 strth text 字符替换规则 addtime int(10) 时间戳 采集新增规则表:cjannex
字段名 字段类型 说明 id int(10) 数据id,自增 name varchar(128) 字段名称 cid int(10) 规则表id fid tinyint(1) 采集类型:0:手动输入;1:目标采集;默认值:0 htmlid tinyint(1) 是否清除html;0:不清除;1:清除 zd varchar(128) 入库表字段 ks text 开始标记 js text 结束标记 fname varchar(64) 输入内容 采集数据表:cjdata
字段名 字段类型 说明 id int(10) 数据id,自增 dir varchar(64) 所属板块 pic varchar(255) 数据图片 zid tinyint(1) 是否入库;0:未入库;1:已入库 zdy text 采集信息 addtime int(10) 采集时间;时间戳 采集历史记录表:cjlist
字段名 字段类型 说明 id int(10) 数据id,自增 dir varchar(64) 板块名称 url 数据连接地址 varchar(255) names varchar(255) 规则名称 zid tinyint(1) 数据状态









暂无评论内容