模板标签概述
微擎的模板文件本质上就是一个php文件,所以支持直接书写php代码,但是为了增加开发效率和非php人员的使用,微擎系统定了了一套类似于 Smarty 的模板引擎标签。
下面我们通过实例讲解一下微擎中的标签如何使用。
输出变量
{$foo}
输出标签是由一对花括号做为定界符的,不支持输出数组,相对于php中的 echo
<div class="user-head ellipsis">{$_W['fans']['nickname']}</div>
// 对等于
<div class="user-head ellipsis"><?php echo $_W['fans']['nickname']; ?></div>
判断语句
{if condition}
{elseif condition}
{else}
{/if}
条件选择分支
如果 $do 等于 record 则显示下面的卡券领取记录,否则显示查看卡券
{if $do == 'record'}
<li class="active"><a href="javascript:;">卡券领取记录</a></li>
{else}
<li class="active"><a href="javascript:;">查看卡券</a></li>
{/if}
if 和 elseif 配合使用
{if $dca['status'] == 1}
<span class="label label-success">未使用</span>
{elseif $dca['status'] == 2}
<span class="label label-warning">已失效</span>
{elseif $dca['status'] == 3}
<span class="label label-danger">已核销</span>
{elseif $dca['status'] == 4}
<span class="label label-default">已删除</span>
{else}
<span class="label label-default">全部</span>
{/if}
循环语句
{loop $result $key $value}
{/loop}
循环遍历语句,相当于PHP中的
foreach ($result as $key => $value) {
}
- $key 可以使用其它名称,将存储数组中每一成员的键值
- $value 可以使用其它名称,将存储数组中每一成员的值
循环一个数组用 loop 标签,与php中的 foreach 函数类似,第一个参数为数组的索引,第二个参数为数组第一项的值,只要标签成对匹配,模板中的标签是可以嵌套使用的。
{loop $list $index $item}
<tr>
<td>{$index}(显示数组的索引):</td>
<td>{$item['user']['nickname']}</td>
<td>
{if $item['follow'] == '1'}
<span class="label label-success">已关注 </span>
{elseif $item['unfollowtime'] <> '0'}
<span class="label label-warning" >取消关注 </span>
{else}
<span class="label label-danger">未关注 </span>
{/if}
</td>
</tr>
{/loop}
php语句
{php expression}
运行一个PHP原生代码,不支持多行php语句
- expression 符合PHP语法的表达式
由于某些时候需要使用一些php来输出内容,比如格式化时间戳为日期时,此写法并不支持多行php语句,例如:
<span class="help-block">{ php echo date('Y-m-d H:i:s', $row['followtime'])}</span>
或者
<?php
echo 1;
?>
引用模板
{template '$templatename'}
引用一个模板文件
- $templatename 模板名称或是路径+模板名称
在模板中如果需要引用其它模板文件可以使用以下的方法:
//模块中的使用方法,不需要添加目录信息
{template 'header'}
//系统的模板引用的方法,需要添加目录信息
{template 'common/header-base'}
创建URL
{url 'controller/action/do', (array)querystring}
创建一个微擎URL
- controller 控制器名称,URL中的 c= 值
- action URL中的a=值
- do URL中的do=值
- querystring URL中后面的querystring参数
定义URL时,与在php文件中的创建方法一样,具体使用如下:
<a href="{url 'extension/service/display'}" class="tile img-rounded"><i class="fa fa-glass"></i><span>常用服务</span></a>
<a href="{url 'home/welcome/ext' array('m' => $module['name'])}">模块 - {$module['title']}</a>
此标签并没有提供模块 $this→createMobileUrl('xx')
函数,在模块中的模板中请按以下方法创建:
echo $this->createMobileUrl('order')}
转义附件URL
{media imageurl}
转换一个图片地址为绝对地址
- imageurl 图片地址,可以是相对也可以绝对
微擎系统支持远程附件,如果你有用到图片或是附件请转义一下地址,具体使用如下:
<i style="background:url({media $nav['icon']}) no-repeat;"></i>
输出花括号
{##string##}
因为模板标签定界符是一对花括号,所以当你想输出一对花括号本身时可以使用以下方法:
{##$order##}
此时花括号和变量不会被转义。
模板数据调用
{data func="site_navs" index="" item="" assign="" return="true" limit="10" module="we7_demo"}
//循环体
{/data}
利用模板标签调用一些特定的数据
参数
名称 | 说明 |
---|---|
func | 调用标签的功能,也就是需要获取什么数据 |
item | 默认为row,使用:$row。指定循环体中数组值的变量,在循环体中可以过用此变量输出值 |
index | 默认为iteration,使用:$row[‘iteration’]。指定循环体中的索引参数,如果指定过item参数,则{item}[’{index}’] |
assign, return | 默认为false,这两个标签通常共同使用,指定是否直接返回值,还是直接循环输出,如果return为true时,则会直接把内容赋值给assign设置的参数中 |
limit | 默认为10,指定获取数据的条数 |
module | 如果模块中有扩展标签 func 则通过此参数传递模块名称 |
调用微站导航
获取当前微站的导航
{data func="site_navs" item="row"}
{$row['html']}
{/data}
获取当前微站第二个位置的导航
{data func="site_navs" section="1" item="row"}
第$row['iteration']个:{$row['html']}
{/data}
调用幻灯片
{data func="site_slide_search" item="row" limit="4"}
<li>Name: {$row['thumb']}</li>
{/data}
调用文章列表
{data func="site_article" cid=$cid return="true" assign="result"}
{loop $result['list'] $row}
<li>
<div class="info">
<h3>{$row['title']}</h3>
<p class="text">{$row['description']}</p>
</div>
<div class="pic">
<img src="{php echo tomedia($row['thumb'])}">
</div>
</li>
{/loop}
调用文章评论
{data func="site_article_comment" article_id="文章id" item="row" return="true" assign="result"}
{loop $result['list'] $comment}
<div class="message-list">
<div content="message-item">
<div class="message-content">
<img src="_ echo $comment['avatar']}" alt="" class="logo">
<div class="message-item-content">
<p class="name">_ echo $comment['username']}</p>
<p class="content">
_ echo $comment['content']}
</p>
<p class="time">
_ echo echo date('Y-m-d H:i:s', $comment['createtime']);}
</p>
</div>
</div>
{loop $comment['son_comment'] $son_comment}
<div class="reply-list">
<div class="reply-item">
<div class="head">
作者回复
</div>
<p class="content">
_ echo $comment['content']}
</p>
<p class="time">
_ echo date('Y-m-d H:i:s', $son_comment['createtime']);}
</p>
</div>
</div>
{/loop}
</div>
</div>
{/loop}
{$result['pager']}
注意:上面的只是伪代码,请不要复制粘贴,用模板的规则自己渲染即可
如果需要用户留言功能,请跳转至下面的页面
murl('site/site/comment', array('article_id' => $id))
调用分类列表
<div class="category">
{data func="site_category" parentid="$cid"}
<a href="{$row['linkurl']}">{$row['name']}</a>
{/data}
</div>
调用快捷菜单
{data func="site_quickmenu"}{/data}
模板中的一些常用变量
模板中提供了一些占位的变量,开发时根据需要可以在代码中定义这些变量,下面将说明有哪些变量
页面标题
$_W['page']['title'] = '定义此变量将会改变页面标题栏显示的内容';
微站名称
$_W['page']['sitename'] = '微站名称'; // 不设置则默认为公众号名称
微信分享内容
<?php
$_share = array(
'title' => ?,
'link' => ?,
'imgUrl' => ?,
'content' => ?
);