核心概念:模型、字段、内容
在开始之前,先理解三个基本概念:

(图片来源网络,侵删)
- 模型:可以理解为内容的“模板”或“骨架”。“产品模型”定义了所有产品共有的属性。
- 字段:构成模型的“零件”。“产品模型”可以包含“产品价格”、“规格参数”、“产品图片集”等字段。
- 根据某个模型创建的具体数据,一个具体的“iPhone 15”产品信息。
简单流程: 先创建模型 -> 在模型里添加字段 -> 创建使用该模型的内容栏目 -> 在该栏目下发布内容。
第一步:创建新模型
假设我们要创建一个“产品”模型。
-
登录后台:使用管理员账号登录你的织梦CMS后台。
-
进入模型管理:
(图片来源网络,侵删)- 在左侧菜单栏中,找到并点击 【核心】 -> 模型管理】。
- 你会看到系统默认的几个模型,如“文章”、“图片”、“下载”等。
-
添加模型:
- 点击页面右上角的 模型】 按钮。
- 在弹出的表单中,填写以下信息:
- 模型名称:给你的模型起个名字,如“产品”,这个名字会在后台栏目管理中显示。
- 表前缀:系统会自动生成,如
dede_。强烈建议不要修改,除非你知道你在做什么,它用于区分不同模型的数据表。 - 附加表:系统会自动生成,如
dede_addonproduct,这是存储模型自定义字段数据的表,同样不要修改。 - 内容目录:选择一个目录,用于存放通过此模型发布的内容生成的静态HTML文件,可以新建一个,如
products。 - 列表目录:选择一个目录,用于存放该模型内容列表页的静态HTML文件,可以和内容目录相同或不同。
- 通常在前台调用时使用,可以和“模型名称”一样,也可以更详细,如“产品信息”。
- 栏目命名规则:设置该模型下栏目目录的命名规则,如
{tid}或{catdir}。 - 命名规则:设置该模型下内容页的命名规则,如
{aid}或{typedir}/{aid}.html。 - 是否启用:务必勾选 【是】,否则创建的栏目将无法使用此模型。
- 是否自动生成HTML:根据你的需求选择,如果希望内容发布后立即生成静态页,就勾选。
- 文章命名规则:同“命名规则”,用于内容页的文件名。
-
保存模型:
- 填写完毕后,点击 【确定】 按钮。
- 一个名为“产品”的新模型就创建成功了,你可以在“内容模型管理”列表中看到它。
第二步:为模型添加自定义字段
这是自定义模型最关键的一步,我们为“产品”模型添加“价格”、“品牌”、“规格”等字段。
-
进入字段管理:
(图片来源网络,侵删)- 在后台左侧菜单栏中,点击 【核心】 -> 【频道模型】 -> 字段管理】。
- 在页面顶部,你会看到一个下拉菜单,选择你刚刚创建的模型,即 【产品】。
-
添加字段:
- 点击页面右上角的 【增加字段】 按钮。
- 在表单中,填写字段的各项信息(以添加“产品价格”字段为例):
- 字段名称:字段的唯一标识,只能使用英文、数字和下划线,如
price,这个名称在模板调用时至关重要。 - 字段别名:一个更易读的名称,如“产品价格”。
- 字段类型:选择字段的输入类型,对于价格,选择 【数字】 即可,常用类型有:
- 文本:单行文本。
- 文本域:多行文本,适合描述。
- 数字:只能输入数字。
- 布尔:单选,是/否,适合开关状态。
- 下拉:单选,需要手动输入选项,如“品牌:苹果,华为,小米”。
- 多选:多选,同样需要手动输入选项。
- 复选框:多选,同上。
- 日期:日期选择器。
- 图片:上传单张图片。
- 图片集:上传多张图片。
- 文件:上传附件。
- 字段说明:在后台发布内容时,这个说明会显示在输入框旁边,提示用户填写什么,如“请输入产品价格(单位:元)”。
- 默认值:可选,设置字段的默认值。
- 是否为空:通常勾选 【否】,表示这个字段是必填项。
- 是否显示在发布页:勾选 【是】,这样在后台发布内容时才能看到这个输入框。
- 是否启用html代码:对于文本域等,如果允许用户输入HTML标签(如加粗、链接),就勾选。
- 显示:勾选 【是】页才能显示这个字段的信息。
- 显示样式:可以设置在内容页如何显示这个字段,
价格:[field:price/] 元。 - 字段大小:输入框的宽度。
- 列宽:在后台内容列表中,该字段的显示宽度。
- 字段名称:字段的唯一标识,只能使用英文、数字和下划线,如
-
保存字段:
- 填写完毕后,点击 【确定】。
- 重复以上步骤,为你的模型添加所有需要的字段,如
brand(品牌)、specs(规格)、is_new(是否新品)等。
第三步:创建使用新模型的栏目
字段添加好了,现在需要一个“容器”来存放这些内容,这个容器就是“栏目”。
-
进入栏目管理:
- 在后台左侧菜单栏中,点击 【栏目】 -> 【添加栏目】。
-
设置栏目属性:
- 栏目名称:填写栏目名称,如“智能手机”。
- 栏目目录:设置栏目在网站上的路径,如
smartphone。 - 栏目类型:这是最关键的一步! 选择 【频道】。
- 内容模型:在“频道内容”部分,从下拉菜单中选择你刚刚创建的模型,即 【产品】。
-
设置栏目内容:
在“栏目内容”部分,你可以设置该栏目的一些默认属性,比如列表每页显示多少条内容等。
-
保存栏目:
- 点击 【确定】,一个使用“产品”模型的新栏目就创建好了。
第四步:在前台模板中调用自定义字段
最后一步,也是用户能看到效果的一步,就是在你的模板文件中使用这些自定义字段。
页模板文件是 article_article.htm,你需要修改它来显示“产品价格”和“品牌”。
织梦使用特定的标签来调用字段,格式为 [field:字段名/]。
示例:
在 article_article.htm 模板中,找到合适的位置(比如标题下方),添加以下代码:
<h1>[field:title/]</h1>
<!-- 调用系统自带的发布时间 -->
<p>发布时间:[field:pubdate function="MyDate('Y-m-d H:i',@me)"/]</p>
<!-- 调用我们自定义的“产品价格”字段 -->
<p>产品价格:<strong>[field:price/]</strong> 元</p>
<!-- 调用我们自定义的“品牌”字段 -->
<p>产品品牌:[field:brand/]</p>
<!-- 调用我们自定义的“规格”字段,因为它是文本域,可能包含换行,用pre标签保持格式 -->
<p>产品规格:<pre>[field:specs/]</pre></p>
<!-- 调用系统自带的内容正文 -->
<div class="content">
[field:body/]
</div>
说明:
[field:price/]就会输出你在后台发布内容时填写的“价格”。[field:brand/]会输出你选择的“品牌”。- 如果字段类型是“图片”,调用方式为
[field:picname/],它会输出图片的完整URL。 - 如果字段类型是“图片集”,调用方式为
{dede:img text=''}[field:imgsrc/]{/dede:img},这是一个循环标签,会遍历所有图片。
总结与注意事项
- 模型和字段是独立的:先创建模型,再为模型添加字段。
- 字段名称很重要:
字段名称(如price)是模板调用的依据,一旦确定并发布内容,尽量不要修改,否则会导致数据调用失败。 - 栏目类型要选对:创建栏目时,必须选择 【频道】 类型,并指定你自定义的模型。
- 模板调用要准确:严格按照
[field:字段名/]的格式在模板中调用。 - 权限问题:确保你的管理员账号有“内容模型管理”和“频道模型”的权限。
- 静态化:如果选择了自动生成HTML,发布内容后请检查网站根目录下是否生成了对应的HTML文件。
通过以上四个步骤,你就可以在织梦CMS中成功创建并使用自定义模型了,这个过程虽然步骤较多,但逻辑清晰,多练习几次就能熟练掌握。
