dede如何调用页面内容？

的魔法,都源于DedeCMS的模板引擎标签——{dede:...}，你可以把它想象成一个“指令”，告诉DedeCMS在页面的某个位置执行什么操作，并显示什么内容。

最常用的内容调用标签

这些是你在日常建站中使用频率最高的标签,务必熟练掌握。

a. 调用栏目列表：{dede:channel}

用于获取网站栏目的列表,常用于主导航、侧边栏等。

• 基础用法：

  {dede:channel type='top' row='8'}
  <a href="[field:typelink/]">[field:typename/]</a>
  {/dede:channel}

• 参数解析：
  • type='top'：调用顶级栏目。type='son'表示调用当前栏目的子栏目，type='self'表示调用当前栏目及其子栏目。
  • row='8'：显示的栏目数量，这里是8个。
  • [field:typelink/]：调用栏目的链接地址。
  • [field:typename/]：调用栏目的名称。

b. 调用文章列表：{dede:arclist}

这是最核心、最强大的标签，用于调用文章列表，用途极其广泛。

• 基础用法（调用最新文章）：

  {dede:arclist row='10' titlelen='30'}
  <li>
      <a href="[field:arcurl/]">[field:title/]</a>
      <span>[field:pubdate function="MyDate('Y-m-d', @me)"/]</span>
  </li>
  {/dede:arclist}

• 参数解析（常用）：
  • row='10'：调用文章数量。
  • titlelen='30'长度，截取30个字符。
  • typeid='1,2,3'：指定栏目ID调用，多个ID用逗号隔开。
  • channelid='1'：指定模型ID调用。
  • flag='h'：调用带有“头条”标志的文章。flag='c'为推荐，flag='j'为跳转，可以组合使用，如flag='hc'。
  • orderway='desc'：排序方式，desc为降序（默认），asc为升序。
  • limit='start,len'：分页调用，如limit='0,5'表示从第0条开始，调用5条。
  • [field:arcurl/]：文章链接。
  • [field:title/]。
  • [field:pubdate/]：发布日期，通常配合function格式化。

第二部分：DedeCMS调用页面内容的高级技巧

当你掌握了基础标签后,进阶技巧将让你在网站定制化能力上如虎添翼。

在任意页面调用指定内容（自由列表）

场景： 你想在首页的某个特定位置，调用“关于我们”栏目里的一篇文章，或者一个固定的广告位。

解决方案： 使用 “自由列表” 功能。

1. 进入后台： 登录DedeCMS后台，点击【模板】-> 【自由列表管理】。
2. 创建自由列表： 点击“增加自由列表”，填写列表名称（如“首页广告位”），选择要调用的栏目和排序规则。
3. 获取代码： 保存后，系统会生成一个唯一的ID（如list_1），点击“获取代码”，复制生成的代码片段。
4. 插入模板： 将复制的代码片段粘贴到你想要显示内容的模板文件（如index.htm）的指定位置即可。

这种方法的好处是无需修改模板文件,通过后台即可管理列表内容，非常灵活。

调用单页文档内容

场景： 公司简介、联系我们等页面，通常使用“单页文档”模型，如何调用这些内容到其他页面？

解决方案： 使用{dede:field}标签结合SQL查询。

假设你有一个单页文档,标题为“公司简介”，其ID为1。

• 直接调用栏目内容（推荐） 如果你的“公司简介”是一个顶级栏目，且该栏目下只有一篇文章，可以直接这样调用：

  {dede:sql sql="SELECT body FROM `dede_arctiny` WHERE typeid = 1 LIMIT 1"}
      [field:body/]
  {/dede:sql}

  注意：dede_arctiny是文章摘要表，只包含少量信息，要调用完整内容，应查询dede_addonarticle（普通文章）或对应的附加表。

• 更精确的SQL调用 如果你知道单页文档的ID（aid），可以这样调用：

  {dede:sql sql="SELECT body FROM `dede_addonarticle` WHERE aid = 10"}
      [field:body/]
  {/dede:sql}

  重要提示：

  • dede_addonarticle是普通文章的附加表，如果你的单页文档使用了其他模型，需要查询对应的附加表。
  • 直接使用SQL有一定风险,请确保你的aid或typeid是正确的，避免调用错误内容或导致网站出错。

调用自定义字段内容

场景： 你在文章模型中增加了“作者简介”、“产品规格”等自定义字段，如何在文章页或列表页调用它们？

解决方案： 使用[field:自定义字段名/]。

1. 确保字段已创建： 在后台【模型】->【内容模型管理】中，为你的模型添加了自定义字段。
2. 在模板中调用：
   • 在文章页（article_article.htm）中直接调用：

     <p>作者简介：[field:authorinfo/]</p>

   • 在列表页（list_*.htm）或{dede:arclist}中调用：

     {dede:arclist}
         <p>规格：[field:guige/]</p>
     {/dede:arclist}

     注意： 列表页调用自定义字段，需要在后台【系统】-> 【SQL命令行工具】 中执行以下SQL，将附加表字段加入缓存，否则可能无法调用：

     ALTER TABLE `dede_arctiny` ADD COLUMN `guige` CHAR(100) NOT NULL DEFAULT '';

     （请将guige替换成你自己的字段名，并根据实际情况选择是否需要添加到arctiny表）

第三部分：常见问题与解决方案

Q1: 为什么我的调用标签没有显示任何内容？

A1: 常见原因排查：

1. 语法错误： 检查{dede:}标签是否拼写正确，{/dede:}是否闭合。
2. 参数错误： typeid、channelid等参数指定的ID是否存在，如果栏目ID为1，但实际你调用了ID为2的栏目，自然没有内容。
3. 权限问题： 确保调用内容的栏目是“公开”的，而不是“仅会员可见”。
4. 缓存问题： DedeCMS有强大的缓存机制，修改模板后，请务必在后台【生成】-> 【更新主页HTML】 或 【更新栏目HTML】 中重新生成页面。

Q2: 如何实现“上一篇/下一篇”功能？

A2: 使用{dede:prenext} 将此标签放在文章模板（article_article.htm）的合适位置即可。

<div class="prenext">
    {dede:prenext get='pre'/}
    {dede:prenext get='next'/}
</div>

{dede:arclist row='5'}
    <li>
        [field:title/]
        <p>[field:description function="Html2Text(@me)"/]</p>
    </li>
{/dede:arclist}