cmstop模板制作帮助手册

cmstopcmstop模板制作帮助手册模板制作帮助手册 1 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 频道排行榜模板 2 roll html 滚动更新模板 tags html 热门标签页模板 showmessage html 前台提示信息模板 article 文章模板 list html 文章列表页模板 show html 文章内容页模板 ment html 文章内容页评论模板 四 模板常量常量代码说明 ADMIN URL 后台地址 APP URL 动态地 址 IMG URL 公共图片 JS CSS地址 UPLOAD URL 附件地址 URL h tml地址 五 模板变量 1 全局变量变量代码说明 userid 用户ID username 用户名 groupid 用户组ID roleid 角色ID CONFIG charset 字符集 SETTING sitename 网站名称 2 栏目页 列表页变量变量代码说明 catid 栏目ID name 栏目 名称 3 变量代码说明 url 栏目URL alias 栏目英文名 parentid 父栏 目ID parentids 所有父栏目ID集合 多个逗号分隔 childids 所 有子栏目ID集合 多个逗号分隔 posts 栏目内容数 pv 栏目点击 数 ments 栏目评论数 total 栏目内容总数 用于列表页分页 p age 当前页码 用于列表页分页 pagesize 每页内容数 用于列表 页分页 在后台 设置 全局设置 性能优化 列表页每页信息 数 处进行设置 urlrule 栏目URL规则 用于列表页分页 在后台 栏目设置 修改 列表页URL规则 处进行设置 3 内容页变量变量代码说明 contentid 内容ID catid 内容栏目 ID modelid 内容模型ID title 标题 color 颜色 thumb 缩略 图地址 tags 关键词 source name 名称 source url URL 4 变量代码说明 sourceid ID date Y m d H i published 发布时间 createdby 创建人ID username cre atedby 创建人用户名 allowment 评论开关 1 允许评论 0 禁 止评论 subtitle 副标题 author name 作者名 author url 作 者URL authorid 作者ID editor description 摘要 content 正文 pagecount 分页数 words count 字数 4 手动区块模板变量模板代码示例 六 模板语法1 变量示例 username 显示用户名2 常量示例 IM G URL 显示公共js css和图片地址3 函数示例 str cut title 50 url system seode image 函数对照表函数调用代码示 例说明 str cut title 50 截断字符串参数1被截字符串 参数2截断后字节数参数3被截断后追加的字符串 可选 date Y m d H i published 日期格式化显示参数1日期格式参数2unix时间戳 thumb r thumb 90 90 自动缩略图参数1图片地址参数2缩略图 宽度参数3缩略图高度 url space index index name cmstop 构造前台动态URL地址 可根据URL路由设置产生相应格式的URL参数 1app controller action参数2url参数 可选 6 函数调用代码示例说明 article 1 description 显示article表的主键值为1的description字段内容 可以类似这样调用任意数据表的字段 config config charset 调用 config config Php配置文件中的charset setting ment islogin 调用ment应用的islogin设置 pages total page 2 0 2 news cmstop xx 0317 943 page shtml 分页函数 model id article 得到article的modelid username userid 根据用 户ID得到用户名 userid username 根据用户名得到用户ID loop channel cid c c name loop 循环输出顶级栏目信息 loop subcategory catid cid c c name loop 循环输出 catid的 子栏目信息 loop subdepartment 1 did d d departmentid d name loop 循环输出部门I D为1的子部门信息4 逻辑判断示例 if c 1 显示A elseif c 2 显 示B else 显示5 循环C if 示例 loop array k v 键 k 值 6 模 板嵌套 v loop 7 template header html 七 模板标签1 Content标签作用调用CmsTop系统中各种内容模型数 据 示例 content catid 4 modelid 1 orderby published desc pv desc page page size 8 r title date Y m d r published content pages total page 1 参数对照 表参数详解modelid内容模型ID 多个ID用 隔开catid栏目ID 多个ID用 隔开sourceidID 多个ID用 隔开weight权重范 围weight 60 表示权重值等于60weight 60 表示权重值大于 等于60weight 60 表示权重值小于等于60weight 60 100 表 示权重值大于等于60 且小于等于100published发布时间范围publi shed xx 11 10 表示调用发布时间为xx年11月10日的内容published xx 11 10 表示调用发布时间大于xx年11月10日的内容published xx 11 10 表示调用发布时间小于xx年11月10日的内容published xx 11 10 xx 11 30 表示调用发布时间大于xx年11月10日 且小于xx年11月30日的内 容published 1 表示调用发布时间1天以内的内容createdby创建人 ID 多个ID用 隔开tags关键词 多个关键词用 隔开 例如 tags 福布斯 权力 8 参数详解orderby排序方式 多个 隔开 例如orderby publish ed desc pv desc ments desc weight desc offset数据库查询结果偏移值 必须是正整数 默认值为0size 行数 必须是正整数 page当前页码 必须是正整数 return返回值变 量return返回结果变量名 默认为r2 Db标签作用通用的数据库数据 调用方法 通常用于调用cmstop content表以外的数据表的数据 示例 db sql select from table content wherecatid catid andmodelid 1and status 6order bypublished desc size pagesize page page r title date n月j日H i r published db pages total page pagesize 2 urlrule 参数对照表参数名必选说明dsn否数据源名 当需要调用 的数据库帐号和当前系统不同时使用 并且需要事先在后台添加好 数据源dbname否数据库名 当需要调用的数据库帐号和当前系统相 同而数据库名不同时使用charset否数据字符集 当需要调用的数据 和当前系统字符集不同时设置 数据输出的时候系统会根据此设置 自动转码sql是要查询的sql语句 数据表的前缀可以用 table 代替 page否当前的页码 一般用法都是page page size否行数 必须是 正整数 9 参数名必选说明return否返回值变量return 返回结果变量名 默认 为r3 Discuz标签作用调用同一服务器上的discuz论坛帖子数据示例 discuz dsn discuz fid 1 filter all published 1 keywords cmsto p author 1 special 1 2 prefix cdb orderby dateline desc size pagesize page page r subject date n月j 日H i r dateline discuz pages total page pagesi ze 2 urlrule 参数对照表参数名必选说明dsn是数据源名 当需 要调用的数据库帐号和当前系统不同时使用 并且需要事先在后台 添加好数据源fid否论坛版块ID 多个以半角逗号分隔filter否主题 类型 全部主题 all 精华主题 digest 置顶主题 top publish ed否时间范围 数字n表示n天之内的帖子keywords否关键字 关键 词写法参考discuz搜索 以 AND 空格 OR 组合查询 模糊匹配author否作者ID或者作者名称 多个以逗号分隔special否 特殊主题投票主题 1 商品主题 2 悬赏主题 3 活动主题 4 辩论主题 5 多个以逗号分隔 10 参数名必选说明orderby否排序类型 lastpost asc desc 最后回复d ateline asc desc 发表时间replies asc desc 回复数views asc d esc 查看数prefix否默认 cdb discuz数据表前缀其它字段否pag e offset size charset参考db标签4 Section标签作用定义页面区 块属性 通常用于通过页面模板自动创建页面区块 示例模板代码 当type为html的时候只能为html 其他可以是html跟模板标签组合 的代码区块类型对照表类型说明代码支持html和js代码 通常用于 不规则数据和广告位维护等自动支持通过模板标签调用数据 可以 定时刷新 无需人工维护手动支持手动更新数据 并通过设定的模 板代码输出rss获取指定的rss新闻源 并通过设定的模板代码输出 可定时刷新 通常用于RSS数据远程调用json获取指定的json数据 源 并通过设定的模板代码输出 可定时刷新 通常用于JSON数据 远程调用rpc获取指定的rpc接口数据 并通过设定的模板代码输出 可定时刷新 通常用于RPC协议接口参数对照表参数名必选说明se ctionid否区块ID 如果没填写就会自动创建此碎片 11 参数名必选说明name是区块名称 可以重复type是区块类型 htm l auto hand rss json rpc 其中之一 url是当type为 rss json rpc 时有效method是当type为rpc时有 效args否当type为rpc时有效width否区块宽度 主要用来参考标题 长度是否合适frequency否更新频率 当type为html和hand时此选项 无效rows否