【discuz】discuz模板语法

Discuz! X 模板的解析主要是 ./source/class/class_template.php 文件解析处理的，如果需要深入了解请可以看看这个文件！

1. 模板嵌套语法

   将被嵌套模板内容解析为 PHP 语句并合并入本模板中的写法
   <!--{subtemplate common/header}-->
   common/header 对应某个模板套系中的 common 目录的 header.html 模板文件
   
   程序运行时include嵌套模板内容
   <!--{template common/header}-->
   注释：当模板中有较多 loop 时，尽量用 subtemplate
   

2. 逻辑判断 if...else

   1. 如果写在 HTML 表单元素中，可以省去使代码更清晰易读，如{if $my_var}xxx{/if}
      <!--{if $_G['uid']}--> 任意html语句 <!--{/if}-->//如果是在对html标签某个属性值做判断时显得尤为重要，如果在标签之外的话，最好加上<!-- -->注释符号
      
      
   2. 带有分支条件的 if 写法
      <!--{if $_G['uid']}--> 任意 html 语句 <!--{elseif $_G[connectguest]}--> 任意html语句 <!--{/if}-->
      
   3. 带有多条件的 if 写法，可使用 PHP 常规判断中的按位运算符等
      <!--{if empty($_G['forum']['picstyle']) && $_GET['orderby'] == 'lastpost' && empty($_GET['filter']) }-->
          任意 html 语句 
      <!--{/if}-->
      
   4. CSS 书写时也可以按条件进行判断设置设置例如：
      <td class="fl_g"{if $forumcolwidth} width="$forumcolwidth"{/if}> //正如上面所说,对html标签中属性值做判断的时候，可以省略注释符<!-- -->

3. 直接执行 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();?>

4. 直接输出变量，等同于 PHP 的 <?php echo $my_var; ?>, 花括号可以省略但不建议去掉。（模块程序处理后才能在这里调用）:

   <div id="anc"><ul id="ancl">$announcements</ul></div>//一般情况下输出的内容不是简单的变量
   <!--{echo cutstr($group[lastpost][subject], 30)}--> //使用条件：1-变量需经函数处理  2-输出的是变量,不能是数组

5. 广告的嵌入点代码：

   <!--{ad/headerbanner/wp a_h}--> //这是discuz内嵌广告,建议大家自定义广告位,自定义的广告位在后台会自动生成调用代码，我们只需要粘贴复制即可

6. 插件的钩子标签：

   <!--{hook/global_usernav_extra2}-->
   hook为关键词，意为将index_top定义为钩子

7. 循环语法（可以多重循环）

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

8. DIY 区域和后台数据调用标签:

   <!--[diy=diy1]--><div id="diy1" class="area"></div><!--[/diy]-->  //尽量避免使用discuz的diy功能，因为维护大家很大，可直接通过后台自定义模块或模块代码
   {block XXX｝ （数据调用模块）

9. Discuz! 语言包加载后，模板文件中的使用：

   {lang forum_category_modedby}
   其中语言包在 ./source/language/目录下，以PHP数组形式存放