Discuz!开发之模板标签语法学习

时间:2022-05-26 21:13:16

一、加载模板

使用template()函数显示已存在模板:

在Discuz!程序执行中可以通过 include template('模板文件夹/模板名称无后缀');的方式进行解析!

template()函数定义于./source/function/function_core.php

Discuz!模板的解析逻辑定义于./source/class/class_template.php

如果需要深入了解请可以看看这两个文件!

二、模板嵌套语法

将被嵌套模板内容解析为 PHP 语句并合并入本模板中的写法

<!--{subtemplate common/header}-->

或者

<!--{template common/header}-->

common/header 对应某个模板套系中的 common 目录的 header.htm 模板文件

提示:当模板中有较多 loop 时,尽量用 subtemplate

三、逻辑判断 if...else

如果写在 HTML 表单元素中,可以省去使代码更清晰易读,如{if $my_var}xxx{/if}

<!--{if $_G['uid']}--> 任意html语句 <!--{/if}-->

带有分支条件的 if 写法

<!--{if $_G['uid']}--> 任意 html 语句 <!--{elseif $_G[connectguest]}--> 任意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[lastpost][subject], 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区域和后台数据调用标签:

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

{block XXX}(数据调用模块)

十、Discuz!语言包加载后,模板文件中的使用:

{lang forum_category_modedby}

其中语言包在 ./source/language/目录下,以PHP数组形式存放