07 CmsTop模板手册.doc

CmsTop打造媒体与资讯领域建站航母CmsTop模板制作帮助手册一 模板制作需要具备的基本条件1、具备基本的html代码知识；2、懂得简单的逻辑判断和循环知识；3、最好也能懂点SQL语句知识；4、能够熟练操作CmsTop系统；二 名词定义1、模板：控制前台页面显示的html文件；2、标签：用于调用数据库数据的特殊标记代码；3、区块：组成前台页面的基本元素，通常通过SSI方式引入模板；4、剪辑：模板制作过程中暂时保存的通用代码片断，主要为了方便代码片断重复使用；三 模板目录结构CmsTop模板文件目录为 ./templates，目录结构如下：./templates |-default | | | |-index.Html（网站首页模板） | | | |-system（系统公用模板目录） | | |-header.html（shtml文件的头部模板） | | |-header_php.html（动态程序头部模板） | | |-footer.html（底部模板） | | |-category.Html（大栏目页模板） | | |-list.html（列表页模板） | | |-map.html（网站地图模板） | | |-rank.html（排行榜首页模板） | | |-rank_list.html（频道排行榜模板） | | |-roll.html（滚动更新模板） | | |-tags.html（热门标签页模板） | | |-showmessage.html（前台提示信息模板） | |-article（文章模板） | | |-list.html（文章列表页模板） | | |-show.html（文章内容页模板） | | |-comment.html（文章内容页评论模板）四 模板常量常量代码说明ADMIN_URL后台地址APP_URL 动态地址IMG_URL 公共图片、JS、CSS地址UPLOAD_URL 附件地址WWW_URLhtml地址五 模板变量5.1 全局变量变量代码说明$_userid 用户ID$_username用户名$_groupid用户组ID$_roleid角色ID$CONFIGcharset字符集$SETTINGsitename网站名称5.2 栏目页、列表页变量变量代码说明$catid 栏目ID$name栏目名称$url栏目URL$alias栏目英文名$parentid父栏目ID$parentids所有父栏目ID集合，多个逗号分隔$childids所有子栏目ID集合，多个逗号分隔$posts栏目内容数$pv栏目点击数$comments栏目评论数$total栏目内容总数，用于列表页分页$page当前页码，用于列表页分页$pagesize每页内容数，用于列表页分页，在后台“设置=全局设置=性能优化=列表页每页信息数”处进行设置$urlrule栏目URL规则，用于列表页分页，在后台“栏目设置=修改=列表页URL规则”处进行设置5.3 内容页变量变量代码说明$contentid 内容ID$catid内容栏目ID$modelid内容模型ID$title标题$color颜色$thumb缩略图地址$tags关键词$source_name来源名称$source_url来源URL$sourceid来源IDdate(Y-m-d H:i, $published)发布时间$createdby创建人IDusername($createdby)创建人用户名$allowcomment评论开关，1=允许评论，0=禁止评论$subtitle副标题，仅限于文章内容页$author_name作者名，仅限于文章内容页$author_url作者URL，仅限于文章内容页$authorid作者ID，仅限于文章内容页$editor责任编辑，仅限于文章内容页$description摘要，仅限于文章内容页$content正文，仅限于文章内容页$pagecount分页数，仅限于文章内容页$words_count字数，仅限于文章内容页5.4 手动区块模板变量模板代码示例： loop $data $r loop $r $c$ctitle/loop /loop 变量代码说明$ctitle标题$ccolor颜色$curlURL$csubtitle副标题$csuburl副标题URL$cthumb缩略图地址$cdescription介绍date(Y-m-d H:i, $ctime)时间六 模板语法1、 变量示例：$_username，显示用户名2、 常量示例：IMG_URL，显示公共js、css和图片地址3、 函数示例：str_cut($title，50)， url( system/seccode/image)函数对照表：函数调用代码示例说明str_cut($title，50,.)截断字符串参数1：被截字符串参数2：截断后字节数参数3：被截断后追加的字符串（可选）date(Y-m-d H:i,$published)日期格式化显示参数1：日期格式参数2：unix时间戳thumb($rthumb,90,90)自动缩略图参数1：图片地址参数2：缩略图宽度参数3：缩略图高度url( space/index/index,name=cmstop)构造前台动态URL地址，可根据URL路由设置产生相应格式的URL参数1：app/controller/action参数2：url参数（可选）article(1)-description显示article表的主键值为1的description字段内容，可以类似这样调用任意数据表的字段table(category, 1, name)显示栏目ID为1的栏目名称获取栏目ID为1的栏目信息，一维数组获取所有栏目信息，二维数组config(config,charset)调用./config/config.Php配置文件中的charsetsetting(comment,islogin)调用comment应用的islogin设置pages($total,$page,20,2,/2010/0317/943$page.shtml)分页函数modelid(article)得到article的modelidusername($userid)根据用户ID得到用户名userid($username)根据用户名得到用户IDloop channel() $cid $c$cname/loop循环输出顶级栏目信息loop subcategory($catid) $cid $c$cname/loop循环输出$catid的子栏目信息loop subdepartment(1) $did $d$ddepartmentid,$dname/loop循环输出部门ID为1的子部门信息4、 逻辑判断示例：if $c = 1 显示A elseif $c = 2 显示B else 显示C /if5、 循环示例：loop $array $k $v 键:$k 值:$v /loop 6、 模板嵌套template header.html七 模板标签7.1 Content标签作用：调用CmsTop系统中各种内容模型数据；示例：content catid=4 modelid=1 orderby=published desc, pv desc page=$page size=8 $rtitle date(Y-m-d,$rpublished)/contentpages($total, $page, $pagesize, 2, $urlrule) 参数对照表：参数详解modelid内容模型ID，多个ID用“,”隔开catid栏目ID，多个ID用“,”隔开 ，可自动取子栏目内容sourceid来源ID，多个ID用“,”隔开weight权重范围weight=60，表示权重值等于60weight=60,，表示权重值大于等于60weight=,60，表示权重值小于等于60weight=60,100，表示权重值大于等于60，且小于等于100published发布时间范围published=2009-11-10 表示调用发布时间为2009年 11月10日的内容published=2009-11-10, 表示调用发布时间大于2009年11月 10日的内容published=,2009-11-10 表示调用发布时间小于2009年11月10日 的内容published=2009-11-10,2009-11-30 表示调用发布时间大于2009年11 月10日，且小于2009年11月30日的内容published=1 表示调用发布时间1天以内的内容createdby创建人 ID，多个 ID 用“,”隔开tags关键词,多个关键词用“,”隔开，例如:tags=福布斯,权力orderby排序方式，多个“,”隔开,例如：orderby=published desc, pv desc, comments desc, weight descoffset数据库查询结果偏移值(必须是正整数),默认值为 0size行数(必须是正整数)page当前页码(必须是正整数)return返回值变量 return：返回结果变量名，默认为 r7.2 Db标签作用：通用的数据库数据调用方法，通常用于调用cmstop_content表以外的数据表的数据；示例：db sql=select * from #table_content where catid=$catid and modelid=1 and status=6 order by published desc size=$pagesize page=$page $rtitle date(n月j日H:i,$rpublished)/dbpages($total, $page, $pagesize, 2, $urlrule) 参数对照表：参数名必选说明dsn否数据源名，当需要调用的数据库帐号和当前系统不同时使用，并且需要事先在后台添加好数据源dbname否数据库名，当需要调用的数据库帐号和当前系统相同而数据库名不同时使用charset否数据字符集，当需要调用的数据和当前系统字符集不同时设置，数据输出的时候系统会根据此设置自动转码sql是要查询的sql语句，数据表的前缀可以用 #table_ 代替page否当前的页码，一般用法都是 page=$pagesize否行数(必须是正整数)return否返回值变量 return:返回结果变量名，默认为 r7.3 Discuz标签作用：调用同一服务器上的discuz论坛帖子数据示例：discuz dsn=discuz fid=1 filter=all published=1 keywords=cmstop author=1 special=1,2 prefix=cdb_ orderby=dateline desc size=$pagesize page=$page!-更多可使用字段，请参考discuz数据表posts、threads-$rsubject date(n月j日H:i,$rdateline)/discuzpages($total, $page, $pagesize, 2, $urlrule)参数对照表：参数名必选说明dsn是数据源名，当需要调用的数据库帐号和当前系统不同时使用，并且需要事先在后台添加好数据源fid否论坛版块ID，多个以半角逗号分隔filter否主题类型，全部主题(all) 、精华主题(digest)、 置顶主题(top)published否时间范围，数字n表示n天之内的帖子keywords否关键字，关键词写法参考discuz搜索,以（AND、&、空格） （OR、|）组合查询，*模糊匹配author否作者ID或者作者名称，多个以逗号分隔special否特殊主题：投票主题(1)、商品主题(2)、悬赏主题(3)、活动主题(4)、辩论主题(5)、多个以逗号分隔orderby否排序类型:lastpost (asc|desc) 最后回复 dateline (asc|desc) 发表时间 replies (asc|desc) 回复数 views (asc|desc) 查看数prefix否默认cdb_ discuz数据表前缀其它字段否page,offset,size,charset参考db标签7.4 Section标签作用：定义页面区块属性，通常用于通过页面模板自动创建页面区块；示例： 模板代码当type为html的时候只能为html，其他可以是html跟模板标签组合的代码区块类型对照表：类型说明代码支持html和js代码，通常用于不规则数据和广告位维护等自动支持通过模板标签调用数据，可以定时刷新，无需人工维护手动支持手动更新数据，并通过设定的模板代码输出rss获取指定的rss新闻源，并通过设定的模板代码输出，可定时刷新，通常用于RSS数据远程调用json获取指定的json数据源，并通过设定的模板代码输出，可定时刷新，通常用于JSON数据远程调用rpc获取指定的rpc接口数据，并通过设定的模板代码输出，可定时刷新，通常用于RPC协议接口参数对照表：参数名必选说明sectionid否区块ID，如果没填写就会自动创建此碎片name是区块名称，可以重复type是区块类型，（html,auto,hand,rss,json,rpc）其中之一。url是当type为（rss,json,rpc）时有效method是当type为rpc时有效args否当type为rpc时有效width否区块宽度，主要用来参考标题长度是否合适frequency否更新频率，当type为