dede标签快速手册

DedeCMS 标签快速手册

核心概念

DedeCMS 的模板引擎使用一种类似 XML 的标签语法，核心格式是 {dede:标签名 属性='值'}...{/dede:标签名}。

• 单标签：没有闭合标签，通常用于输出一个值，如 {dede:field.name/}。
• 双标签：有开始和结束标签，标签之间的内容可以作为循环或条件判断，如 {dede:arclist}{/dede:arclist}。

核心必备标签

这些是构建任何一个 DedeCMS 网站都离不开的基础标签。

站点信息标签

用于在模板中调用网站的全局配置信息。

字段标签

用于获取当前文档（文章、栏目等）的特定字段值，通常用在文章内容页 (article_article.htm) 或栏目列表页 (list_category.htm)。

循环标签

用于在列表页（首页、栏目页、搜索页等）循环输出文章列表。

{dede:arclist} 内部字段：

• [field:title/]: 文章标题
• [field:arcurl/]: 文章链接URL
• [field:pubdate function='strftime("%Y-%m-%d",@me)'/]: 格式化后的发布时间
• [field:click/]: 点击量
• [field:description/]: 文章摘要
• [field:litpic/]: 文章缩略图

高级与常用标签

栏目标签

{dede:channel} 内部字段：

• [field:typename/]: 栏目名称
• [field:typelink/]: 栏目链接URL

分页标签

用于在列表页生成分页导航。

文章页导航标签页生成“上一篇”和“下一篇”链接。

搜索表单标签

用于生成站内搜索的表单。

模板引擎常用函数

函数用于对标签输出的值进行二次处理，语法为 function='函数名(@me)'。

实用技巧与示例

示例1：首页文章列表

<!-- 最新文章 -->
<h2>最新文章</h2>
<ul class="news-list">
    {dede:arclist row='8' titlelen='30' orderby='pubdate'}
    <li>
        <span class="date">[field:pubdate function='strftime("%m-%d",@me)'/]</span>
        <a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a>
    </li>
    {/dede:arclist}
</ul>
<!-- 热门文章 -->
<h2>热门文章</h2>
<ul class="hot-list">
    {dede:arclist row='6' titlelen='25' orderby='click'}
    <li><a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a></li>
    {/dede:arclist}
</ul>

示例2：栏目列表页 (list_category.htm)

<h1>{dede:field.typename/}</h1>
<p>{dede:field.description/}</p>
<ul class="article-list">
    {dede:list pagesize='10'}
    <li>
        <h3><a href="[field:arcurl/]">[field:title/]</a></h3>
        <p class="info">
            <span>发布时间：[field:pubdate function='strftime("%Y-%m-%d",@me)'/]</span>
            <span>点击：[field.click/]</span>
        </p>
        <p class="desc">[field:description function='cn_substr(@me,200)'/]...</p>
    </li>
    {/dede:list}
</ul>
<!-- 分页 -->
<div class="page">
    {dede:pagelist listsize='4'/}
</div>

注意：在栏目列表页，文章循环标签使用的是 {dede:list}，而不是 {dede:arclist}。

示例3：调用指定栏目的子栏目

<h2>产品分类</h2>
<ul>
    {dede:channel type='son' typeid='2'} <!-- 假设2是“产品”栏目的ID -->
    <li><a href="[field:typelink/]">[field:typename/]</a></li>
    {/dede:channel}
</ul>

自定义标签

如果内置标签无法满足需求,你可以自定义PHP函数标签。

1. 在 /include/extend.func.php 中添加PHP函数：

   // 示例：获取指定栏目的文章数量
   function GetArctypeNum($typeid) {
       global $dsql;
       $query = "SELECT COUNT(*) as num FROM `dede_archives` WHERE typeid = $typeid";
       $row = $dsql->GetOne($query);
       return $row['num'];
   }

2. 在模板中调用：

   本栏目共有 {dede:getarctypenum typeid='1'/} 篇文章

   （注意：此功能需要修改核心文件以支持，新版DedeCMS已简化,推荐使用更灵活的SQL查询标签）

SQL查询标签

这是最强大的自定义方式,可以直接执行SQL语句。

• 基础：先掌握 global、field、arclist、channel 四大金刚。
• 进阶：学习 list、pagelist、prenext 和各种函数。
• 灵活：善用 sql 标签解决复杂需求。
• 参考：官方自带的模板是最好的学习范例,多看多模仿。

这份手册涵盖了80%以上的日常开发场景,希望对你有所帮助！