bokee.net

软件工程师博客

正文 更多文章

discuz模板语法收罗

 Discuz! 的模板采用近似 PHP 表达式的语法,支持的元素如下:

  • <!–{ … }–>
    逻辑元素包围符,该符号用于包含条件和循环元素
    • 条件判断
      <!--{if expr1}-->
      statement1
      <!--{elseif expr2}-->
      statement2
      <!--{else}-->
      statement3
      <!--{/if}-->

      这 是一个典型的条件模板,当条件 expr1 为真时,显示模板 statement1 内容,否则当 expr2 为真时,显示模板 statement2 内容,否则显示模板 statement3 的内容。如同其他语言中的条件控制一样,其中 <!–{elseif expr}–> 和 <!–{else} –> 是非必须的。

    • 不带下标变量的数组循环
      <!--{loop $array $value}-->
      statement
      <!--{/loop}-->

      相当于 PHP 的数组循环语句:

      foreach($array as $value) {
      statement
      }
    • 带下标变量的数组循环
      <!--{loop $array $key $value}-->
      statement
      <!--{/loop}-->

      相当于 PHP 的数组循环语句:

      foreach($array as $key => $value) {
      statement
      }

      逻 辑元素包围符在 { } 外面包含了 html 的注释符号 <!– –>,除了为了和信息元素相区别外,也方便了使用 Dreamweaver 和 Frontpage 之类工具编辑模板的用户。因逻辑元素会被识别为 html 的注释而不被显示,对于绝大多数用户,逻辑元素中的内容是完全不需要修改的,甚至修改错一个字符就可能引起错误信息和整个系统无法运行。因此通常您在修改 模板的时候,不要修改模板的逻辑信息,更不要将逻辑信息内部元素(如 <!–{else}–> 等)的前后位置作以修改,否则可能会导致错误。如果您的模板被不慎修改损坏,请立即用原标准默认模板覆盖,即可恢复。

      对于高手而言,实际上外部的 <!– –> 是可以省略不写的,可以用于某些元素在模板中的定位,但强烈建议普通用户不要轻易尝试。

  • { … }
    信息元素包围符
    • {CONSTANT}
      可以引用界面替换变量,其中必须为大写字母,该符号实际的作用是引用 PHP 常量 CONSTANT,因此也可以通过它来引用其他的常量内容。
    • {lang variable}
      可 以在模板中引用语言变量 variable 的内容,语言变量经由 templates.php.lang 中数组 $language 定义。如 {lang post_edit} 的内容在编译模板的时候被替换为 $language['post_edit'] 的内容,简体中文版的意思是“编辑帖子”。
    • {template name}
      模板嵌入符,为了避免模板的冗长,可以使用本符号来将 name 模板的内容嵌入本模板中(实际上为引用)。
    • {eval statement}
      运行 PHP 语句体 statement。推荐只在特别必须的时候才使用该结构,因为它会破坏模板的结构和可读性。如 {eval echo ‘template!’;} 实现的功能为 echo ‘template’;
    • {LF}
      换行符,因为 Discuz! 模板引擎会忽略掉多余的换行(\n),这个符号用来成生需要的 \n。

我 们所推荐的模板修改方法:通过普通编辑器手工书写 html 或通过 Dreamweaver 或 Frontpage 修改。但是修改需切记,同一逻辑元素内或嵌套中元素的位置和内容切勿修改,即通常情况下,您不能把 <!–{}–> 包围的内容单独的移动,更不能删除。但是整个最外部逻辑结构是可以移动或删除的。

如果修改后模板所在页面在输出类似如下的错误信息 Parse error: parse error, unexpected ‘}’ in /home/username/forums/forumdata/templates/1_login.tpl.php on line 6,说明模板中出现了无法匹配,或格式错误的逻辑元素,请仔细检查是否有元素不对应,没有结束或嵌套损坏,格式错误的现象,必要时可以恢复原始模板来解决 问题。

Discuz! 提供了方便的界面打包程序,前面已对其格式做了介绍,将导出信息的内容粘贴到 系统设置 中 风格方案 中的 导入界面方案 中,执行即可。程序会自动解析数据内容,恢复相关的界面设置,自定义替换变量和所需的模板设置。如果被导出界面使用了非默认模板,必须将 ./templates 目录属性设置为 777,以便导入程序自动建立模板记录和文件夹。

