新手秒懂的Discuz模板调用标签汇总教程

一、 懒人必备：DIY 模块调用（想拖哪里拖哪里）

作用：给模板加可自定义的区域，后台「DIY 可视化编辑」时能直接拖组件，不用改代码

<!--[diy=diy1]--><div id="diy1" class="area"></div><!--[/diy]-->

• 白话解释：diy1 是这个模块的唯一 ID，随便改（比如 diy_header diy_footer），前后 ID 要一致

• 用法：把这段代码插在模板想加 DIY 区域的地方，后台就能直接往里面加轮播、文章列表

二、 核心高频：循环列表标签（批量展示数据必用）

基础循环结构

[loop]  <!-- 这里写循环内容，比如帖子标题、封面 -->
  <a href="{url}" {target}>{title}</a>
  <img src="{pic}" width="{picwidth}" height="{picheight}" />[/loop]

循环里的常用子标签（直接抄）

循环的高级玩法（个性化展示）

指定奇偶行样式：想让奇数行和偶数行长得不一样，用这两个标签

[loop]
  [order=odd]    <!-- 奇数行内容，比如加个灰色背景 -->
    <div style="background:#f5f5f5">{title}</div>
  [/order]
  [order=even]    <!-- 偶数行内容，默认白色背景 -->
    <div>{title}</div>
  [/order]
[/loop]

指定某一行的内容：比如只想改第 1 条数据的样式

[loop]
  [index=1]    <!-- 第1条数据专用样式，比如加个「推荐」标签 -->
    <div class="recommend">{title}</div>
  [/index]  <!-- 其他行用默认样式 -->
  {title}
[/loop]

控制链接打开方式：{target} 会自动识别后台设置，默认是新窗口打开（_blank）

<a href="{url}" {target}>{title}</a>

自定义封面图尺寸：不用手写宽高，直接用标签控制

<img src="{pic}" width="{picwidth}" height="{picheight}" />

三、 帖子专属：基础信息标签（帖子页必用）

四、 全站通用：网站配置与路径标签（不用记死链接）

五、 用户信息标签（显示登录用户的资料）

六、 其他实用标签

🌟 新手避坑小提示

1. 标签区分大小写吗？→ 模板标签不区分，但 $_G 这类变量要注意大小写，写错会不显示

2. 标签不生效怎么办？→ 后台开启「模板调试模式」，能看到标签对应的真实数据

3. {target} 是什么？→ 控制链接打开方式，后台 DIY 时可以设置「新窗口 / 当前窗口」打开

4. 循环标签用在哪？→ 帖子列表、文章推荐、用户榜单等需要批量展示数据的地方