迅睿CMS自定义模型制作完整实操指南

前期准备工作

在开始制作自定义模型前，你需要完成以下准备工作。

环境与权限确认

确保你的迅睿CMS已成功安装，并且拥有管理员后台登录权限。登录后台，检查“系统维护”->“系统信息”，确认PHP版本在7.1及以上，MySQL版本在5.6及以上。

明确模型需求

以创建一个“产品”模型为例，我们需要明确该模型需要包含的字段：产品名称（文本）、产品图片（文件）、产品价格（数字）、产品详情（富文本）、是否上架（单选）。

创建自定义模型

我们将通过后台图形化界面创建模型，无需直接操作数据库。

进入模型管理

登录迅睿CMS后台，依次点击左侧菜单栏“内容”->“内容模型管理”。在模型管理页面，点击右上角的“创建新模型”按钮。

填写模型基础信息

在弹出的表单中，填写以下信息：

• 模型名称：产品（用于后台显示）
• 模型标识：chanpin（必须为英文小写，用于数据库表名）
• 模型描述：可填写“用于管理公司产品信息”
• 是否支持栏目：选择是
• 是否支持内容：选择是

填写完毕后，点击“确定创建”。系统会自动在数据库中创建名为`cms_chanpin`的数据表。

为模型添加自定义字段

模型创建后，只是一个空壳，需要为其添加具体的字段。

进入字段管理

在“内容模型管理”页面，找到刚创建的“产品”模型，点击其右侧操作栏中的“字段管理”链接。

添加“产品名称”字段（文本类型）

1. 点击“添加新字段”。
2. 字段类型选择Text（单行文本）。
3. 字段名称填写产品名称。
4. 字段别名填写title（系统默认标题字段别名即为title，建议保持一致）。
5. 是否为主表字段选择是。
6. 验证规则填写required（表示必填）。
7. 点击“保存”。

添加“产品图片”字段（文件类型）

1. 再次点击“添加新字段”。
2. 字段类型选择File。
3. 字段名称填写产品图片。
4. 字段别名填写thumb。
5. 是否为主表字段选择是。
6. 允许上传格式填写jpg,gif,png。
7. 点击“保存”。

添加“产品价格”字段（数字类型）

1. 点击“添加新字段”。
2. 字段类型选择Float（浮点数）。
3. 字段名称填写产品价格。
4. 字段别名填写price。
5. 是否为主表字段选择是。
6. 验证规则填写numeric。
7. 默认值填写0.00。
8. 点击“保存”。

添加“产品详情”字段（富文本类型）

1. 点击“添加新字段”。
2. 字段类型选择Ueditor（百度富文本编辑器）。
3. 字段名称填写产品详情。
4. 字段别名填写content。
5. 是否为主表字段选择是。
6. 点击“保存”。

添加“是否上架”字段（单选类型）

1. 点击“添加新字段”。
2. 字段类型选择Radio。
3. 字段名称填写是否上架。
4. 字段别名填写status。
5. 是否为主表字段选择是。
6. 选项值填写：1:已上架,0:未上架（格式为“值:显示文本”，用英文逗号分隔）。
7. 默认值填写1。
8. 点击“保存”。

创建栏目并应用模型

字段添加完成后，需要创建一个栏目来使用这个模型。

创建栏目

1. 进入后台“内容”->“栏目管理”。
2. 点击“添加栏目”。
3. 填写栏目名称，例如产品中心。
4. 在“模型选择”处，选择我们刚刚创建的产品模型。
5. 填写其他必要信息（如目录名），点击“确定”保存栏目。

发布与管理内容

现在可以开始使用这个自定义模型发布产品了。

发布新产品

1. 在后台“内容”->“内容管理”页面，左上角的下拉菜单中选择产品模型。
2. 点击“发布内容”。
3. 你会看到一个表单，里面包含了我们之前定义的所有字段：产品名称、产品图片（上传按钮）、产品价格、产品详情（富文本编辑器）、是否上架（单选按钮）。
4. 依次填写或选择每个字段的内容。
5. 点击“发布”按钮，第一条产品数据即创建成功。

前端模板调用

内容发布后，需要在前端页面显示出来。这需要修改模板文件。

列表页模板调用

打开你的模板目录（通常是`/template/你的模板名称/`），找到对应栏目的列表页模板文件（如`list.html`）。在需要显示产品列表的位置，插入以下代码：

``` {module module=chanpin order=updatetime page=1 pagesize=10}

{$t.title}

价格：{$t.price}元

状态：{if $t.status==1}已上架{else}未上架{/if}

{/module} ```

代码解释：
`module=chanpin` 指定调用“产品”模型的数据。
`{$t.title}`, `{$t.thumb}`, `{$t.price}`, `{$t.status}` 分别对应我们定义的字段别名。

详情页模板调用

打开内容详情页模板文件（如`show.html`）。在需要显示具体内容的位置，插入以下代码：

``` {$title}

价格：{$price}元

状态：{if $status==1}已上架{else}未上架{/if}

```

在详情页模板中，可以直接使用{$字段别名}来调用当前内容的所有字段值。

高级配置与注意事项

字段排序与搜索

回到“字段管理”页面，你可以通过拖拽字段列表左侧的十字图标来调整字段在后台发布表单中的显示顺序。对于需要在后台进行搜索的字段（如“产品名称”），可以编辑该字段，在“是否作为搜索条件”选项中选择是。

模型数据备份

自定义模型的数据存储在独立的数据库表中（如前文提到的`cms_chanpin`）。在进行系统备份时，除了默认的表，务必确保备份此表。你可以通过后台“系统维护”->“数据库管理”->“备份数据库”功能进行完整备份。

常见问题排查

• 字段不显示：检查字段管理中，“是否禁用”是否为“否”，以及“是否为主表字段”是否选择正确。
• 前端无法调用数据：检查模板代码中的字段别名是否与后台定义的完全一致，区分大小写。确认列表调用代码是否放在了正确的模板文件中。
• 上传图片失败：检查服务器对应目录（如`/uploadfile/`）的写入权限是否为755或777。

按照以上步骤操作，你可以从零开始创建并应用一个完整的迅睿CMS自定义模型。整个过程的核心在于后台的字段定义与前端的模板标签调用，逻辑清晰，无需编写PHP代码即可实现强大的内容管理功能。