定义变量说明

<?exit?>
<!–{eval $i=2}–>
<!–{if $i==1}–>
123
<!–{/if}–>

<!–{block name=”spaceblog” parameter=”notype/1/order/i.dateline,i.lastpost/limit/0,14/cachetime/900 /cachename/newti/tpl/data”}–><!–最新日志–>
<!–{eval $i=0;}–>
<!–{loop $_SBLOCK['newti'] $value}–>
<!–{if $i % 2 == 0}–>//如果i除以2的余数等于0
<div class=”listbg”><!–{else}–>
<div class=”listbg2″><!–{/if}–>
· [<span class="listA">$value[typename]</span>]<a
class=”listA” href=”$value[url]” title=”$value[subjectall]” target=”_blank”>$value[subject]</a></div>
<!–{eval $i++;}–>
<!–{/loop}–>

<!–{eval for ($i=1; $i<=5; $i++){ }–>

<!–{eval echo “Hello World!<br />”;}–>
<!–{eval}}–>

---------------------------------------------------------------------------------------------------------------------------------------------------------

从 Discuz! X2.5 开始,模板文件支持 PHP 扩展名的格式,主要功能是防止模板被别的论坛直接另存为盗取!


例如:template/default/common/header.htm
可创建为:template/default/common/header.php,模板文件为php后,代码书写方式不改变依然和以前一样采用HTML,PHP 的模板文件中你只需在原有 HTM 的模板文件开头添加一行代码即可,如:

  1. <?php exit;?>
复制代码

或者

  1. <?php echo '你不能看此模板的内容';exit;?>
复制代码

PHP 的模板文件的模板数据内容将从文件的第二行开始解析。PHP 和 HTM 模板文件同时存在时,会优先解析 PHP 模板文件。

二、模板中的变量

DiscuzX中有两种变量:
1、称为G变量:$_G[xxx]

G变量是程序的全局变量,为了让程序更加高效,减少不必要的数据获取,所以程序特将经常需要用到的变量统一到G变量下,如用户登录信息、后台设置信息、服务器环境信息、客户端CooKies、数据缓存等都存放在G变量里面,在制作模板的时候作者只需要将G变量打印出来即可获得需要的信息是否在G变量里面。

2、自定义变量:$xxx

自定义变量是以$开头首位为字母或下划线的自定义代码,如:$data、$thread、$post、$forumlist、$threadlist等等!
自定义变量是作者可以自己在程序里面自定义的,或程序自身已经定义了的。

三、变量数据在模板中的输出方式

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

2、自定义变量数据的循环代码书写格式:

  1. <!--{loop $data $key $value}-->
  2.      <li>$key $value</li>
  3. <!--{/loop}-->
复制代码

这段代码就是一段典型的循环代码,意思是将自定义变量$data进行循环,并将每次循环的数据传递给$value,$key是数组键值(序号),<!--{loop $data $key $value}--><!--{/loop}-->之间书写html代码。我们只需要记住这个简单却重要的意思!

打开template/default/forum/viewthread.htm,
这段代码就是帖子页的循环代码,通过上面的【自定义变量数据的循环代码书写格式】我们应该可以大致了解到这个循环代码。$postlist变量中存放了当前访问帖子的主题信息、回复楼层信息,通过循环,将每个楼层的数据传递给$post变量。
循环的HTML代码存放在template/default/forumviewthread_node.htm,打开这个文件后可以看见里面的很多变量名都是$post,例如:$post['authorid'] = 作者UID、$post['username']=作者用户名等等,通过$post[xxx]不同的字段信息输出相应的数据,这些字段信息都在数据库-数据表pre_forum_post存放着。

经常发现很多童鞋将$post[xxx]变量放到其他模板文件中去用,结果刷新出来的结果什么都没有!

原因是:每个模板文件都有一个对应的php程序文件,所以自定义变量不能在不同的页面中使用,只限于定义了变量的模板文件中使用。例如帖子列表页的帖子数据是不能在论坛首页或其他页面输出的等。

