uchome 模板

模板的位置

模板解析函数是调用/source目录下的function_template.php文件中的parse_template函数来实现的。

解析过程并不复杂，主要是读取模板文件(.htm)，用正则表达式替换标记为对应的PHP代码，最终生成一个标准的PHP文件，保存到模板缓存目录/data/tpl_cache/供后续使用。

uchome 模板在 template/default 目录里 ，修改模板后不会马上生效，需要去后台清空缓存文件或者手动去FTP删除data\tpl_cache 删除相关文件。

缓存文件在 data\tpl_cache 文件名是:template_模板目录名_模板文件名.php

后台的模板在admin/admin/tpl     解析后的文件同样在data\tpl_cache目录

template_tpl名_模板文件名.php

这里提供一种方法，可以使修改模板文件后，不用手动删除缓存的模板文件就能直接看到修改结果。方法为修改/source/function_common.php中的代码

if(!file_exists($objfile)) {

改为

if(!file_exists($objfile)||filemtime($objfile)<filemtime(S_ROOT.'./'.$tpl.'.htm')) {

即可。

因为此方法增加了一次对文件系统的访问，一定程度上会影响性能，所以此处的修改只建议运用在调试服务器上。


模板的语法

1、调用其他模板

<!--{template footer}-->

说明：将以模板header.htm来替换此处的代码

2、调用头像

<!--{avatar($value[uid],small)}-->

<?php echo avatar($value[uid],small); ?>

3、调用广告

<!--{ad/header}-->

解析后的代码：

<?php adshow('header'); ?>

4、调用时间

模板代码

<!--{date('Y-m-d H:i', $value[dateline], 1)}-->

解析后的代码：

<?php echo sgmdate('Y-m-d H:i', $value[dateline], 1); ?>

5、输出PHP代码

模板代码：

<!--{eval echo formhash();}--> eval 就是执行php代码

解析后的代码：

<?php echo formhash(); ?>

说明：<!�C{eval和}�C>之间的是需要执行的PHP代码，要求语句完整。

6、调用变量

模板代码：

<a href="space.php?uid=$value[uid]">{$_SN[$value[uid]]}</a>

解析后的代码：

<a href="space.php?uid=<?=$value['uid']?>"><?=$_SN[$value['uid']]?></a>

说明：{和}之间的是需要输出的变量。

7、选择输出逻辑

模板代码：

<!--{if empty($mtag['ismember']) &amp;&amp; $mtag['joinperm'] < 2}-->
<li><a href="cp.php?ac=mtag&amp;op=join&amp;tagid=$mtag[tagid]" id="a_mtag_join_$mtag[tagid]" this.id, 99999)">加入群组</a></li>
<!--{elseif $mtag['allowpost']}-->
<li><a href="cp.php?ac=thread&amp;tagid=$mtag[tagid]">发起话题</a></li>
<!--{/if}-->

解析后的代码：
<?php if(empty($mtag['ismember']) &amp;&amp; $mtag['joinperm'] < 2) { ?>
<li><a href="cp.php?ac=mtag&amp;op=join&amp;tagid=<?=$mtag['tagid']?>" id="a_mtag_join_<?=$mtag['tagid']?>" this.id, 99999)">加入群组</a></li>
<?php } elseif($mtag['allowpost']) { ?>
<li><a href="cp.php?ac=thread&amp;tagid=<?=$mtag['tagid']?>">发起话题</a></li>
<?php } ?>

说明：当然这里可以没有elseif，其语法有点类似VB，需要有结尾符。

8、循环输出逻辑

模板代码 ：
<!--{loop $list $key $value}-->
<tr <!--{if $key%2==1}--><!--{/if}-->>
<td>
<!--{if $value[displayorder]}--> [顶] <!--{/if}-->
<!--{if $value[digest]}--> [精] <!--{/if}-->
<a href="space.php?uid=$value[uid]&amp;do=thread&amp;id=$value[tid]">$value[subject]</a></td> <td><a href="space.php?uid=$value[uid]">{$_SN[$value[uid]]}</a><br>$value[replynum]/$value[viewnum]</td> <td><a href="space.php?uid=$value[lastauthorid]" title="{$_SN[$value[lastauthorid]]}">{$_SN[$value[lastauthorid]]}</a><br><!--{date('m-d H:i',$value[lastpost],1)}--></td>
</tr>
<!--{/loop}-->

解析后的代码：

<?php if(is_array($list)) { foreach($list as $key => $value) { ?>
<tr <?php if($key%2==1) { ?><?php } ?>>
<td>
<?php if($value['displayorder']) { ?> [顶] <?php } ?>
<?php if($value['digest']) { ?> [精] <?php } ?>
<a href="space.php?uid=<?=$value['uid']?>&amp;do=thread&amp;id=<?=$value['tid']?>"><?=$value['subject']?></a></td>
<td><a href="space.php?uid=<?=$value['uid']?>"><?=$_SN[$value['uid']]?></a><br><?=$value['replynum']?>/<?=$value['viewnum']?></td>
<td><a href="space.php?uid=<?=$value['lastauthorid']?>" title="<?=$_SN[$value['lastauthorid']]?>"><?=$_SN[$value['lastauthorid']]?></a><br><?php echo sgmdate('m-d H:i',$value[lastpost],1); ?></td>
</tr>
<?php } } ?>

说明：loop后跟三个参数时，第一个参数是用于循环的数组，第二个和第三个参数分别是对数组中每一项循环时项的键名和值。

说明：loop后跟两个参数时，第一个参数是用于循环的数组，第二个参数是对数组中每一项循环时项的值。