从零开始做迅睿CMS自定义模板 全流程零基础可直接上手落地

前期准备工作

首先确保你已经完成迅睿CMS的安装，未安装可直接从官方地址下载安装包：https://www.xunruicms.com/download.html，按照安装向导完成安装即可。

迅睿CMS所有模板都存放在站点根目录的templates/目录下，制作自定义模板首先要在templates目录下新建一个自定义文件夹，命名只能用英文小写，例如命名为mytpl，所有模板文件都放在这个文件夹内。

模板核心配置文件编写

配置文件规则说明

自定义模板必须包含一个config.php配置文件，否则后台无法识别模板，该文件必须放在你新建的mytpl文件夹根目录，以下是完整可直接复制的配置代码：

```php '我的自定义模板', // 后台显示的模板名称 'template_version' => '1.0', // 模板版本号 'template_author' => '自定义', // 作者名称 'template_thumb' => '', // 模板预览图，可选，填相对路径即可 ]; ?> ```

只需要修改对应参数即可，不需要额外添加其他内容，配置文件就编写完成。

后台绑定模板操作步骤

配置文件创建完成后，登录迅睿CMS后台，按照以下步骤绑定模板：

• 点击左侧菜单内容 → 栏目管理
• 找到你要应用自定义模板的栏目，点击右侧修改按钮
• 在修改页面下拉找到绑定模板选项，在下拉列表中找到你配置文件中填写的模板名称，选中即可
• 点击底部保存按钮，完成绑定

如果需要全站应用该模板，只需要给所有栏目都绑定这个模板即可，首页会自动启用。

核心页面模板开发

首页index.html开发

首页模板命名必须是index.html，放在mytpl根目录，以下是常用的首页核心代码示例，可直接修改使用：

```html

{list action=module catid=0 num=10 order=updatetime}
• {$t.title} {dr_date($t.updatetime, 'Y-m-d')}
{/list}

```

参数说明：pid=0表示调用所有顶级栏目，num=10表示调用10篇文章，可根据需求修改数字。

列表页list.html开发

列表页命名必须是list.html，用于显示栏目下的内容列表，自带分页功能，核心代码如下：

```html {$cat.name}

{loop $data $t}
• {$t.title}
{/loop}

```

说明：$cat是当前栏目对象，$data是系统自动查询的当前栏目内容数组，$pages是系统自动生成的分页代码，直接输出即可使用，不需要额外开发分页逻辑。

详情页show.html开发

详情页命名必须是show.html，用于显示单篇内容详情，核心代码如下：

```html {$title}

发布时间：{dr_date($updatetime, 'Y-m-d H:i')}

```

说明：$title是内容标题，$updatetime是内容更新时间，$content是内容详情，都是系统自动赋值的变量，直接调用即可。

静态资源引用方法

模板用到的CSS、JS、图片等静态资源，需要在模板文件夹内新建一个static文件夹统一存放，引用路径使用系统内置变量{TEMPLATE_URL}，示例如下：

```html ```

该变量会自动解析为当前模板的根地址，更换域名或服务器后不需要修改路径，兼容性好。

常见问题排查

• 后台找不到自定义模板：检查三个点：1、模板文件夹是否放在templates根目录下；2、是否添加了正确的config.php文件，语法和示例是否一致；3、文件夹命名是否只有英文小写，没有特殊字符和空格。
• 页面显示空白：开启调试模式定位错误，打开站点根目录的config.php文件，找到'debug' => false,修改为'debug' => true,，刷新页面即可看到具体错误信息，按照提示修改即可。
• 修改模板后不生效：迅睿CMS默认开启模板缓存，修改后需要登录后台点击系统 → 清理缓存，刷新页面即可看到最新效果。

完成以上所有步骤后，你的自定义模板就可以正常使用，后续只需要添加CSS调整布局，新增页面按照命名规则添加对应文件即可。