四、条件判断

1、通过if判断流程分支

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

  1. <!--{if $my_var}-->
  2.     任意html语句
  3. <!--{/if}-->
复制代码

2、带有多条件的if写法,可使用PHP常规判断中的按位运算符等

  1. <!--{if $my_var && ($my_var2 & 1 || $my_var3 == 3)}-->
  2.     任意html语句
  3. <!--{/if}-->
复制代码

3、带有分支条件的if写法

  1. <!--{if $my_var == 1}-->
  2.     变量为1
  3. <!--{elseif $my_var == 2}-->
  4.     变量为2
  5. <!--{else}-->
  6.     其他情况
  7. <!--{/if}-->
复制代码

五、模板嵌套

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

比如:template/default/forum/viewthread.htm中可以找到:<!--{subtemplate forum/viewthread_node}-->
这个代码的意思是在这个代码的位置载入另外一个模板文件:template/default/forum/viewthread_node.htm,
当我们打开这个文件后发现还有一段载入代码:<!--{subtemplate forum/viewthread_node_body}-->
这个代码的位置载入另外一个模板文件:template/default/forum/viewthread_node_body.htm,
这就是DiscuzX的模板文件N次嵌套!

我们首先要清楚的理解各个模板文件是做什么用的,就知道这些嵌套的意思:
template/default/forum/viewthread.htm 帖子内容页主模板,这个模板文件是帖子内容页处理程序加载的
template/default/forum/viewthread_node.htm 帖子内容页楼层模板文件,这个模板文件循环一次就是一个楼层
template/default/forum/viewthread_node_body.htm 帖子内容页,帖子内容模板,这个模板文件是专门用于处理帖子内容的



这种嵌套方式是便于以后的代码修改,比如我只想修改帖子内容的代码,就只需要编辑viewthread_node_body.htm,而不用把另外两个文件都编辑,这个在模板创建的方法里面已经说过。

六、插件钩子

  1. <!--{hook/index_top}-->
复制代码

hook为关键词,意为将index_top定义为钩子,插件钩子的作用在于能让插件在指定的一些位置输出有关代码!

Discuz! X模板的解析工作主要是经过./source/class/class_template.php文件解析处理的,如果你懂想研究下他是如何解析的可以研究下这个文件!

  1. 模板嵌套语法

    将被嵌套模板内容解析为PHP语句并合并入本模板中的写法
    <!--{subtemplate common/header}-->
    common/header 对应某个模板套系中的common目录的header.htm模板文件

    程序运行时include嵌套模板内容
    <!--{template common/header}-->
    注释:当模板中有一些loop时,尽量用subtemplate

  2. 逻辑判断if...else

    1. 如果写在HTML表单元素中,可以省去使代码更清晰易读,如{if $my_var}xxx{/if}
      <!--{if $_G['uid']}--> 任意html语句 <!--{/if}-->

    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}>
  3. 直接执行php代码标签:

    <!--{eval echo $my_var;}-->
    <!--{eval $my_arr = array(1, 2, 3);}-->
    <!--{eval print_r($my_arr);}-->
    <!--{eval output();}-->
    <!--{eval exit();}-->
  4. 直接输出变量,等同于php的 <?php echo $my_var; ?>, 花括号可以省略但不建议去掉。(模块程序处理后才能在这里调用):

    <div id="anc"><ul id="ancl">$announcements</ul></div>
    <!--{echo cutstr($group[lastpost][subject], 30)}-->
  5. 广告的嵌入点代码:

    <!--{ad/headerbanner/wp a_h}-->
  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]-->
    {block XXX}(数据调用模块)
  9. discuz语言包加载后,模板文件中的使用:

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

 

转自:

http://www.zhanhelp.com/discuz/dx25/template/syntax/syntax_index.htm

http://www.zhanhelp.com/thread-5590-1-1.html

http://www.cnblogs.com/xiaochaohuashengmi/archive/2010/06/09/1754724.html

 

 

 

 

 

 

分享到:

上一篇:css hack整理:区别FF,IE

下一篇:Discuz G变量注解 【转】

评论 (0条) 发表评论

抢沙发,第一个发表评论
验证码