Discuz! X 模板的解析主要是 ./source/class/class_template.php 文件解析处理的,如果需要深入了解请可以看看这个文件!
-
模板嵌套语法
将被嵌套模板内容解析为 PHP 语句并合并入本模板中的写法注释:当模板中有较多 loop 时,尽量用 subtemplate
<!--{subtemplate common/header}-->
common/header 对应某个模板套系中的 common 目录的 header.html 模板文件
程序运行时include嵌套模板内容
<!--{template common/header}--> -
逻辑判断 if...else
- 如果写在 HTML 表单元素中,可以省去使代码更清晰易读,如{if $my_var}xxx{/if}
<!--{if $_G['uid']}--> 任意html语句 <!--{/if}-->//如果是在对html标签某个属性值做判断时显得尤为重要,如果在标签之外的话,最好加上<!-- -->注释符号 - 带有分支条件的 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}> //正如上面所说,对html标签中属性值做判断的时候,可以省略注释符<!-- -->
- 如果写在 HTML 表单元素中,可以省去使代码更清晰易读,如{if $my_var}xxx{/if}
-
直接执行 PHP 代码标签:
<!--{eval echo $my_var;}--> //相当于 <?php echo $my_var;?>
<!--{eval $my_arr = array(1, 2, 3);}--> //相当于 <?php $my_arr=array(1,2,3);?>
<!--{eval print_r($my_arr);}--> //相当于<?php print_r($my_arr);?>
<!--{eval output();}--> //相当于<?php output();?>
<!--{eval exit();}--> //相当于 <?php exit();?> -
直接输出变量,等同于 PHP 的 <?php echo $my_var; ?>, 花括号可以省略但不建议去掉。(模块程序处理后才能在这里调用):
<div id="anc"><ul id="ancl">$announcements</ul></div>//一般情况下输出的内容不是简单的变量
<!--{echo cutstr($group[lastpost][subject], 30)}--> //使用条件:1-变量需经函数处理 2-输出的是变量,不能是数组 -
广告的嵌入点代码:
<!--{ad/headerbanner/wp a_h}--> //这是discuz内嵌广告,建议大家自定义广告位,自定义的广告位在后台会自动生成调用代码,我们只需要粘贴复制即可 -
插件的钩子标签:
<!--{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]--> //尽量避免使用discuz的diy功能,因为维护大家很大,可直接通过后台自定义模块或模块代码
{block XXX}(数据调用模块) -
Discuz! 语言包加载后,模板文件中的使用:
{lang forum_category_modedby}
其中语言包在 ./source/language/目录下,以PHP数组形式存放