织梦DedeCMS V5.7 标签手册
织梦的核心在于其强大的标签系统,它允许你通过简单的HTML-like标签,动态地从数据库中获取内容并生成网页,无需编写复杂的PHP代码。

(图片来源网络,侵删)
标签基础语法
所有织梦标签都遵循一个基本格式:
{dede:标签名 属性='值' /}
块(循环体)的标签:
{dede:标签名 属性='值'}
<!-- 循环内容 -->
[field:属性名/]
{/dede:标签名}
{dede:...}: 标签的开始。属性='值': 定义标签的参数,如数量、排序方式等。- 对于单标签,表示结束。
[field:.../: 在循环体内,用于输出当前条目的具体字段值。{dede:...}: 标签的结束。
常用内容标签
这类标签主要用于调用文章、图集等栏目内容。
文章列表标签
这是最常用的标签,用于在首页、列表页等地方显示文章列表。

(图片来源网络,侵删)
{dede:arclist typeid='' row='' titlelen='' orderby='' keyword='' channelid=''}
<li>
<a href="[field:arcurl/]" title="[field:title/]">[field:title function='cn_substr(@me, 30)'/]</a>
<span>[field:pubdate function='MyDate('Y-m-d', @me)'/]</span>
</li>
{/dede:arclist}
常用属性说明:
| 属性名 | 含义 | 示例 | 备注 |
|---|---|---|---|
typeid |
栏目ID | typeid='1' |
调用指定栏目及其子栏目的文章。typeid='0'表示调用所有栏目。 |
row |
调用条数 | row='10' |
显示多少篇文章。 |
orderby |
排序方式 | orderby='hot' |
hot(浏览量), click(点击量), pubdate(发布日期), sortrank(置顶级别)。 |
keyword |
keyword='织梦' |
调用包含指定关键词的文章。 | |
channelid |
内容模型ID | channelid='1' |
1为文章模型,2为图集模型,用于调用不同模型的内容。 |
idlist |
文章ID列表 | idlist='1,3,5' |
调用指定ID的文章,忽略其他所有条件。 |
limit |
起始位置,条数 | limit='0,5' |
从第0条开始,取5条,等同于row='5'。 |
循环体内常用字段:
| 字段名 | 含义 |
|---|---|
[field:title/] |
|
[field:arcurl/] |
文章链接 |
[field:pubdate/] |
发布时间戳(Unix时间戳) |
[field:pubdate function='MyDate('Y-m-d', @me)'/] |
格式化后的发布时间 |
[field:description/] |
文章摘要 |
[field:litpic/] |
文章缩略图 |
[field:click/] |
点击量 |
[field:source/] |
来源 |
[field:writer/] |
作者 |
标签
页(article_article.htm)中调用当前文章的信息。
<h1>[field:title/]</h1>
<div class="info">
<span>发布时间:[field:pubdate function="MyDate('Y-m-d H:i:s', @me)"/]</span>
<span>来源:[field:source/]</span>
<span>作者:[field:writer/]</span>
<span>点击:[field:click/]</span>
</div>
<div class="content">
[field:body/]
</div>
常用字段:
| 字段名 | 含义 |
|---|---|
[field:title/] |
当前文章标题 |
[field:pubdate/] |
发布时间戳 |
[field:source/] |
来源 |
[field:writer/] |
作者 |
[field:click/] |
点击量 |
[field:body/] |
文章正文内容 |
[field:description/] |
文章摘要 |
图集列表标签
用于调用图集中的图片。
{dede:imglist imgid='' row=''}
<li>
<a href="[field:imgurl/]" title="[field:text/]">
<img src="[field:imgurl/]" alt="[field:text/]">
</a>
</li>
{/dede:imglist}
常用属性:
| 属性名 | 含义 | 示例 |
|---|---|---|
imgid |
图集ID | imgid='123' |
row |
调用图片数量 | row='5' |
自定义模型内容标签
如果创建了自定义的内容模型(如产品、下载等),可以使用sql标签或channelartlist结合arclist来调用。
示例:调用产品模型(假设channelid为3)
{dede:arclist channelid='3' row='8' titlelen='20'}
<li>
<a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a>
<p>价格:[field:price/]</p> <!-- 假设模型中有price字段 -->
</li>
{/dede:arclist}
栏目与导航标签
栏目列表标签
用于生成网站的导航菜单。
{dede:channel type='top' row='8'}
<li><a href="[field:typeurl/]">[field:typename/]</a></li>
{/dede:channel}
常用属性:
| 属性名 | 含义 | 示例 |
|---|---|---|
type |
栏目类型 | type='top' (顶级栏目), type='son' (当前栏目的子栏目), type='self' (包括当前栏目和子栏目)。 |
row |
调用栏目数量 | row='10' |
typeid |
指定父栏目ID | typeid='2',用于调用指定栏目的子栏目。 |
当前栏目信息标签
在栏目页(list_栏目ID.htm)中获取当前栏目的信息。
<h1>[field:typename/]</h1> <p>[field:description/]</p>
分页标签
用于在列表页和内容页生成分页导航。
<div class="dede_pages">
<ul>
<li><span class="pageinfo">共 <strong>{dede:pagelist listsize='0'/}</strong> 页</span></li>
{dede:pagelist listitem='info,index,end,pre,next,pageno' listsize='5'/}
</ul>
</div>
{dede:pagelist/}常用属性:
| 属性名 | 含义 |
|---|---|
listitem |
显示的分页项目 |
listsize |
显示的页码数量 |
搜索表单标签
用于生成一个搜索框。
<form name="formsearch" action="{dede:global.cfg_cmspath/}/search.php">
<input type="hidden" name="kwtype" value="0" />
<input type="text" name="q" size="12" />
<select name="searchtype">
<option value="title" selected="1">智能模糊搜索</option>
<option value="titlekeyword">仅搜索标题</option>
</select>
<button type="submit">搜索</button>
</form>
其他实用标签
网站信息标签
调用网站的全局配置信息。
| 含义 | |
|---|---|
{dede:global.cfg_webname/} |
网站名称 |
{dede:global.cfg_weburl/} |
网站首页URL |
{dede:global.cfg_powerby/} |
网页版权信息 |
友情链接标签
{dede:flink type='text' row='24' titlelen='24'}
<a href="[field:url/]" target="_blank">[field:name/]</a>
{/dede:flink}
常用属性:
| 属性名 | 含义 |
|---|---|
type |
链接类型 |
row |
调用数量 |
SQL查询标签
极其强大! 可以直接执行SQL语句来获取数据,实现更复杂的需求。
{dede:sql sql='SELECT * FROM dede_archives ORDER BY click DESC LIMIT 0, 10'}
<li>
<a href="[field:arcurl/]">[field:title/]</a>
<span>点击:[field:click/]</span>
</li>
{/dede:sql}
注意: 使用SQL标签有一定风险,请确保SQL语句的安全性,避免SQL注入。
读取特定文档标签
用于调用指定ID的文档,常用于调用“网站公告”等。
{dede:field name='typeid' function='GetTopid(@me)'/} <!-- 获取顶级栏目ID -->
{dede:sql sql="SELECT * FROM dede_archives WHERE id=1"}
<h3>[field:title/]</h3>
<div>[field:body/]</div>
{/dede:sql}
高级技巧
标签判断
可以在标签内使用if/else逻辑。
{dede:field name='typeid' runphp='yes'}
if(@me == 1) {
@me = "这是首页";
} else {
@me = "这是其他页面";
}
{/dede:field}
调用子栏目内容
在栏目页,如果想调用当前栏目的子栏目,并同时显示子栏目下的文章。
{dede:channelartlist typeid='self'}
<h2>{dede:field name='typename'/}</h2>
<ul>
{dede:arclist row='5' titlelen='20'}
<li><a href="[field:arcurl/]">[field:title/]</a></li>
{/dede:arclist}
</ul>
{/dede:channelartlist}
总结与建议
- 善用官方手册:虽然这份手册很全面,但织梦官方也提供了更详尽的文档,遇到不常见的标签时,应优先查阅官方资料。
- 模板文件是关键:理解这些标签后,你需要将它们应用到织梦的模板文件中(如
index.htm,list_article.htm,article_article.htm等)。 - 调试技巧:如果标签不生效,首先检查标签语法是否正确,其次检查
typeid等参数是否正确,可以尝试在标签前后加上HTML注释,看页面源码中标签是否被正确解析。 - 安全第一:特别是
sql标签,务必对用户输入进行过滤,防止网站被黑客攻击。
希望这份手册能成为你开发织梦网站的得力助手!
