Discuz!开发之模板标签语法学习
一、加载模板
使用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数组形式存放