迅睿CMS自定义模块创建与内容调用实操全步骤

一、环境部署与基础准备

1. 迅睿CMS安装：官方下载地址：https://download.xunruicms.com/xunrcms.zip，上传至服务器根目录，执行解压命令`unzip xunrcms.zip`，删除原压缩包，执行`chmod -R 755 /你的网站目录`；访问域名按页面引导完成安装，数据库选择MySQL 5.7+，后台默认路径为`/admin.php`。

2. 核心前置要求：确保服务器支持PHP 7.4+、GD库、curl扩展，否则部分功能无法使用。

二、自定义模块基础创建

步骤1：进入模块管理后台

登录后台后，在左侧导航栏依次点击「内容」→「模块管理」，进入模块列表页面。

步骤2：填写模块基础信息

点击右上角「添加模块」，严格按以下规则填写：

• 模块名称：产品展示（自定义名称，可直接见名知意）
• 模块标识：product（必须为唯一英文小写标识，不可含中文/特殊字符，不可与现有模块重复）
• 所属分组：自定义（按需选择，无分组可直接留空）
• 是否开启前台投稿：勾选（需要用户提交产品时勾选，不需要则不勾选）

其余选项保持默认，点击「提交」完成模块创建，若列表未显示，点击页面右上角「更新模块缓存」刷新。

三、配置模块专属字段

步骤1：进入字段管理页

在模块列表找到刚创建的「产品展示」模块，点击右侧「字段管理」，进入字段配置界面。

步骤2：添加核心业务字段

点击「添加字段」，依次创建以下4个必填字段，每个字段按要求配置：

• 字段名：product_name，类型：文本输入，字段标识：product_name，输入长度：255（最大允许值），是否必填：勾选
• 字段名：product_price，类型：数字输入，字段标识：product_price，数字类型：整数，最小值：0，是否必填：勾选
• 字段名：product_img，类型：图片上传，字段标识：product_img，允许格式：jpg/png，是否必填：勾选
• 字段名：product_desc，类型：文本域，字段标识：product_desc，行数：5，是否必填：不勾选

每个字段配置完成后点击「提交」，全部字段添加后，必须回到模块列表点击「更新模块缓存」，否则字段不会生效。

四、模块内容的发布与管理

步骤1：添加单条模块内容

在左侧导航栏「内容」→「产品展示」，点击「添加内容」，依次填写各字段示例：

• 产品名称：高性能企业级服务器
• 产品价格：9999
• 产品图片：上传一张本地jpg格式的产品缩略图
• 产品描述：支持100核200G内存，适合中大型企业核心业务部署

填写完成后点击「提交」，单条内容发布成功；如需批量导入，可点击「导入内容」下载CSV模板按格式填写后上传。

五、前端页面调用模块内容

步骤1：定位目标模板文件

登录后台→「模板」→「当前模板管理」，找到要调用模块的页面模板（如`pc/index.html`），点击右侧「编辑」进入代码编辑页。

步骤2：编写模块调用代码

在模板文件合适位置添加以下完整代码块，调用产品展示模块的内容：

``` {module name="product" row="8" page="1"} {loop $data $k $v} {/loop} ```

代码参数说明：`name="product"`对应之前设置的模块标识；`row="8"`为每页显示8条内容；`page="1"`为当前页码，实现分页需添加分页代码，如需分页可追加`{$pages}`在代码后。

步骤3：生效前端页面

回到模板列表页，点击右上角「更新模板缓存」，清空浏览器本地缓存后，访问前端对应页面，即可看到模块内容正常显示。