杰奇模板详解.doc

最近在做小说模板，大家都应该知道做小说网站大部分都是用杰奇和奇文，本人感觉杰奇很不错，于是就学习写模板，下面是一些写杰奇模板必备的一些，大家掌握了这个，自己写模板就不成问题了，有什么不会的可以联系我QQ28184063 说下我的网站书屋吧 /modules/article/templates / 文章系统模板modules/article/templates/blocks / 文章系统区块模板modules/forum/templates / 论坛系统模板modules/forum/templates/blocks / 论坛系统区块模板templates / 公用页面模板(例如用户档案)templates/blocks / 公用页面区块模板themes/default / 主要风格模板modules/article/templates/index.html / 目录页面modules/article/templates/style.html / 章节内容modules/article/templates/fulltext.html / 全文阅读modules/article/templates/articleinfo.html / 书籍摘要页面themes/default/theme.html / 动态页面公用模板模板标签下面对 theme.html 模板中使用到的标签做简单的说明：在模板文件的html源代码中插入如下标签，即可在页面中显示出来相应内容。说明：V1.30以下版本，标签格式为，V1.30以上版本标签的格式为?XXX?，注意使用。 / 网页标题 / 网页字符集，对应后台系统定义中的“默认语言” / 网页关键字，对应后台系统定义中的“网站关键字” / 网站描述，对应后台系统定义中的“网站描述” / 作者 / 版权申明，对应后台系统定义中的“版权申明” / 系统CSS引用，由系统自动生成 / 头部插入代码，对应后台系统定义中的“头部插入代码” / 顶部通栏代码，对应后台系统定义中的“顶部通栏代码” / 注册用户登入详细资料 / GB2313编码的链接 / BIG5编码的链接 / JIEQI CMS图片文件夹路径 / JIEQI CMS首页链接,对应后台系统定义中的“网站地址” / BANNER代码，对应后台系统定义中的“BANNER代码” / 联系Email，对应后台系统定义中的“联系Email” / 系统菜单，如果后台系统定义中“是否使用系统菜单”一项为是，则使用由 configs/mainmenu.php 定义的菜单项目 / 网站名称，对应后台系统定义中的“网站名称” / 底部通栏代码，对应后台系统定义中的“底部部通栏代码” / 顶部区块标题 / 顶部区块内容 / 左边区块标题 / 左边区块内容 / 中上区块标题 / 中上区块内容 / 中左区块标题 / 中左区块内容 / 中右区块标题 / 中右区块内容 / 中中区块标题 / 中中区块内容 / 中下区块标题 / 中下区块内容 / 右边区块标题 / 右边区块内容 / 底部区块标题 / 底部区块内容为使更改后的模板生效，我们需要对相应的区块经行刷新 或者清理区块缓存。 modules/article/templates /文章系统模板 modules/article/te模板制作方法模板文件路径JIEQI CMS 模板文件主要存在于以下几个目录中，更改相应的文件就能改变页面显示效果。注：为使更改后的模板生效，我们需要对相应的区块经行刷新 或者清理区块缓存。modules/article/templates /文章系统模板modules/article/templates/blocks /文章系统区块模板modules/forum/templates /论坛系统模板modules/forum/templates/blocks /论坛系统区块模板templates /公用页面模板(例如用户档案)templates/blocks /公用页面区块模板themes/default /主要风格模板主要模板：一般修改如下几个主要模板就能改变前台页面的大部分显示效果： modules/article/templates/index.html / 目录页面 modules/article/templates/style.html / 章节内容 modules/article/templates/fulltext.html/ 全文阅读 modules/article/templates/articleinfo.html / 书籍摘要页面 themes/default/theme.html / 动态页面公用模板常用语法以及函数讲解模板中标签的格式为?XXX?，注意使用。1、循环语句：格式：?section name=i loop=$var columns=1?/section?说明：该语句以?section name=i loop=$var columns=1?开始，并以?/section?结束举例：?section name=i loop=$jieqi_cmblocks?/section?解释：上例中表示的是，如果中间下方的区块存在，则在此处循环显示2、判断语句格式：?if . ?.? else ?.?elseif?.?/if?说明：该语句为判断语句举例：?if $jieqi_cmblocks.title != ?/if?解释：如果中间下方的区块的标题有内容，则显示这个区块的标题3、截取字符串方法函数：1、truncate - 截取固定长度字符串，参数一(必要)：截取后长度，参数二：附加字符串。格式：eg：$var=123456789；模板里面调用函数： ?$var|truncate:5? | ?$var|truncate:5:.?输出：12345 | 123.4、替换字符串函数：str_replace - 字符串替换，参数一：查找的字符串，参数二：替换为字符串格式：eg：$var=；模板里面调用函数： ?$var|str_replace:www:demo?输出： 5、处理时间函数函数：date - 把数字类型的时间格式化成字符串，参数一：格式化字符串格式：eg：$time=1198226131；模板里面调用函数： ?$time|date:Y-m-d H:i:s?输出：2007-12-21 16:35:316、专用于生成子目录名字的函数函数：subdirectory - JIEQI CMS 里面专用于生成子目录名字的函数，针对数字的处理，无参数。输出格式类似 /12，其中/ 是表示开始一个子目录，12是子目录名字。格式：eg：$id=3456；模板里面调用函数：/files/article/html?$id|subdirectory?/$id?/index.html输出：/files/article/html/3/3456/index.html【框架】JIEQI CMS风格模板以框架的形式存在，无论是JIEQI CMS中的哪个模块，均使用到了该框架，该框架的文件夹为http:/你的网站地址/theme/风格文件夹。该文件夹中需要包含五个html文件，theme.html、msgerr.html、msgwin、jumppage.html、msgbox.html，还有一个CSS文件。theme.html：页面框架模板，适用整个系统，修改网站风格也主要是修改本文件。jumppage.html：程序跳转页面模板，比如用户登录时候，那个跳转过渡的小窗口。msgbox.html：内容提示方块模板，通常这个提示信息是指插入到其他页面的。msgwin.html：内容提示页面模板，跟msgbox.html不同，这是一个完整的提示页面。msgerr.html：错误信息提示模板，也是一个完整的提示页面。style.css：通用的css，在theme.html里面调用的，也是整站通用。二、小说连载系统JIEQI的风格模板文件的保存地址为：http:/你的网站地址/modules/article/templates和http:/你的网站地址/modules/article/templates/blocks中，前者包含JIEQI需用的不会以区块形式出现的模板，比如小说信息页面、小说章节内容页面等，后者包含杰奇需要采用区块形式出现的文件，比如首页显示的总点击榜、总推荐榜等。下面对区块文件进行一个说明：原创总排行：block_allauthorvisit.html文章总排行：block_allvisit.html总推荐榜：block_allvote.html文章总排行：block_articlelist.html原创更新：block_authorupdate.html封面推荐：block_commend.html原创日排行：block_dayauthorvisit.html文章日排行：block_dayvisit.html本日推荐：block_dayvote.html收藏排行：block_goodnum.html最近更新：block_lastupdate.html转载更新：block_masterupdate.html原创月排行：block_mouthauthorvisit.html文章月排行：block_mouthvisit.html本月推荐：block_mouthvote.html我的原创文章：block_myarticles.htmlblock_newreview.htmlblock_newreviews.html最新入库：block_postdate.html最新书评：block_reviewslist.html文章搜索：block_search.html字数排行：block_size.html分类阅读：block_sort.html排行榜：block_toplist.html本站推荐：block_toptime.html我的转载文章：block_transarticles.html原创周排行：block_weekauthorvisit.html文章周排行：block_weekvisit.html本周推荐：block_weekvote.html作家工具箱：block_writerbox.html【第二章CSS文件说明】杰奇整个框架使用的是http:/你的网站地址/theme/风格文件夹/style.css，下面就默认CSS文件中的一些样式参数进行说明，在你设计风格的时候，如果希望采用默认的一样样式，那么请将默认CSS文件中的部分复制到你建立的CSS文件中，并在html文件中按照默认CSS文件的部分内容进行书写布局。/* 基本样式 */* - 清除默认样式body- 页面主体a - 链接p - 段落h1, h2, h3, h4, h5, h6 - 标题img - 图像div - 层hr- 分割线ul- 列表li- 列表栏目=/* 表格样式 */table- 默认表格table.fix- 单元格里面内容比较宽时候隐藏超出部分，而不是把表格撑开导致变形table.grid - 多行多列的表格table.grid caption, .gridtop - 表格标题table.grid th, .head - 表格第一行项目名称栏table.grid td- 单元格样式=/*表格辅助样式*/.title- 表格内列的栏目标题.even - 偶数行/列.odd- 奇数行/列.foot- 表格末行.bottom - 表格底部/* 表单样式 */form- 默认表单input - 默认输入框.text - 单行文本.textarea - 多行文本.button - 按钮.checkbox - 多选框.radio- 单选框.select - 下拉框=/* 布局样式 */#wrapper- 总页面容器#left - 左边列#right- 右边列#centers- 中间列（一共为三列时）#centerm- 中间列（一共为二列时）#centerl- 中间列（一共为一列时）#content- 主体内容.main - 整页宽度的内容容器.m_top- 网页最顶部（通常放快速导航链接）.m_head - 网页头部（通常包括网站LOGO和BANNER）.h_logo - 网站LOGO.h_banner - 网站BANNER.h_link - BANNER旁边的链接.m_menu - 菜单栏.m_foot - 网页底部.block- 区块容器.blocktitle - 区块标题.blockcontent - 区块内容.blocknote- 区块底部修饰=/*常用样式*/.ultop- 排行列表.ulitem - 项目列表.ulrow- 普通行.ulcenter - 内容居中行.ulmul- 多行多列.fix, .lm - 内容超出容器时候隐藏超出部分.fl - 靠左浮动.fr - 靠右浮动.cl - 清除左边.cr - 清除右边.cb - 清除两边.tl - 文本居左.tc - 文本居右.tr - 文本居中.more - “更多”链接=.c_navigation - 栏目导航.c_title- 文章标题.c_head - 文章头部.c_content- 文章内容.c_foot - 文章底部.c_label- 属性标签.c_value- 属性内容.c_row- 文章列表里面的一条记录外框.c_subject- 文章列表标题.c_tag- 文章列表附加属性.c_description- 文章列表里面的简介.c_note - 文章列表里面备注或者相关链接=/*醒目效果*/.hottext- 热点文字.notetext - 注解文字.errortext- 错误提示文字a.hotlink - 热点链接a.btnlink - 按钮样式链接/*常用界面*/.jieqiQuote- 引用框.jieqiCode - 代码框.jieqiNote - 注解框.divbox- 带边框容器.textbox - 文本框.popbox- 提示框#tips- 浮动消息提示框.tablist - TAB标签.tabcontent- TAB栏目对应的内容.pages - 列表页面的分页外框.pagelink- 列表页面的分页导航img.avatar - 默认用户头像#jieqi_menu- 下拉菜单=第三章【不使用系统框架制作首页】在制作JIEQI首页之前，需要了解JIEQI CMS的一些标签的书写。尽管不使用系统框架，但这也是仅针对于站点首页而言，其它页面还是需要调用系统框架的，因此theme.html文件还是要重新设计，最好能和首页的风格相同，这样便于统一风格。一、系统标签的书写系统标签的书写方式为：? $标签名 ?，例如网站地址的标签为：? $jieqi_url ?。下面我将列举JIEQI CMS中常用的标签：jieqi_url- 本机URL的根路径（使用相对路径时候本变量是空的，用绝对路径时候是完整地址，如）jieqi_rootpath - 网站根目录的物理路径，如：E:/webjieqi_local_url- 本机完整的URL的根路径（跟jieqi_url区别是，使用相对路径时候本变量也是完整地址）jieqi_main_url - 主服务器的URL地址jieqi_user_url - 用户入口服务器的URL地址jieqi_host - 网站地址里面的主域，如 jieqi_charset- 当前页面编码，如gbk， big5jieqi_version- 系统程序主版本号，如 1.50jieqi_theme- 网站当前风格名称，如 jieqidivjieqi_themeurl - 网站当前风格的yrl，如/themes/jiqidivjieqi_time - 当前时间，int型jieqi_sitename - 网站名称jieqi_pagetitle- 网页titlejieqi_email- 网站联系Emailmeta_keywords- 网站meta关键字meta_description - 网站meta描述meta_copyright - 网站meta版权声明jieqi_banner - 网站bannerjieqi_head - 网页和之间附加代码jieqi_top_bar- 网页顶部通栏代码jieqi_bottom_bar - 网页底部通栏代码jieqi_menu - 程序生成的下拉菜单赋值成这个变量，在较老版本使用，新版里面菜单直接在theme.html里面修改jieqi_userid - 用户IDjieqi_username - 用户昵称(用户未设置昵称时候即登录账号)jieqi_useruname- 用户名（登录账号）jieqi_group- 用户组别数字jieqi_groupname- 用户组别名称jieqi_score- 用户积分jieqi_experience - 用户经验jieqi_honor- 用户头衔jieqi_vip- 用户vip标志 0-非vip，1-vip会员jieqi_egold- 用户虚拟币金额jieqi_avatar - 用户头像图片类型标志 0-无头像图 1-gif， 2-jpg， 3-jpeg， 4-png， 5-bmpjieqi_newmessage - 新的站内短信标志，0-无新消息 1-有新消息jieqi_userstatus - 用户状态 1-未登陆 2-管理员 3-登录用户二、首页文件的书写JIEQI CMS是经过Zend加密的