dede自定义字段如何正确调用？

1. 添加自定义字段：在后台数据库中为你的内容模型（比如文章、图集等）增加新的数据列。
2. 修改模板：在你需要显示这个新字段内容的前台模板文件中,添加相应的调用代码。
3. 发布/编辑内容：在后台发布或编辑文章时,填写新字段的值。

第一步：在后台添加自定义字段

这是最关键的一步，我们以最常见的“文章模型”为例，为其添加一个名为 author_intro（作者简介）的自定义字段。

1. 登录后台：使用管理员账号登录你的 DedeCMS 后台。

2. 进入字段管理：

   • 在左侧菜单栏找到 【核心】 -> 模型管理】。
   • 模型管理页面，点击 【普通文章】（或你想要修改的模型）后面的 【字段管理】 按钮。

3. 添加新字段：

   • 进入字段管理页面后，点击右上角的 【添加新字段】 按钮。

   • 你会看到一个表单,需要填写以下关键信息：

   • 字段名称：这是在数据库中存储的字段名，必须使用英文，并且最好使用下划线分隔单词，author_intro。这个名称在模板调用时非常重要。

   • 字段别名：这是在后台发布文章时显示给管理员看的名称，可以使用中文，作者简介。

   • 字段类型：选择适合你数据类型的选项。

     • 文本框：用于简短的文本，如作者名、关键词。
     • 多行文本：用于较长的文本，如文章摘要、简介。我们的 作者简介 就选这个。
     • 编辑器：如果需要在后台用富文本编辑器（类似Word）来编辑，就选这个,适合大段内容。
     • 单选、多选：用于从固定选项中选择，如文章来源、专题分类。
     • 图片：用于上传单张图片。
     • 图片集：用于上传多张图片,形成图集。
     • 附件：用于上传文件。

   • 字段提示：在后台发布文章时，字段名称下方显示的提示文字，可以告诉管理员这里该填什么，请输入作者的详细简介”。

   • 默认值：如果希望所有新文章的这个字段都有一个默认值,可以在这里填写。

   • 是否为空：选择“否”表示这个字段是必填项。

   • 显示在发布页：选择“是”,这个字段才会出现在后台发布文章的表单中。

4. 保存字段：

   • 填写完所有必要信息后，点击 【保存】 按钮。
   • 系统会提示“字段添加成功”。

重要提示：

• 如果你的网站已经有很多文章，添加新字段后，之前发布的老文章这个字段是空的，你可以在字段管理页面，点击新字段的 【管理】 -> 【批量维护】 来为旧文章批量添加默认值。
• 如果字段类型是“编辑器”，你可能还需要在 【基本参数设置】 中,为这个字段指定一个对应的CSS样式表。

第二步：修改前台模板调用字段

字段添加成功后，我们需要在模板文件中调用它,才能在前台页面显示出来。

1. 找到模板文件：

   • DedeCMS 的模板文件位于你网站的 /templets/ 目录下。
   • 根据你要显示的位置，找到对应的模板文件。
     • 在文章列表页显示：/templets/default/list_article.htm
     • 页显示：/templets/default/article_article.htm (这个文件名可能因模型不同而异，通常是 article_模型ID.htm)
     • 在首页文章列表中显示：/templets/default/index.htm

2. 使用标签调用字段：

   • DedeCMS 使用特定的标签语法来调用数据，调用自定义字段的基本语法是：

     {dede:field.你的字段名称 /}

   • 我们要调用刚才添加的 author_intro 字段，代码就是：

     {dede:field.author_intro /}

3. 示例（在文章内容页显示作者简介）：

   • 打开 article_article.htm 文件。
   • 在你希望显示“作者简介”的位置（比如文章正文下方、作者信息旁边），添加以下代码：

     <div class="author-intro">
         <h3>作者简介</h3>
         <p>{dede:field.author_intro /}</p>
     </div>

   • 保存并上传模板文件到服务器。

第三步：发布/编辑内容

模板已经准备好,我们来测试一下。

1. 进入发布文章页面：在后台，找到 【核心】 -> 【发布文章】 或 【采集】 -> 【发布管理】 -> [审核发布]文章。
2. 填写新字段：你会发现，文章编辑表单中多了一个“作者简介”的字段（或者你填写的字段别名）。
3. ：在“作者简介”的文本框中，输入一些示例文字，张三，资深前端工程师，拥有10年Web开发经验……”。
4. 发布文章：填写完标题、内容等信息后，点击 【发布】 或 【保存】 按钮。

访问你刚刚发布的文章页面，就能看到你添加的“作者简介”已经成功显示出来了。

常用自定义字段类型调用示例

高级技巧：使用[field:函数/]处理字段

我们需要对字段内容进行一些处理，比如截取文字、替换内容等，这时可以使用 [field:函数/] 语法。

语法： {dede:field.字段名 function='处理函数(@me)'/}

常用函数示例：

1. 截取字符串：截取“作者简介”前50个字符。

   {dede:field.author_intro function='cn_substr(@me, 50)'/}

2. ：将单选字段的值 "A" 替换为显示文字 "选项A"。

   {dede:field.source function='str_replace("A","选项A",@me)'/}

3. 去除HTML标签：作者简介”是编辑器类型,但你想只显示纯文本。

   {dede:field.my_content function='htmlspecialchars(strip_tags(@me))'/}

记住这个核心流程： 后台添加字段 -> 前台模板调用 -> 发布内容填写

掌握了自定义字段，你就可以轻松地为 DedeCMS 网站增加各种个性化功能，比如商品参数、活动信息、人物档案、视频链接等等,极大地扩展了网站的功能。