织梦模板标签如何正确调用？-织梦建站-盈思创科技

基础核心标签

这些是构建任何页面都离不开的标签。

（图片来源网络，侵删）

网站基本信息调用

用于在页面头部或底部显示网站的全局信息。

说明	示例
`{dede:global.cfg_webname/}`	网站名称	`<title>{dede:global.cfg_webname/}</title>`
`{dede:global.cfg_weburl/}`	网站首页URL	`<a href="{dede:global.cfg_weburl/}">首页</a>`
`{dede:global.cfg_powerby/}`	网页版权信息（通常包含Powered by DedeCMS）	`{dede:global.cfg_powerby/}`
`{dede:global.cfg_beian/}`	网站备案号	`{dede:global.cfg_beian/}`

频道/栏目调用

用于显示网站的栏目导航。

说明	示例
`{dede:channel}`	调用顶级栏目列表	`<ul>{dede:channel}<li><a href='[field:typeurl/]'>[field:typename/]</a></li>{/dede:channel}</ul>`
`{dede:channelartlist}`	调用顶级栏目及其子栏目，常用于主导航下拉菜单	`{dede:channelartlist typeid='top'}<a href="[field:typelink/]">[field:typename/]</a> {dede:channel type='son'}<a href="[field:typeurl/]">[field:typename/]</a> {/dede:channel}{/dede:channelartlist}`
`typeid`	指定调用栏目的ID，如 `typeid='3'`，顶级栏目可用 `typeid='top'`。

文章列表/内容调用

这是最核心、最常用的标签组，用于在首页、列表页、内容页等显示文章。

说明	适用页面	示例
`{dede:arclist}`	文章列表标签，功能极其强大，用于调用指定条件的文章列表。	首页、列表页、自定义页面	见下方详细说明
`{dede:field}`	字段标签，用于获取当前文档（文章/栏目）的某个字段值。	内容页、栏目页	见下方详细说明
`{dede:pagelist}`	分页标签，用于生成文章列表的分页导航。	列表页	`{dede:pagelist listsize='4' listitem='index pre pageno next end '/}`

核心标签详解

`{dede:arclist}` 文章列表标签详解

这是织梦的灵魂标签,必须掌握。

（图片来源网络，侵删）

基本结构：

{dede:arclist 标签属性='值'}
    <a href="[field:arcurl/]">[field:title/]</a>
    <span>[field:pubdate function="MyDate('Y-m-d', @me)"/]</span>
{/dede:arclist}

常用属性：

属性	说明	示例
`typeid`	指定栏目ID，多个ID用逗号隔开，调用子栏目需加 `typeid='top'`。	`typeid='1,3,5'`
`row`	调用文章数量。	`row='10'`
`infolen`	摘要长度，截取字符数。	`infolen='100'`
`orderby`	排序方式，默认为 `pubdate` (发布日期)，常用值：`hot` (点击量), `pubdate` (发布日期), `sortrank` (权重)。	`orderby='hot'`
`orderway`	排序方向。`desc` (降序), `asc` (升序)。	`orderway='desc'`
`channelid`	指定模型ID，默认为文章模型 `1`。	`channelid='1'`
`limit`	限制范围，格式为 `起始位置,数量`，如 `limit='0,5'` 表示从第0条开始，调用5条。	`limit='0,5'`

常用底层字段（配合 [field:字段名/] 使用）：

字段	说明	示例
`[field:title/]`		`<a href="[field:arcurl/]">[field:title/]</a>`
`[field:arcurl/]`	文章链接	`<a href="[field:arcurl/]">阅读全文</a>`
`[field:pubdate/]`	发布时间（时间戳）	`[field:pubdate function="MyDate('Y-m-d', @me)"/]`
`[field:description/]`	文章摘要	`[field:description/]`
`[field:litpic/]`	文章缩略图	`<img src="[field:litpic/]" alt="[field:title/]">`
`[field:click/]`	文章点击量	`<span>点击：[field:click/]</span>`
`[field:writer/]`	文章作者	`<span>作者：[field:writer/]</span>`

完整示例（首页调用最新5条带缩略图的文章）：

{dede:arclist row='5' titlelen='30' orderby='pubdate' orderway='desc'}
    <li>
        <a href="[field:arcurl/]" title="[field:title/]">
            <img src="[field:litpic/]" alt="[field:title/]">
        </a>
        <a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a>
        <span>[field:pubdate function="MyDate('m-d', @me)"/]</span>
    </li>
{/dede:arclist}

`{dede:field}` 字段标签详解

页或栏目页获取当前文档的特定信息。页常用字段：**

