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

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

内容如下:

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

发表评论
加载中...

相关文章