织梦如何单独调用自定义字段？

在列表页（list_*.htm）或首页（index.htm）中调用

在列表页调用自定义字段稍微复杂一些，因为列表页是通过织梦的标签循环调用多篇文章的，你需要使用 arclist 或 list 标签，并配合 array 属性来指定需要调用的字段。

核心标签：arclist (推荐用于首页、频道页)

语法： 在 arclist 标签内使用 typeid (指定栏目ID) 和 addfields (指定要调用的自定义字段名，多个字段用逗号隔开)。

示例： 在首页调用“产品”栏目（ID=1）下的文章，并显示自定义字段 product_price (价格) 和 product_model (型号)。

{dede:arclist typeid='1' titlelen='30' addfields='product_price,product_model'}
  <li>
    <a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a>
    <p>型号：[field:product_model/]</p>
    <p>价格：¥[field:product_price/] 元</p>
  </li>
{/dede:arclist}

参数说明：

• typeid='1'：调用栏目ID为1下的文章。
• addfields='product_price,product_model'：这是关键，告诉织梦在获取文章列表时，额外获取 product_price 和 product_model 这两个字段的值。
• [field:product_price/]：在循环体内，使用 field: 加上字段名来调用单个值。

核心标签：list (专门用于列表页)

列表页模板（如 list_article.htm）默认的循环标签是 {dede:list}，它的用法与 arclist 非常相似。

示例： 在文章列表页模板中，调用自定义字段 source (来源)。

{dede:list pagesize='10' addfields='source'}
  <div class="list-item">
    <h2><a href="[field:arcurl/]">[field:title/]</a></h2>
    <div class="info">
      <span>来源：[field:source/]</span>
      <span>发布时间：[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
    </div>
  </div>
{/dede:list}

注意：{dede:list} 默认不支持分页标签 {dede:pagelist/}，如果需要分页，请使用 {dede:arclist} 标签并配合 typeid 来模拟列表页。

使用SQL语句直接调用（最灵活、最强大）

当 arclist 和 list 标签无法满足复杂需求时（需要跨表查询、进行特定条件筛选）,可以直接使用SQL语句。

语法： 使用 {dede:sql} 标签,编写SQL查询语句。

示例1：调用指定栏目的文章及其自定义字段

假设我们要调用“新闻”栏目（ID=3）下的所有文章，并显示标题和自定义字段 editor (编辑)。

{dede:sql sql="SELECT id, title, editor FROM `dede_archives` a LEFT JOIN `dede_addonarticle` b ON a.id = b.aid WHERE a.typeid = 3"}
  <div>
    <h3>[field:title/]</h3>
    <p>编辑：[field:editor/]</p>
  </div>
{/dede:sql}

SQL语句解析：

• SELECT id, title, editor：选择要查询的字段。id 是文章主表ID，title 是标题，editor 是我们自定义的字段（它在附加表 dede_addonarticle 中）。
• FROMdede_archivesa：从主表 dede_archives 查询，并给它一个别名 a。
• LEFT JOINdede_addonarticleb ON a.id = b.aid：通过 LEFT JOIN 连接附加表 dede_addonarticle（别名 b），连接条件是文章ID (a.id 和 b.aid)。注意：附加表的表名因模型而异，文章模型通常是 dede_addonarticle，图集是 dede_addonimages,等等。
• WHERE a.typeid = 3：查询条件,只选择栏目ID为3的文章。

示例2：调用自定义表单的数据

如果你的自定义字段是在一个独立的自定义表单中,调用方法类似。

假设有一个自定义表单，表单名为 dede_diyform1，要调用里面的 company_name 和 contact_person 字段。

{dede:sql sql="SELECT company_name, contact_person FROM `dede_diyform1` WHERE status = 1"}
  <p>公司：[field:company_name/]</p>
  <p>联系人：[field:contact_person/]</p>
{/dede:sql}

常见问题与注意事项 (FAQ)

1. 为什么调用后显示空白？

   • 最常见原因：没有在 arclist 或 list 标签中使用 addfields 属性来声明要调用的自定义字段。
   • 数据为空：该篇文章的这个自定义字段本身就是空的。
   • 字段名错误：检查字段名是否与数据库中的一致,注意大小写。
   • 附加表错误：如果使用SQL，确保连接了正确的附加表（如 dede_addonarticle）。

2. addfields 和 sql 的选择？

   • 优先使用 addfields：对于列表页和首页的常规调用，addfields 是最简单、最高效、最安全的方式,符合织梦的设计规范。
   • sql 用于特殊场景：当你需要非常复杂的查询逻辑，比如跨表、联合查询、特定排序、或者调用非文章模型的数据时，sql 是不二之选，但要注意SQL注入风险,尽量使用固定的ID和字段名。

3. 如何调用图片/文件字段？ 如果你的自定义字段类型是“图片”或“文件”，调用时它会返回一个路径字符串，你可以直接使用 field:fieldname，或者用 @me 进行处理。

   示例（图片字段 pic）：

   <img src="[field:pic/]" alt="[field:title/]" />

   如果需要调用上传时的原始描述文字（如果有的话）,可能需要通过SQL查询附加表的对应文本字段。

希望这份详细的指南能帮助你完全掌握在织梦中调用自定义字段的方法！