杰奇cms官方模板开发文档，解析整理

之前为了解决一个ajax无限加载的问题，需要去除掉字段里的换行，但是折腾了半天都没个结果，所以想想办法去官网下载了文档。话说我之前开发模板都完全没看过这玩意，所以查阅一番之后发现了许许多多曾经没有使用过或者玩过的方法，对于某些比较好用的，非常有整理的必要，另外官网的文档有些地方也写得比较粗略，或许完善一下又可以写一篇文章来水了。
本篇文章的重点主要在“变量调节器”部分，在了解之后，可以不修改杰奇源代码的情况下实现更多操作，比如说分页样式的定义，url编码等。

所有内容都是基于官方文档简单修改，把比较实用的部分拿出来自己举例。

内容如下：

1、truncate - 截取固定长度字符串，参数一(必要)：截取后长度，参数二：附加字符串。

小说简介输入前100个字符，后面的省略

{?$intro?}

写法案例：

{?$intro|truncate:100?} | {?$intro|truncate:100:".."?}

2、subdirectory - JIEQI CMS 里面专用于生成子目录名字的函数，针对数字的处理，无参数。输出格式类似
"/12"，其中"/" 是表示开始一个子目录，"12"是子目录名字。

输入小说的子目录，用于生成访问路径或者封面路径

{?$articleid?}

写法案例：

/files/article/html{?$articleid|subdirectory?}/{$articleid?}/index.html

---

3、date - 把数字类型的时间格式化成字符串，参数一：格式化字符串
格式化字符含义主要有以下几个：

Y - 四位的年份，如 2007
y - 二位年份，如 07
m - 二位月份，不足补零，从 01 到 12
n - 月份，不补零，从 1 到 12
d - 二位的天数，不足补零，从 01 到 31
j - 天数， 不补零， 从 1 到 31
H - 二位24小时格式，从 00 到 24
h - 二位12小时格式，从 00 到 12
G - 24小时格式，从 0 到 24
g - 12 小时格式，从 0 到 12
i - 二位分数，从 00 到 59
s - 二位秒数，从 00 到 59

小说更新时间，输出年-月-日 时:分:秒

{?$lastupdate?}

写法案例：

{?$lastupdate|date:"Y-m-d H:i:s"?}

4、str_replace - 字符串替换，参数一：查找的字符串，参数二：替换为字符串

小说分页标签，去除多余的代码内容

{?$url_jumppage?}

写法案例：

{?$url_jumppage|str_replace:"<li>下一页<li>":""?}

5、urlencod，urldecode - 分别是把字符串进行url编码和解码，于在url传递变量情况，无参数
将杰奇调用网址标签，进行编码

{?$jieqi_url?}

写法案例：

{?$jieqi_url|urlencode?}

6、strlen - 计算字符串长度，无参数
统计章节内容字段的长度

{?$jieqi_content?}

写法案例

{?$jieqi_content|strlen?}

7、定制系统默认的程序页面，使其调用不同的框架或者区块，可以在主体内容模板设置相应的参数来实现。
注：前面两种定制都是指在现有网站的基础上，增加一个独立的页面。而这里的定制是指在不修改系统程序基础
上，通过调整模板来实现系统程序页面的不同显示方式。

以系统的个人信息页面为例，这个页面对应的

程序： /userdetail.php
模板： /templates/userdetail.php
区块配置：/configs/userblocks.php

如果要其他的框架模板，比如：/templates/theme1.html
模板 /templates/userdetail.php 顶部加入设置标签

{?set jieqi_page_template = "templates/theme1.html"?}

这样修改后的效果是，这个页面可以不使用系统默认的导航、css之类效果。

注意：引号里面是模板相对网站根目录的路径和名称，前面不带 "/"，或者使用完整的地址，如 {?set

jieqi_page_template = "E:/web/templates/theme1.html"?}

如果要调用不同区块配置文件，如 /configs/block1.php，则在模板 /templates/userdetail.html 顶部加入设置标签

{?set jieqi_blocks_module = "system"?}
{?set jieqi_blocks_config = "block1"?}

这里第一行是表示这个区块配置属于哪个模块的，第二行是表示区块配置文件名称（不含后缀名）。
上面的标签就是载入区块配置文件 /configs/block1.php

如果 {?set jieqi_blocks_module = "article"?} 则载入的配置文件是 /configs/article/block1.php