新手必看!DedeCMS 模板标签分类全解析

刚接触 DedeCMS 的朋友是不是经常被各种模板标签搞得晕头转向?别担心!今天就把这些标签掰开了、揉碎了讲清楚,从核心文件夹到具体用法全都有,保证一看就懂!

一、先搞明白:模板标签的两大类型

之前我们提到过,DedeCMS 的模板引擎有两种类型:编译式解析式,模板标签也因此分成了两类:
解析式标签:这是平时用得最多的一类!主要负责内容管理和生成网页,它们都存放在网站根目录下的/include/taglib文件夹里,不管是制作模板还是后期维护,都离不开它,是今天讲解的重点!
编译式标签:主要用来实现互动功能,比如用户登录、提交表单等等,相关文件也在同一个文件夹里,我们后面再详细介绍。

二、按使用场景分类!再也不怕用错标签

DedeCMS 的网页有封面页、列表页、内容页等等,模板标签也根据 “能用在哪些页面” 分成了 4 大类。记住这个分类,做模板的时候能少踩 90% 的坑!

1.全局标签:哪里都能用

特点:不管是封面页、列表页还是内容页,这些标签在前台所有页面都能使用!
常用标签举例
{dede:arclist}:生成文章列表的神器!可以指定调用哪个栏目、多少篇文章,新手一定要学会!
plaintext

  1. {dede:arclist typeid='1' row='10'}
  2. <li><a href='[field:arcurl/]'>[field:title/]</a></li>
  3. {/dede:arclist}

{dede:channel}:专门用来生成栏目导航!不管是一级栏目还是二级栏目链接,用它就能轻松搞定网站导航。
{dede:sql}:适合有数据库基础的朋友!可以直接写 SQL 语句来调取数据,功能超强大!

2.列表标签:只在列表页能用

特点:只能用在*_list.htm这类模板文件里,比如栏目列表页、搜索结果页。
常用标签举例
{dede:list}:专门为列表页设计的标签!和 arclist 功能类似,但更贴合列表页的使用逻辑,还能自动识别当前栏目 ID。
{dede:pagelist}:分页必备!用来生成 “上一页”“下一页”“页码” 这些按钮,记得要和 list 标签搭配使用哦~
plaintext

  1. {dede:pagelist listitem='index,pre,pageno,next,end' listsize='5'/}

3.内容标签:只能用在内容页

特点:只能用在*_article.htm这类模板文件里,比如文章详情页、产品详情页。
常用标签举例
{dede:likearticle}:自动生成 “相关文章”!根据当前文章的标签或所属栏目,推荐相似内容,能有效提高用户浏览时长。
{dede:pagebreak}:长文章分页神器!文章太长?加个这个标签,页面立马变得简洁清爽~
plaintext

  1. 正文内容...{dede:pagebreak/}接下来的内容...

4.模块标签:特定功能专用

特点:只在特定的功能模块或插件里才能用,比如商城模块、会员系统等等。
举例
商城插件可能会用到{dede:shop_goods}标签,专门用来调取商品价格、库存信息;
会员系统可能会用到{dede:member_info}标签,用来显示用户登录状态、积分等信息。
💡 提醒:这类标签一定要参考对应模块的使用说明,千万不能乱用!

三、新手避坑指南:标签格式别写错!

像 arclist、foreach 这类有开始和结束标记的标签,必须成对使用:
plaintext

  1. {dede:arclist}...{/dede:arclist}

而像 global、field 这类单标签,要在末尾加上/
plaintext

  1. {dede:global name='cfg_webname'/}

如果用错了标签的使用页面,比如在内容页强行使用列表标签,大概率会报错!一定要记住:每个标签都有规定的使用页面,不能乱用!

四、总结:一张表记住标签分类

分类 使用页面 常用标签举例 典型使用场景
全局标签 所有前台页面 arclist、channel 首页轮播图、导航栏
列表标签 *_list.htm模板 list、pagelist 栏目列表页、搜索结果页
内容标签 *_article.htm模板 likearticle、pagebreak 文章详情页、产品详情页
模块标签 特定功能模块或插件 shop_goods、member_info 商城商品列表、会员中心

这下清楚了吧!记住这四大类标签的使用场景,以后做模板再也不用担心用错标签了!下次做模板直接对照这张表,效率直接翻倍!如果还有哪个标签不会用,欢迎在评论区留言,手把手教你写代码!赶紧收藏这篇文章,以后做模板随时都能查!