模板制作
帮助目录 | 安装指南 | 操作入门 | 操作详解 | 模板制作| 高级运用| 常见问题
模板文件路径
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                          // 动态页面公用模板
总体风格
\themes\default\ 文件夹下的 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文件夹即可。这两个文件夹里的内容程序会自动全新生成。

如果有生成静态页面,请在后台重新生成!



公司介绍 | 联系方式 | 客户案例 | 帮助中心 | 服务条款 | 付款方式
Copyright © 2006-2007 jieqi.com, All Rights Reserved.
浙ICP备05000663号