婷姐 发表于 2023-5-30 20:17:50

Discuz 模版标签语法集锦

Discuz! X模板的解析工作主要是经过./source/class/class_template.php文件解析处理的,如果你懂想研究下他是如何解析的可以研究下这个文件!

模板嵌套语法
将被嵌套模板内容解析为PHP语句并合并入本模板中的写法
<!--{subtemplate common/header}-->
common/header 对应某个模板套系中的common目录的header.htm模板文件

程序运行时include嵌套模板内容
<!--{template common/header}-->

逻辑判断if...else
如果写在HTML表单元素中,可以省去使代码更清晰易读,如{if $my_var}xxx{/if}
<!--{if $_G['uid']}--> 任意html语句 <!--{/if}-->

带有分支条件的if写法
<!--{if $_G['uid']}--> 任意html语句 <!--{elseif $_G}--> 任意html语句 <!--{/if}-->

带有多条件的if写法,可使用PHP常规判断中的按位运算符等
<!--{if empty($_G['forum']['picstyle']) && $_GET['orderby'] == 'lastpost' && empty($_GET['filter']) }-->
    任意html语句
<!--{/if}-->

css书写时也可以按条件进行判断设置设置例如:
<td class="fl_g"{if $forumcolwidth} width="$forumcolwidth"{/if}>




直接执行php代码标签:
<!--{eval echo $my_var;}-->
<!--{eval $my_arr = array(1, 2, 3);}-->
<!--{eval print_r($my_arr);}-->
<!--{eval output();}-->
<!--{eval exit();}-->

直接输出变量,等同于php的 <?php echo $my_var; ?>, 花括号可以省略但不建议去掉。(模块程序处理后才能在这里调用):
<div id="anc"><ul id="ancl">$announcements</ul></div>
<!--{echo cutstr($group, 30)}-->

广告的嵌入点代码:
<!--{ad/headerbanner/wp a_h}-->

插件的钩子标签:
<!--{hook/global_usernav_extra2}-->
hook为关键词,意为将index_top定义为钩子

循环语法(可以多重循环)
带有数组键的循环写法
<!--{loop $my_arr $key $val}-->
    循环输出的HTML语句
<!--{/loop}-->
没有数组键的循环写法
<!--{loop $_G['setting']['navs'] $nav}-->
    循环输出的HTML语句
<!--{/loop}-->

diy区域和后台数据调用标签:
<!----><div id="diy1" class="area"></div><!---->
{block XXX}(数据调用模块)

discuz语言包加载后,模板文件中的使用:
{lang forum_category_modedby}
其中语言包在 ./source/language/目录下,以PHP数组形式存放

夜色清泉 发表于 2023-6-8 17:54:43


这东西我收了!谢谢楼主!

Discuz智能体 发表于 2025-3-17 05:57:43

在Discuz! X的模板开发中,模板标签语法是非常重要的一部分,它允许开发者在模板文件中嵌入逻辑、循环、条件判断、变量输出等功能。以下是一些常用的Discuz! X模板标签语法集锦,帮助你更好地理解和开发Discuz!模板。

### 1. 模板嵌套语法
在Discuz!模板中,可以通过`{template}`标签来嵌套其他模板文件。例如:

{template common/header}

这行代码会将`common/header.htm`模板文件的内容嵌入到当前模板中。`common/header`对应的是模板套系中`common`目录下的`header.htm`文件。

### 2. 逻辑判断 `if...else`
在模板中可以使用`{if}`标签来进行条件判断。例如:

{if $my_var}
    <p>变量 $my_var 为真</p>
{else}
    <p>变量 $my_var 为假</p>
{/if}

如果`$my_var`为真,则输出第一个`<p>`标签中的内容,否则输出第二个`<p>`标签中的内容。

### 3. 带有分支条件的`if`写法
你可以使用`{elseif}`来进行多条件判断:

{if $my_var == 1}
    <p>变量 $my_var 等于 1</p>
{elseif $my_var == 2}
    <p>变量 $my_var 等于 2</p>
{else}
    <p>变量 $my_var 不等于 1 或 2</p>
{/if}

### 4. 带有多条件的`if`写法
你可以使用PHP中的逻辑运算符来进行复杂的条件判断:

{if $my_var > 1 && $my_var < 10}
    <p>变量 $my_var 在 1 和 10 之间</p>
{/if}

### 5. CSS书写时按条件判断
你可以在CSS中使用条件判断来动态设置样式:

<style>
    .my-class {
      {if $my_var}color: red;{/if}
    }
</style>

### 6. 直接执行PHP代码
你可以使用`{eval}`标签来直接执行PHP代码:

{eval echo date('Y-m-d H:i:s');}

### 7. 直接输出变量
你可以使用`{$var}`来直接输出变量:

<p>公告内容:{$announcements}</p>

### 8. 广告的嵌入点代码
在模板中嵌入广告可以使用以下代码:

<!--{ad/headerbanner}-->

### 9. 插件的钩子标签
你可以使用`{hook}`标签来定义钩子,插件可以通过这些钩子来插入自定义内容:

{hook/index_top}

### 10. 循环语法
你可以使用`{loop}`标签来遍历数组:

{loop $array $key $value}
    <p>键:{$key},值:{$value}</p>
{/loop}

如果不需要键值,可以简化为:

{loop $array $value}
    <p>值:{$value}</p>
{/loop}

### 11. DIY区域和后台数据调用标签
你可以使用`{block}`标签来调用后台数据模块:

{block data}
    <p>数据内容:{$data}</p>
{/block}

### 12. 语言包的使用
你可以使用`{lang}`标签来加载语言包中的文本:

<p>{lang forum_category_modedby}</p>

语言包文件通常位于`./source/language/`目录下,以PHP数组形式存放。

### 总结
以上是Discuz! X模板开发中常用的一些标签语法。通过这些标签,你可以在模板中实现复杂的逻辑、循环、条件判断等功能。如果你需要更深入的了解,可以参考Discuz!的开发手册,或者研究`./source/class/class_template.php`文件中的模板解析逻辑。

如果你有更多关于Discuz!模板开发的问题,欢迎随时提问!
-- 本回答由 人工智能 AI智能体 生成,内容仅供参考,请仔细甄别。
页: [1]
查看完整版本: Discuz 模版标签语法集锦