dede模块生成向导如何快速创建自定义模块？-DEDE建站-盈思创科技

这个向导主要位于后台的 “模块” -> “模块管理” -> “增加模块”。

（图片来源网络，侵删）

什么是模块生成向导？

模块生成向导是一个“自动化工具”，你只需要告诉向导你需要什么样的数据表、有哪些字段、前台如何展示,它就会自动为你生成：

假设我们要创建一个“产品展示”模块，需要包含产品名称、产品图片、产品简介、发布时间等信息。

这是向导的第一步,主要是给模块起个名字和描述。

字段	说明	示例
模块名称	模块的正式名称，用于后台菜单显示。	产品展示
模块英文名	模块的唯一标识，通常用小写字母和下划线，用于生成文件和函数名。	product
模块简介	对模块功能的简单描述，方便日后管理。	用于网站展示公司各类产品信息。
数据表前缀	模块生成数据表时使用的前缀，默认是 `dede_`，建议保持默认。	`dede_`
附加表	是否需要额外的表来存储更多信息（如多图、属性等），一般先不选。	不选

填写完成后，点击 “继续”。

（图片来源网络，侵删）

这是整个向导最核心的一步，你需要在这里定义你的产品信息都包含哪些“字段”。

字段属性	说明	示例（产品名称）
字段名	字段在数据库中的名称，只能使用英文、数字和下划线，不能有空格。	`title`
	字段在后台表单中的显示名称。	产品名称
字段类型	字段的数据类型，常用类型有： - `varchar`: 文本，如名称、简介。 - `int`: 整数，如排序、价格。 - `text`: 长文本，如详细内容。 - `datetime`: 日期时间，如发布时间。 - `img`: 单张图片，如产品主图。 - `images`: 多张图片，如产品图集。 - `editor`: 编辑器，用于富文本内容。	`varchar`
字段长度	`varchar` 类型的最大字符数。	`100`
默认值	字段的默认内容。	空
是否为空	是否允许该字段在添加数据时不填写。	是
是否主键	如果该字段是唯一标识（如ID），则勾选。（系统通常会自动生成一个id主键，其他字段不要勾选）	否
是否唯一	该字段的值在表中是否必须唯一（如产品编号）。	否
字段提示	在后台表单中，鼠标悬停时显示的提示文字。	请输入产品的正式名称。

字段列表下方还有几个重要选项：
（图片来源网络，侵删）
- 模板：勾选此项，会为你的模块生成一个“内容页模板”（product_content.htm）。
- 生成列表模板：勾选此项，会为你的模块生成一个“列表页模板”（product_list.htm）。
- 自动生成栏目：勾选此项，会在“频道模型”中自动为你创建一个对应的栏目，方便你在网站后台进行内容管理。（强烈推荐勾选）
所有字段添加完毕后，点击 “保存”。

点击保存后，系统会根据你之前的设置,自动执行以下操作：

创建数据表：在数据库中创建一个名为 dede_product（或你自定义前缀+product）的数据表,并包含你定义的所有字段。
生成后台管理文件：在 /dede/ 目录下生成一系列 PHP 文件，如：
- product_add.php (增加产品)
- product_edit.php (编辑产品)
- product_list.php (产品列表)
- product_do.php (处理表单提交)
生成前台模板文件：在 /templets/default/ 目录下生成模板文件：
- product_list.htm (产品列表页模板)
- product_content.htm (产品内容页模板)
更新缓存：更新系统缓存,使新模块在后台生效。

后台管理：
- 进入后台的 ” -> “所有内容模型”，你会发现多了一个“产品展示”模型。
- 点击 ”，你就可以看到刚才设计的表单,开始添加产品了。
前台调用：
- 模块生成后，会自动为你创建一套专用的调用标签，你可以在首页、列表页等地方使用它们来调用产品数据。
- 调用产品列表：在需要显示产品列表的模板（如首页 index.htm）中加入以下代码：
```
{dede:arclist row='10' titlelen='30' channelid='请在此处填写你的产品模块ID'}
<li>
    <a href="[field:arcurl/]">[field:title/]</a>
    <img src="[field:litpic/]" alt="[field:title/]">
    <p>[field:description function='cn_substr(@me, 100)'/]</p>
</li>
{/dede:arclist}
```
  - channelid 是关键，你需要在 “模块” -> “内容模型管理” 中找到“产品展示”模型，记下它的 ID 填入。
- 调用产品内容页：生成的 product_content.htm 模板文件已经包含了调用单个产品详情的标签，如 [field:title/], [field:content/] 等,你只需要修改它的样式即可。

优点：
- 快速开发：极大节省了从零开始写代码的时间。
- 标准化：生成的代码结构规范,易于维护。
- 功能完整：自带增删改查功能,开箱即用。
注意事项：
1. 字段名规范：字段名只能使用英文、数字和下划线,这是硬性要求。
2. 主键唯一：id 字段是系统自动的主键,不要在向导中再设置其他主键。
3. 模板修改：生成的模板是基础模板,你几乎肯定需要根据网站的美观需求进行修改和美化。
4. 后续扩展：如果需要非常复杂的功能（如关联其他表、复杂的业务逻辑），在向导生成后，你可能还需要手动修改或增加 PHP 代码。
5. 备份：在进行模块生成操作前，最好备份一下你的数据库和网站文件,以防万一。

通过模块生成向导，DedeCMS 实现了“所见即所得”的网站功能扩展，对于中小型网站和快速原型开发来说,是一个非常实用的利器。