织梦CMS自定义字段如何添加使用？

什么是自定义字段？

自定义字段就是你为网站内容额外定义的“属性”。

对于一个“产品”栏目，除了默认的标题、作者、来源、内容外,你可能还需要记录：

• 产品型号
• 市场价格
• 优惠价格
• 产品规格
• 产品参数
• 产品下载手册

这些“产品型号”、“市场价格”等，就可以通过自定义字段功能来添加，添加后，你在发布内容时，就可以填写这些信息,并在模板中调用和显示它们。

自定义字段的类型

织梦CMS提供了多种字段类型,以适应不同数据的需求：

如何添加自定义字段（完整流程）

我们将通过一个实例来演示整个过程：为“产品”栏目添加“市场价格”和“产品参数”两个字段。

第1步：确定模型（通常在栏目管理中设置）

自定义字段是依附于“模型”的,而模型通常在创建栏目时指定。

1. 登录织梦后台，进入【栏目管理】 -> 【添加栏目】。
2. 填写栏目基本信息，如“栏目名称”为“产品”。
3. 在“栏目内容模型”这一步，选择一个合适的模型，你可以选择系统自带的“文章模型”，或者为了更好的管理，点击“选择或添加一个内容模型”。
4. 添加新模型（推荐）：
   • 点击“添加新模型”。
   • 模型名称：填写“产品模型”。
   • 模型表：系统会自动生成，如 dede_addonproduct,无需修改。
   • 点击“确定”。
5. 现在在下拉菜单中选择你刚刚创建的“产品模型”。
6. 继续完成栏目的其他设置并保存。

核心要点：自定义字段是添加在模型上的，而不是栏目本身,一个模型可以被多个栏目使用。

第2步：为模型添加自定义字段

我们来为“产品模型”添加字段。

1. 在后台左侧菜单，找到【核心】 -> 模型管理】。
2. 在模型列表中，找到并点击你刚刚创建的“产品模型”。
3. 进入模型管理页面后，点击 【字段管理】 -> 【添加新字段】。

第3步：配置字段属性（以“市场价格”为例）

现在我们来添加第一个字段：“市场价格”。

1. 字段名称：market_price (英文小写，不含空格,用于程序调用)
2. 字段别名：市场价格 (中文,用于后台显示)
3. 字段类型：选择 【数字】
4. 字段长度：11 (根据需要设置,足够存下价格即可)
5. 默认值：留空
6. 字段提示：请输入产品的市场售价 (这个提示会显示在后台发布内容的输入框下方,非常实用)
7. 是否为空：选择“允许为空”
8. 是否显示在发布页：选择“是”（这样在后台发布内容时才能看到这个输入框）
9. 后台调用字段：market_price (通常自动生成,和字段名称一致)
10. 保存。

第4步：配置第二个字段（以“产品参数”为例）

再次点击【添加新字段】，添加“产品参数”。

1. 字段名称：product_params
2. 字段别名：产品参数
3. 字段类型：选择 【编辑器】 (因为参数可能需要表格等复杂格式)
4. 字段长度：255
5. 字段提示：请输入产品的详细参数，如尺寸、材质、重量等
6. 其他选项：根据需要设置。
7. 保存。

页和列表页调用自定义字段

字段添加并配置好后,你需要在模板文件中调用它们才能在前端显示出来。

页模板 (article_article.htm) 中调用

页模板通常位于 /templets/default/article_article.htm。

织梦提供了两个主要的标签来调用自定义字段：

• {dede:field.字段名称/}：用于调用单值字段，如文本、数字、布尔值等。
• {dede:field.字段名称 function='htmlspecialchars(@me)'/}：功能同上，但会对内容进行HTML转义，防止XSS攻击,推荐使用。
• {dede:field.字段名称/}：对于编辑器类型,它会直接输出HTML格式的内容。

示例：

在 article_article.htm 的合适位置（比如价格信息区域）添加以下代码：

<!-- 产品市场价格 -->
<p class="price-info">
  市场价格: <span class="market-price">{dede:field.market_price function='htmlspecialchars(@me)'/}</span> 元
</p>
<!-- 产品参数 -->
<div class="product-params">
  <h3>产品参数</h3>
  {dede:field.product_params/}
</div>

在列表页模板 (list_article.htm) 中调用

列表页通常用于展示多篇文章的摘要信息，调用自定义字段的方法与内容页类似，但通常需要结合循环标签 {dede:list} 使用。

示例：

在 list_article.htm 中，如果你想显示每篇文章的“市场价格”,可以这样做：

<ul class="list">
  {dede:list pagesize='10'}
  <li>
    <a href="[field:arcurl/]">[field:title/]</a>
    <!-- 调用自定义字段 -->
    <span class="price">市场价: [field:market_price/] 元</span>
  </li>
  {/dede:list}
</ul>

注意：在列表页中，推荐使用 [field:字段名/] 这种简写形式，它和 {dede:field.字段名/} 在列表上下文中是等效的。

在首页或其他模板中调用

调用方式与列表页类似，需要使用 {dede:arclist}

示例：

{dede:arclist typeid='1' row='5'}
  <a href="[field:arcurl/]">[field:title/]</a>
  <p>价格: [field:market_price/] 元</p>
{/dede:arclist}