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

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

这是最关键的一步,确保字段的类型设置正确。

进入模型管理

1. 登录你的 DedeCMS 后台。
2. 在左侧菜单栏找到 【核心】 -> 模型管理】。

选择并修改模型

模型管理页面，找到你想要添加字段的文章模型，通常是 “文章” 模型。 2. 点击模型名称后面的 【字段管理】。

添加新字段

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

2. 在弹出的表单中,填写以下信息：

   • 字段名称: 这是最重要的，必须使用英文字母或下划线，myimg、product_img 等。不能使用中文,因为模板调用时需要用到这个名字。
   • 字段别名: 可以和字段名称一样,或者填写一个更易读的英文标识。
   • 字段类型: 务必选择 image,这是专门用于上传和存储图片信息的类型。
   • 字段长度: 可以填写 255,这足够存储图片路径了。
   • 默认值: 留空。
   • 字段提示: 在前台发布内容时，这个提示会出现在输入框旁边，请上传产品图片”。
   • 是否为空: 根据需要选择，通常选“否”表示必须填写。
   • 显示: 可以选择“文本框”或“编辑器”。
   • 显示: 务必选择 图片，这样在前台调用时,系统才能正确解析图片路径。

3. 填写完毕后，点击 【保存】。

   
   （图片来源网络，侵删）

（可选）将字段添加到发布表单

1. 返回到 模型管理】 -> 【字段管理】 页面。
2. 点击你刚刚创建的字段所在行的 【管理】 -> 列表】。
3. 这样，在你发布文章时，这个图片上传框就会出现在编辑界面的内容列表中了,方便你上传图片。

第二步：在前台模板中调用自定义图片字段

现在字段已经准备好了，你可以在你的模板文件（通常是 article_article.htm 或 list_article.htm 等）中调用它了。

页（article_article.htm）调用

这是最常见的情况,在文章详情页显示你上传的图片。

假设你自定义的字段名是 myimg。

方法1：直接调用图片路径（推荐）

如果你的图片上传后，系统只保存了路径（/uploads/allimg/20251027/123456.jpg）,你可以直接使用这个路径。

{dede:field name='myimg'/}

方法2：使用 GetImgUrl 函数（更安全）

GetImgUrl 是 DedeCMS 的一个内置函数，它能确保获取到的是完整的、可访问的图片 URL，即使你只存了相对路径,这是最推荐的方法。

<img src="{dede:field name='myimg' function='GetImgUrl(@me)'/}" alt="自定义图片" />

代码解释:

• {dede:field name='myimg'/}: 获取 myimg 字段的原始值（可能是路径，也可能是完整的HTML标签）。
• function='GetImgUrl(@me)': 对获取到的原始值（@me 代表这个原始值）进行处理，调用 GetImgUrl 函数,将其转换为标准的图片URL。
• <img src="..." />: 将处理后的URL作为 img 标签的 src 属性,这样就能在页面上显示图片了。

在列表页（list_article.htm 或 arclist 标签）调用

如果你想在文章列表页也显示每篇文章的自定义图片，需要使用 arclist 标签,并在里面指定要调用的字段。

方法1：在 list_article.htm 模板中使用 arclist

{dede:arclist row='10' titlelen='30'}
    <li>
        <!-- 调用自定义图片字段，并加上缩略图样式 -->
        <img src="[field:myimg function='GetImgUrl(@me)'/]" alt="[field:title function='html2text(@me)'/]" />
        <a href="[field:arcurl/]">[field:title/]</a>
    </li>
{/dede:arclist}

代码解释:

• [field:myimg function='GetImgUrl(@me)'/]: 在 arclist 标签内部，调用自定义字段的方式与 article_article.htm 中略有不同，使用 [field:字段名] 的格式，同样推荐使用 GetImgUrl 函数。
• [field:title function='html2text(@me)'/]: 调用标题作为图片的 alt 属性，html2text 函数可以去除HTML标签,防止有特殊字符导致页面错误。

方法2：使用 arclist 的 addfields 属性

如果你的列表页只需要显示少量自定义字段，可以在 arclist 标签里使用 addfields 来指定,这样效率更高。

{dede:arclist row='10' titlelen='30' addfields='myimg,another_field'}
    <li>
        <img src="[field:myimg function='GetImgUrl(@me)'/]" alt="[field:title function='html2text(@me)'/]" />
        <a href="[field:arcurl/]">[field:title/]</a>
    </li>
{/dede:arclist}

addfields='myimg,another_field' 的意思是，除了默认的字段（如标题、链接等），额外查询 myimg 和 another_field 这两个字段。

常见问题与解决方案

调用后显示为空或只显示路径？

• 原因: 字段类型可能不是 image，或者前台模板调用时没有使用 GetImgUrl 函数。
• 解决: 检查第一步的字段类型是否为 image，并在模板中使用 {dede:field name='myimg' function='GetImgUrl(@me)'/} 或 [field:myimg function='GetImgUrl(@me)'/] 的方式调用。

图片路径不正确，无法显示？

• 原因: 上传图片时，系统生成的路径可能有问题,或者网站根目录配置不正确。
• 解决: 确保图片已经成功上传到服务器的 uploads 目录下。GetImgUrl 函数通常会自动处理路径问题，如果仍有问题，可以检查后台的“系统参数”中的“站点根网址”是否配置正确。

想调用自定义字段里的图片作为文章的缩略图？

• 方法: 在调用文章缩略图的地方,使用自定义字段的内容覆盖默认的缩略图。
• 示例代码 (在 arclist 中):

  {dede:arclist row='10'}
      <li>
          <!-- 如果自定义图片字段 myimg 不为空，则使用它，否则使用默认缩略图 litpic -->
          <img src="
          [field:myimg runphp='yes']
              if(@me != '') @me = GetImgUrl(@me);
              else @me = '/images/default.jpg'; // 设置一个默认图片路径
          [/field:myimg]
          " alt="[field:title/]" />
      </li>
  {/dede:arclist}

  • runphp='yes' 允许在模板内执行PHP代码。
  • if(@me != '') 判断 myimg 字段是否为空。
  • GetImgUrl(@me) 如果不为空,则处理路径。
  • else @me = '/images/default.jpg'; 如果为空,则使用一个你准备的默认图片。

通过以上步骤，你就可以在 DedeCMS 中灵活地使用自定义图片字段了。核心是字段类型选 image，模板调用用 GetImgUrl 函数。