JIEQI CMS 模板文件主要存在于以下几个目录中,更改相应的文件就能改变页面显示效果。注:为使更改后的模板生效,请参阅陈佳裕博客/wp-admin/#sxym">刷新页面。
- 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 // 动态页面公用模板
themesdefault 文件夹下的 theme.html 是所有动态页面公用的模板文件,下面针对这个模板文件进行详细的介绍。模板文件中的模板变量(模板标签)类似这样 <{变量名}> ,在生成页面时,系统会自动替换模板文件中的模板变量为相应的值。 模板标签
- 下面对 theme.html 模板中使用到的标签做简单的说明:在模板文件的html源代码中插入如下标签,即可在页面中显示出来相应内容。说明:V1.30以下版本,标签格式为<{XXX}>,V1.30以上版本标签的格式为{?XXX?},注意使用。
<{$jieqi_pagetitle}> // 网页标题<{$jieqi_charset}> // 网页字符集,对应后台系统定义中的“默认语言”<{$meta_keywords}> // 网页关键字,对应后台系统定义中的“网站关键字”<{$meta_description}> // 网站描述,对应后台系统定义中的“网站描述”<{$meta_author}> // 作者<{$meta_copyright}> // 版权申明,对应后台系统定义中的“版权申明”<{$jieqi_css}> // 系统CSS引用,由系统自动生成<{$jieqi_head}> // 头部插入代码,对应后台系统定义中的“头部插入代码”<{$jieqi_top_bar}> // 顶部通栏代码,对应后台系统定义中的“顶部通栏代码”<{$jieqi_logininfo}> // 注册用户登入详细资料<{$url_gb2312}> // GB2313编码的链接<{$url_big5}> // BIG5编码的链接<{$jieqi_imageurl}> // JIEQI CMS图片文件夹路径<{$jieqi_url}> // JIEQI CMS首页链接,对应后台系统定义中的“网站地址”<{$jieqi_banner}> // BANNER代码,对应后台系统定义中的“BANNER代码”<{$jieqi_email}> // 联系Email,对应后台系统定义中的“联系Email”<{$jieqi_menu}> // 系统菜单,如果后台系统定义中“是否使用系统菜单”一项为是,则使用由 configs/mainmenu.php 定义的菜单项目<{$jieqi_sitename}> // 网站名称,对应后台系统定义中的“网站名称”<{$jieqi_bottom_bar}> // 底部通栏代码,对应后台系统定义中的“底部部通栏代码”<{$jieqi_tblocks[i].title}> // 顶部区块标题<{$jieqi_tblocks[i].content}> // 顶部区块内容<{$jieqi_lblocks[i].title}> // 左边区块标题<{$jieqi_lblocks[i].content}> // 左边区块内容<{$jieqi_ctblocks[i].title}> // 中上区块标题<{$jieqi_ctblocks[i].content}> // 中上区块内容<{$jieqi_clblocks[i].title}> // 中左区块标题<{$jieqi_clblocks[i].content}> // 中左区块内容<{$jieqi_crblocks[i].title}> // 中右区块标题<{$jieqi_crblocks[i].content}> // 中右区块内容<{$jieqi_cmblocks[i].title}> // 中中区块标题<{$jieqi_cmblocks[i].content}> // 中中区块内容<{$jieqi_cbblocks[i].title}> // 中下区块标题<{$jieqi_cbblocks[i].content}> // 中下区块内容<{$jieqi_rblocks[i].title}> // 右边区块标题<{$jieqi_rblocks[i].content}> // 右边区块内容<{$jieqi_bblocks[i].title}> // 底部区块标题<{$jieqi_bblocks[i].content}> // 底部区块内容 |
模板语法
- 系统可根据模板中的简单语法来判断生成什么样的页面,主要语法(V1.30以上版本请将形如<{XXX}>标签换成{?XXX?}格式)有:判断
<{if aaa}>(A)<{else}>(B)<{/if}>如果 aaa 值为 true 则显示 (A) 中的内容,否则显示 (B)的内容。例如:引号内代码段"<{if $jieqi_showbblock == 1}> <table>...</table><{else}><div>...</div><{/if}>"表示如果变量$jieqi_showbblock的值为1则显示表格内容,否则显示层内容。 |
块操作
<{section name=i loop=xxx}> <{/section}>将 xxx 变量拆分为数组,并以i为下标进行循环操作例如:引号内代码段"<{section name=i loop=$jieqi_tblocks}><{$jieqi_tblocks[i].content}><{/section}>" 表示依次显示数组$jieqi_tblocks里的内容$jieqi_tblocks[0].content、$jieqi_tblocks[1].content、$jieqi_tblocks[2].content……直到全部显示。 |
字符串截取
<{$varname|truncate:20:..}>$varname为需要截取的变量| 表示开始函数truncate 是函数名,截取字符串的20 是截取长度.. 是截取后加的附加字符串,这个参数可以不要例如:<{$jieqi_pagetitle}> 标签表示“网页标题”,长度是无限制的,是多少字符就显示多少字符。 <{$jieqi_pagetitle|truncate:10}> 表示“网页标题”在的页面实际显示的字符控制为最多5个汉字。 |
首页《最近更新》列表美化
- 编辑文件: /modules/article/templates/blocks/block_lastupdate.html默认模板
<table width="100%" border="0" cellspacing="0" cellpadding="2"><{section name=i loop=$newrows}><tr><td width="75%">[<{$newrows1[i].type}>] 《<a href="<{$newrows[i].articleurl}>" target="_blank"><{$newrows[i].article}></a>》 <a href="<{$newrows[i].chapterurl}>" target="_blank"><{$newrows[i].chapter}></a></td><td width="25%" align="right"><{if $newrows[i].authorurl=="#" || $newrows[i].authorurl==""}><{$newrows[i].author}><{else}><a href="<{$newrows[i].authorurl}>" target="_blank"><{$newrows[i].author}></a><{/if}> (<{$newrows[i].update}>)</td></tr><{/section}><tr><td colspan="2" align="right"><a href="<{$url_more}>" target="_blank">更多...</a></td></tr></table> |
修改后模板
<table width="100%" border="0" cellspacing="0" cellpadding="2"><tr><td width="10%">类型</td><td width="25%">文章名称</td><td width="40%">最新章节</td><td width="15%">作者</td><td width="10%">更新</td></tr><{section name=i loop=$newrows}><tr><td><{$newrows[i].type}></td><td><a href="<{$newrows[i].articleurl}>" target="_blank"><{$newrows[i].article}></a></td><td> <a href="<{$newrows[i].chapterurl}>" target="_blank"><{$newrows[i].chapter}></a></td><td align="right"><{if $newrows[i].authorurl=="#" || $newrows[i].authorurl==""}><{$newrows[i].author}><{else}><a href="<{$newrows[i].authorurl}>" target="_blank"><{$newrows[i].author}></a><{/if}> </td><td align="right"><{$newrows[i].update}></td></tr><{/section}><tr><td colspan="5" align="right"><a href="<{$url_more}>" target="_blank">更多...</a></td></tr></table> |
修改后,首页最近更新区块列表最上方增加了一行内容说明,并且将下面内容整齐排列,让浏览者更加直观和舒适。其中红色部分为增加内容,绿色为修改内容。
模板文件修改好并把原来的文件给替换掉,这时应更新的页面也许没有任何变化。在没有生成静态页面的情况下,是因为程序直接读取缓存文件夹内文件,而忽略了已经被更新的模板文件。 请刷新相应区块,方法有两种: 后台刷新区块(仅对后台可控制区块有效)
- 1、V1.30以下版本:进入网站管理--系统设置--区块管理,点击对应区块的“刷新”,当提示成功了即可。 2、V1.30及以上版本:进入网站管理--系统工具--清理区块缓存,当提示成功即可。
FTP删除(对所有区块有效)
- 使用FTP工具打开JieQi CMS所在目录,清空blockcache和compiled文件夹即可。这两个文件夹里的内容程序会自动全新生成。
如果有生成静态页面,请在后台重新生成!