模板结构分析

发布日期： 2023/10/26

一模板位置

模板文件放置于根目录下的 system/web/theme/ 的theme文件夹里；

里面每个文件夹代表一套模板；

模板文件夹名称必须以纯英文或英文加数字的方式命名

该目录下的模板文件夹会被系统自动识别并在后台的“主题配置”以列表形式展示；

二模板结构

BOSSCMS

（一）box 第三方文件存放的文件夹

该文件夹是放置第三方插件或图片等文件的地方；在运行网站程序后会自动拷贝复制到根目录下的cache/box/ 文件夹中，其下级中的js或css文件会被系统自动引用到网页头部的css集和底部的js集；

例如：官方模板 HY001 文件夹中的 box 文件夹中就带有第三方插件swiper.jquery.min.js；在运行程序后前台页面可以看到底部js中自动引用了该js文件并存放于cache缓存文件夹

BossCMS

注：box文件夹会被整个复制到cache缓存文件夹，但只有box的直接下级js和css文件会被自动引用，多层的文件夹里的文件不会被引用；如果需要引用box里的多层文件夹下的js或css文件可以直接页面中写入缓存文件夹目录下的box相对路径；例如：cache/box/xxxx_slide/xxxx.min.js 的文件引用地址。

（二）com 模板公共文件夹

该文件夹用于存放公共的头部和底部html代码文件和公共的css，js文件；如果有其他公用的页面代码文件也建议放置此文件夹中；

BossCMS

（三）html 各栏目类型（模型）的页面代码文件夹

该文件夹是后台包括“首页（home）、简介模型（about）、新闻模型（news）、产品模型（product）、图片模型（image）、下载模型（download）、反馈模型（feedback）、搜索模型（search）、自定义（page）、自建视频模型（video）”各栏目类型（模型）的对应模板代码文件，必须以.html为文件格式；

BossCMS

作为html文件夹的直接下级，例如home.html文件表示首页只有该主题风格文件；而以文件夹形式，里面存放多个.html文件的（例如about文件夹），表示该栏目类型可在后台进行栏目主题风格模板选择，每个.html文件表示该栏目类型的一种页面主题风格； BossCMS

BOSSCMS

（1）home.html 文件属于该文件夹的直接下级文件，是对应前台站点首页的模板代码文件，该文件必须以home命名才会被前台首页调用到

（2）about文件夹对应后台的简介栏目类型，里面默认模板文件名为 about.html；

（3）news 文件夹对应后台的新闻栏目类型的列表页，里面默认模板文件名为 news.html;

（4）news_detail 文件夹对应后台的新闻栏目类型的详情页，里面默认模板文件名为 news_detail.html;

（5）product文件夹对应后台的产品栏目类型的列表页，里面默认模板文件名为 product.html;

（6）product_detail 文件夹对应后台的产品栏目类型的详情页，里面默认模板文件名为 product_detail.html;

（7）image文件夹对应后台的图片栏目类型的列表页，里面默认模板文件名为 image.html;

（8）image_detail 文件夹对应后台的图片栏目类型的详情页，里面默认模板文件名为 image_detail.html;

（9）download文件夹对应后台的下载栏目类型的列表页，里面默认模板文件名为 download.html;

（10）download_detail 文件夹对应后台的下载栏目类型的详情页，里面默认模板文件名为 download_detail.html;

（11）feedback文件夹对应后台的反馈栏目类型，里面默认模板文件名为 feedback.html；

（12）search文件夹对应后台的搜索栏目类型，里面默认模板文件名为 search.html；

（13）page文件夹对应后台的自定义栏目类型，里面默认模板文件名为 page.html；

（14）tags.html 文件属于该文件夹的直接下级文件，是对应前台站点tag标签聚合页的模板代码文件

（15）video文件夹对应后台的视频（自建模型）栏目类型的列表页，里面默认模板文件名为 video.html;

（16）video_detail 文件夹对应后台的视频（自建模型）栏目类型的详情页，里面默认模板文件名为 video_detail.html;

注意：每个文件夹中的默认文件都是跟文件夹名称一致的；该默认命名的用处在于栏目没有选择主题风格模板时，会自动调用该默认命名的主题风格模板文件。如果需要其他风格主题模板页面，可在对应栏目类型文件夹下新建.html文件，命名必须为英文、数字或下斜杆的组合，如果使用中文可能出现乱码问题（除开须有一个默认文件命名，其他文件命名可按实际情况而定）。

（四）css 文件夹

该文件夹存放为各主题风格模板页的css代码；其路径和命名与上述（三）中的html文件夹必须一致；包括其他栏目类型都必须在其对应文件夹里新增css文件；

例如：html/home.html 首页模板的css文件存放位置就必须为 css文件夹下的直接下级文件home.css（路径：css/home.css）；简介栏目类型里新增的html/about/fengge2.html 对应的css代码应该放置于css/about/fengge2.css 中。

模板结构分析 BossCMS

说明：css文件是以php程序形式被执行的，所以在使用编写css内容时，如果有需要调用系统变量或php运算，可直接插入php代码运行。

注：如果对应模板主题风格页不需要css文件，则不必非要在css文件夹里对应位置新建css文件。

（五）js 文件夹

结合上方第三html文件夹和第四css文件夹所描述的一样；对照要求进行新建js文件即可

（六）config.json 模板配置信息文件

该文件记录着模板标题（title）、模板型号（serial）、模板版本（version）、模板描述（description）、模板支持的栏目分级（level）、模板调用隐藏字段（transfer）、Jquery版本（jquery）；该文件可通过插件“模板制作助手”直接修改

BossCMS

（七）ctrl.json 模板控制字段及默认值文件；info.json 模板板块命名文件；model.json 自建模型配置文件

（八）系统 common 文件夹自带文件替换

系统的会员中心、Tag标签、公共css、公共js等样式文件都保存在 system/web/common/ 文件夹里；如果需要自定义样式，可复制 system/web/common/ 目录下的html、css、js文件夹里文件至模板根目录下html、css、js文件夹中并保持对应文件路径，便可更改系统功能样式

例如：

1. 修改系统自带的公共css和公共js样式：复制 system/web/common/css/global.css、system/web/common/js/global.js 文件至模板根目录下的 css/global.css、js/global.js 并修改文件内容

2. 修改会员中心首页界面：复制 system/web/common/html/member/home.html、 system/web/common/css/member/home.css、 system/web/common/js/member/home.js 文件至模板根目录下的 html/member/home.html、css/member/home.css、 js/member/home.js 并修改文件内容

（九）商城 common 文件夹自带文件替换

后台商店中安装好“商城系统”插件后，商城的会员中心、列表页、详情页样式文件放置于 system/plugin/shop/common 中，如需修改可参考上述（八）的方法进行文件复制到模板对应路径中

例如：

1. 修改系统商城列表页样式：复制 system/plugin/shop/common/html/shop/shop.html、system/plugin/shop/common/css/shop/shop.css 文件至模板根目录下的 html/shop/shop.html、css/shop/shop.css 并修改文件内容

模板结构模板开发模板标签

模板结构分析

常见问题

使用指南

插件开发文档

标签模板开发文档

模板原生开发文档

论坛交流

联系方式