更优雅的处理ZBlogPHP主题的模板文件备注问题

来自:互联网
时间:2019-11-06
阅读:
免费资源网 - https://freexyz.cn/

模板文件备注,是开发者一开始没有关注,到后来又被各种坑的问题。

模板设定,是建站系统中常见的设定;开发者,可以开发编写不同的模板文件,在网站的文章/分类/列表等类型中去选择模板,实现相对动态的页面效果。

不谈历史,反正我们是被系统直接读取所有PHP文件坑惨了的人。被这个问题烦恼后,我在群里闹腾了一段时间,在YT提供的正则帮助下,为模板文件中加入了类型/名称。需求最后到了ZBP的开发四人组(bang)手中,只是添加了模板中名称注释,粗暴简陋,还是会让用户在使用时,错误的选择到不适合当前类型的模板。

在这之后,考虑在模板文件中频繁的读取正则备注,会增加服务器性能压力的情况,改为使用JSON配置的方式,为模板文件添加注释。

有了这个设定,那就需要设定一些规范的规则,因为JSON相对严格的数据模式;

{
    "id": "os_mylog",
    "templates": [
        {
            "filename": "index",
            "type": "list",
            "name": "列表自动模板"
        },
        {
            "filename": "single",
            "type": "single",
            "name": "文章/单页自动模板"
        },
        {
            "filename": "page-archive",
            "type": "page",
            "name": "文章归档页面"
        },
        {
            "filename": "page-link",
            "type": "page",
            "name": "友情链接页面"
        },
        {
            "filename": "page-tag",
            "type": "page",
            "name": "标签云页面"
        }
    ]
}

虽然在后面的读取操作中,id并没有使用,但考虑到冗余问题,暂时先加入id的设定。

templates是一个模板文件数组,其中每一个对象代表了一个可用的模板设定。

filename字段为文件名,*不加.php;

type字段为类型,用于区分不同位置;

name字段为模板名称描述。

关于type类型的设定:

all:全部类型可用;

single:文章或单页中可用;

list:所有列表类型可用,分类/标签/日期/作者页等;

其余类型设置与系统设定相同

添加完模板设定以后,我们还需要处理这个设定;

【处理流程】

1、尝试读取JSON文件,转为对象数据;

2、判断当前编辑的类型,匹配显示对应内容;

3、组成新的html,通过JS语句,替换掉原先的模板下来框选择内容;

这些处理,我们就单独阐述方法了,我将这个php放出来,在include.php中引用这个文件即可(当然,你要替换掉我的模板id前缀,避免变量名污染)。

在include.php中,我们在ActivePlugin_xxxxx函数中,接入接口;

Add_Filter_Plugin('Filter_Plugin_Edit_Response3','os_mylog_OutputTemplateSelect');
Add_Filter_Plugin('Filter_Plugin_Category_Edit_Response','os_mylog_OutputTemplateSelect');
Add_Filter_Plugin('Filter_Plugin_Tag_Edit_Response','os_mylog_OutputTemplateSelect');
Add_Filter_Plugin('Filter_Plugin_Member_Edit_Response','os_mylog_OutputTemplateSelect');

 

JSON需要严格编写,如果自己不能确定是否符合规范,可以在www.bejson.com这个网站中验证。

免费资源网 - https://freexyz.cn/
返回顶部
顶部