字段	说明	示例
`{dede:field.title/}`	当前文章的标题	`<title>{dede:field.title/} - {dede:global.cfg_webname/}</title>`
`{dede:field.pubdate function="MyDate('Y-m-d H:i:s', @me)"/}`	当前文章的发布时间	发布时间：{dede:field.pubdate function='MyDate("Y-m-d",@me)'/}
`{dede:field.description/}`	当前文章的摘要	`<meta name="description" content="{dede:field.description/}" />`
`{dede:field.body/}`	当前文章的正文内容	`{dede:field.body/}`
`{dede:field.keywords/}`	当前文章的关键词	`<meta name="keywords" content="{dede:field.keywords/}" />`
`{dede:field.source/}`	当前文章的来源	来源：{dede:field.source/}
`{dede:field.click/}`	当前文章的点击量	点击：{dede:field.click/}
`{dede:field.arcurl/}`	当前文章的链接	`<a href="{dede:field.arcurl/}">本文链接</a>`

栏目页常用字段：

字段	说明	示例
`{dede:field.seotitle/}`	栏目的SEO标题	`<title>{dede:field.seotitle/}</title>`
`{dede:field.description/}`	栏目的描述	`<meta name="description" content="{dede:field.description/}" />`
`{dede:field.typename/}`	栏目的名称	`<h1>{dede:field.typename/}</h1>`

高级及常用标签

文章页相关标签

说明	示例
`{dede:prenext get='pre'/}`	上一篇	`{dede:prenext get='pre'/}`
`{dede:prenext get='next'/}`	下一篇	`{dede:prenext get='next'/}`
`{dede:include filename='head.htm'/}`	引入头部文件	常用于模板结构
`{dede:include filename='footer.htm'/}`	引入底部文件	常用于模板结构
`{dede:likearticle}`	相关文章，调用与当前文章同栏目的其他文章。	`{dede:likearticle row='8' titlelen='30'}<a href="[field:arcurl/]">[field:title/]</a>{/dede:likearticle}`

搜索表单标签

说明	示例
`{dede:global name='keyword'/}`	获取搜索关键词	搜索“{dede:global name='keyword'/}”的结果
`{dede:search}`	生成搜索框	`<form action="{dede:global.cfg_cmsurl/}/plus/search.php" method="get"> <input type="text" name="q" value="{dede:global name='keyword'/}"> <button type="submit">搜索</button> </form>`

其他实用标签

说明	示例
`{dede:flink}`	友情链接	`{dede:flink type='text' row='24'/}` (文字链接)
`type`	友情链接类型：`text` (文字), `image` (图片), `self` (自定义)。
`{dede:myad}`	广告	`{dede:myad name='topbanner'/}` (需要在后台广告管理中创建名为'topbanner'的广告位)
`name`	广告位的名称。

自定义函数

在 arclist 和 field 标签中，经常使用 function 属性来对字段值进行格式化处理。

语法： function="函数名(参数, @me)"

@me 代表当前字段的原始值。

常用函数示例：

日期格式化：MyDate()
- {dede:field.pubdate function="MyDate('Y-m-d H:i:s', @me)"/} 将时间戳格式化为 2025-10-27 15:30:00
截取字符串：cn_substr()
- {dede:field.title function="cn_substr(@me, 20)"/} 截取标题前20个字符。
去除HTML标签：htmlspecialchars()
- {dede:field.description function='htmlspecialchars(@me)'/} 显示纯文本摘要。
判断并输出：if
- {dede:field.click runphp='yes'} if(@me > 1000) @me = '<span style="color:red;">热门</span>'; else @me = ''; {/dede:field.click}
- 如果点击量大于1000，则显示“热门”标签。

总结与技巧

区分页面类型：首先要明确你正在编辑的是什么页面（首页、列表页、内容页、自定义页面）,因为不同页面可用的标签不同。
- 首页：多用 {dede:arclist}, {dede:channel}。
- 列表页：多用 {dede:arclist}, {dede:pagelist}。
- 内容页：多用 {dede:field}。
- 自定义页面：和首页类似，多用 {dede:arclist}。
善用底层字段：{dede:arclist} 和 {dede:channelartlist} 等标签必须配合其底层字段（如 [field:title/]）才能输出具体内容。
调试方法：如果标签不生效,最简单的调试方法是：
- 检查标签拼写是否正确。
- 检查标签属性是否正确（如 typeid 是否存在）。
- 在模板中直接写死一个值，看页面是否正常显示,以排除其他CSS或JS的干扰。
- 查看织梦后台的“模板” -> “模板管理”,确保模板文件已正确更新。
官方文档：织梦官方文档是最权威的参考资料，如果遇到更复杂的需求,可以查阅官方手册。

希望这份详细的标签指南能帮助您更好地使用织梦CMS进行网站开发！