Skip to main content

Documentation Index

Fetch the complete documentation index at: https://discuz.p.cafe/llms.txt

Use this file to discover all available pages before exploring further.

​
前言

在设计模板之初，您需要详细了解一下模板解析语法，以进行模板制作实战。语法示例中，变量可根据实际情况使用，本处仅使用变量$my_var、数组$my_arr进行演示。

​
PHP中使用template()函数显示已存在模板

在Discuz!程序执行中可以通过 include template('模板文件夹/模板名称无后缀'); 的方式进行解析，前提是您使用的Discuz!程序已经包含了 ./source/function/function_core.php 的函数库。

​
PHP格式的模板

从 Discuz! X2.5 开始，模板文件支持 PHP 扩展名的格式，你可以创建例如 ./template/mytext/common/forum/discuz.php 文件。PHP 的模板文件中你只需在原有 HTM 的模板文件开头添加一行代码即可： 
<?php exit;?>
或者： 
<?php echo '你不能看此模板的内容';exit;?>
PHP 的模板文件的模板数据内容将从文件的第二行开始解析。PHP 和 HTM 模板文件同时存在时，会优先解析 PHP 模板文件。

​
模板语法

​
变量输出

输出一个变量的值，等同于php的 <?php echo $my_var;?>，花括号可以省略但不建议去掉。 
{$my_var}

​
条件判断

通过if判断流程分支。如果写在HTML表单元素中，可以省去注释符使代码更清晰易读： 
<!--{if $my_var}-->
  任意html语句
<!--{/if}-->
带有多条件的if写法，可使用PHP常规判断中的按位运算符等： 
<!--{if $my_var && ($my_var2 & 1 || $my_var3 == 3)}-->
  任意html语句
<!--{/if}-->
带有分支条件的if写法： 
<!--{if $my_var == 1}-->
  变量为1
<!--{elseif $my_var == 2}-->
  变量为2
<!--{else}-->
  其他情况
<!--{/if}-->

​
循环输出

带有数组键的循环写法： 
<!--{loop $my_arr $key $val}-->
  循环输出的HTML语句
<!--{/loop}-->
没有数组键的循环写法： 
<!--{loop $my_arr $val}-->

​
模板嵌套

将被嵌套模板内容解析为PHP语句并合并入本模板中的写法。common/header 对应某个模板套系中的common目录的header模板文件： 
<!--{subtemplate common/header}-->
程序运行时include嵌套模板内容： 
<!--{template common/header}-->

​
插件钩子

在模板中设立插件钩子，hook为关键词，意为将index_top定义为钩子： 
<!--{hook/index_top}-->

​
变量数组嵌套使用

条件判断或变量输出时用到： 
<!--{if $my_arr[$my_var]}-->
<!--{if $my_arr[0]}-->
<!--{if $my_arr[$my_arr2[$my_var]]}-->

​
PHP解析

在模板中使用PHP语句可以通过eval进行： 
<!--{eval $my_var = 1;}-->
<!--{eval echo $my_var;}-->
<!--{eval $my_arr = array(1, 2, 3);}-->
<!--{eval print_r($my_arr);}-->
<!--{eval output();}-->
<!--{eval exit();}-->
多行PHP解析(Discuz! X3 新增)： 
<!--{eval}-->
...PHP语句...
<!--{/eval}-->

​
语言包使用

在模板中可以通过下面的代码来使用语言包中的某个值： 
{lang index_yesterday}
其中语言包在 ./source/language/目录下，以PHP数组形式存放。

​
综合示例

​
示例1：循环数组并根据奇偶行显示不同CSS样式

PHP端代码： 
<?php
  /*此处省略include class_core.php*/
  $my_arr = array('one', 'two', 'three', 'four');
  include template('forum/mytest'); //使用自定义模板套系中的forum目录的mytest
?>
模板代码： 
<!--{loop $my_arr $key $val}-->
  <div {if $key % 2 == 1}style="background: #ccc;"{/if}>
    这里是value值：{$val}
  </div>
<!--{/loop}-->

​
示例2：结合风格常量与javascript动态改变字体大小

默认风格中，小号字体大小 SMFONTSIZE为0.83em，主题列表字体大小 THREADTITLEFONTSIZE为14px。在Discuz!X2中使用时，需要使用$_G['style']['SMFONTSIZE']和$_G['style']['THREADTITLEFONTSIZE']。 ./template/mytest/forum/mytest 模板代码如下： 
<!--{subtemplate common/header}-->
<div id="test1" style="font-size:{$_G['style']['FONTSIZE']};">
  这是一个改变字体的实例
</div>
<span onclick="changefontsize('{$_G['style']['SMFONTSIZE']}');">改变小号字</span>
<span onclick="changefontsize('{$_G['style']['THREADTITLEFONTSIZE']}');">改变为大号字</span>
<script type="text/javascript">
function changefontsize(size) {
  $('test1').style.fontSize = size;
}
</script>
<!--{subtemplate common/footer}-->