# 目录
[TOC]
# 开发模板
想要书写一个主题，首先在`template`录创建一个`theme_tpl`目录作为我们自定义的模板目录，接着创建一个`html文件夹`用来存放所有的html文件
~~~
└─ template
└─ `theme_tpl`
├─ css
├─ js
└─ html
~~~
**TIP**
详细可参考模板结构来构建你的模板结构，这里知识点主要是开发技巧，不做详细的构建步骤介绍,开发任何网站模板是要具备一定`html``css`和`javascript`等前端基础哦
**必备js**
自带的`home.js`已经做好了很多必备的功能，开发者直接引入既可以使用里面`MAC`对象封装的函数，例如：历史记录、顶踩收藏、访问量统计，评论等等功能，俗称苹果cms模板必备三段。
~~~
<script src="{$maccms.path}static/js/jquery.js"></script>
<script>var maccms={"path":"__ROOT__","mid":"{$maccms['mid']}","url":"{$maccms['site_url']}","wapurl":"{$maccms['site_wapurl']}","mob_status":"{$maccms['mob_status']}"};
</script>
<script src="{$maccms.path}static/js/home.js"></script>
~~~
## 使用标签
苹果CMSv10标签完全支持`tp5`的语法，在HTML中使用`{}`包裹起来的`php`变量，如`{$maccms['site_name']}`数组的形式支持用`.`来代替如：`{$maccms.site_name}`。列表标签有`起始标签`和`结束标签`组成。如`{maccms:vod type="all" num="10"}{/maccms:vod}`,内部变量都是数据库字段组成，以`$vo.`开头如：`{$vo.vod_name}`、`{$vo.vod_id}`等等。
## 使用函数
我们往往需要对模板输出变量使用函数，可以使用：
~~~
{$data.name|md5}
~~~
* 编译后的结果是：
~~~
<?php echo (md5($data['name'])); ?>
~~~
* 如果函数有多个参数需要调用，则使用：
~~~
{$create_time|date="y-m-d",###}
~~~
表示date函数传入两个参数，每个参数用逗号分割，这里第一个参数是y-m-d，第二个参数是前面要输出的create\_time变量，因为该变量是第二个参数，因此需要用###标识变量位置，编译后的结果是：
~~~
<?php echo (date("y-m-d",$create_time)); ?>
~~~
如果前面输出的变量在后面定义的函数的第一个参数，则可以直接使用：
~~~
{$data.name|substr=0,3}
~~~
表示输出
~~~
<?php echo (substr($data['name'],0,3)); ?>
~~~
虽然也可以使用：
~~~
{$data.name|substr=###,0,3}
~~~
但完全没用这个必要。 还可以支持多个函数过滤，多个函数之间用`|`分割即可，例如：
~~~
{$name|md5|strtoupper|substr=0,3}
~~~
编译后的结果是：
~~~
<?php echo (substr(strtoupper(md5($name)),0,3)); ?>
~~~
函数会按照从左到右的顺序依次调用。 如果你觉得这样写起来比较麻烦，也可以直接这样写：
~~~
{:substr(strtoupper(md5($name)),0,3)}
~~~
**TIP**
变量输出使用的函数可以支持内置的PHP函数或者用户自定义函数，甚至是静态方法。
## 常用处理函数
* 允许使用多个函数，都使用|分隔开
* 所有图片地址，不管是远程的本地的都建议使用`mac_url_img`来处理。
* `{:mac_data_count(0,'all','vod')}`获取视频总数量
* `{:mac_data_count(0,'today','vod')}`获取今日更新视频总数量
* `{:mac_data_count(0,'all','art')}`获取文章总数量
* `{:mac_data_count(0,'today','art')}`获取今日更新文章总数量
* `{:mac_data_count(1,'all')}`获取某个分类下的数据总量，支持视频和文章,传入分类ID
* `{:mac_data_count(1,'today')}`获取某个分类下的今日更新数据总量，支持视频和文章,传入分类ID
* 另外还支持`topic`,`website`,`actor`,`role`模块的获取数据数量
* `{:mac_url('map/index')}`获取站内链接,参数代表 模块/页面
* `{$obj.vod_content|mac_url_content_img}`如果使用了第三方附件存储，附件和图片默认url是mac:开头的，此方法将替换为-`http`
* `{$vo.vod_pic|mac_url_img}`自动转换图片地址
* `{$vo.vod_content|mac_substring=100}`返回截取字符串100个字
* `{$vo.vod_content|mac_filter_html}`返回没有html代码的内容
* `{$vo.actor|mac_url_create='actor','vod','search',' '}`把,号相连的一串字符生成N个搜索链接,后2个参数可以不填写默认是生成vod模块搜索链接。 例子是创建演员搜索链接。支持演员、导演、tag、扩展分类等字段。最后一个参数是生成链接的分隔符。
* `{$vo.vod_time|mac_day}`自动返回日期
* `{$vo.vod_time|mac_friend_date}`友好时间提醒 几秒前，几分前，几小时前，几天前。。。
* `{$vo.vod_year|mac_default='未知'}`如果字符串为空，则返回默认字符串
* `{$user.user_login_ip|mac_long2ip}`返回格式化ip地址
* `{$user.user_id|mac_get_user_portrait}`获取用户头像地址
## 常用JS处理函数
一般用元素的class自动绑定处理事件
* 会员-收藏视频内容
~~~
<a href="javascript:;" class="mac_ulog" data-type="2" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}">我要收藏</a>
~~~
* 会员-收藏文章内容页
~~~
<a href="javascript:;" class="mac_ulog" data-type="2" data-mid="{$maccms.mid}" data-id="{$obj.art_id}">我要收藏</a>
~~~
* 会员-收藏专题内容页
~~~
<a href="javascript:;" class="mac_ulog" data-type="2" data-mid="{$maccms.mid}" data-id="{$obj.topic_id}">我要收藏</a>
~~~
以下内容一般放到body结尾之前，不用于显示，只用户记录信息。
* 会员-文章浏览记录
~~~
<span style="display:none" class="mac_ulog_set" alt="设置文章内容页浏览记录" data-type="1" data-mid="{$maccms.mid}" data-id="{$obj.art_id}" data-sid="{$param.sid}" data-nid="{$param.nid}"></span>
~~~
* 会员-专题浏览记录
~~~
<span style="display:none" class="mac_ulog_set" alt="设置专题内容页浏览记录" data-type="1" data-mid="{$maccms.mid}" data-id="{$obj.topic_id}" data-sid="{$param.sid}" data-nid="{$param.nid}"></span>
~~~
* 会员-视频浏览记录
~~~
<span style="display:none" class="mac_ulog_set" alt="设置内容页浏览记录" data-type="1" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}" data-sid="{$param.sid}" data-nid="{$param.nid}"></span>
~~~
* 会员-视频播放记录
~~~
<span style="display:none" class="mac_ulog_set" alt="设置视频播放记录" data-type="4" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}" data-sid="{$param.sid}" data-nid="{$param.nid}"></span>
~~~
* 会员-视频下载记录
~~~
<span style="display:none" class="mac_ulog_set" alt="设置视频播放记录" data-type="5" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}" data-sid="{$param.sid}" data-nid="{$param.nid}"></span>
~~~
* 视频、文章、专题 顶和踩 通用
~~~
<a class="digg_link" data-id="{$obj.vod_id}{$obj.art_id}{$obj.topic_id}" data-mid="{$maccms.mid}" data-type="up" href="javascript:;">
顶<em class="digg_num">{$obj.vod_up}{$obj.art_up}{$obj.topic_up}</em>
</a>
<a class="digg_link" data-id="{$vod_id}{$art_id}{$topic_id}" data-mid="{$maccms.mid}" data-type="down" href="javascript:;">
踩<em class="digg_num">{$obj.vod_down}{$obj.art_down}{$obj.topic_down}</em>
</a>
~~~
### 视频、文章、专题点击量显示 通用
总点击量：
~~~
<span class="mac_hits hits" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}{$obj.art_id}{$obj.topic_id}" data-type="hits"></span>
~~~
* 日点击量：
~~~
<span class="mac_hits hits_day" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}{$obj.art_id}{$obj.topic_id}" data-type="hits_day"></span>
~~~
* 周点击量：
~~~
<span class="mac_hits hits_week" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}{$obj.art_id}{$obj.topic_id}" data-type="hits_week"></span>
~~~
* 月点击量：
~~~
<span class="mac_hits hits_month" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}{$obj.art_id}{$obj.topic_id}" data-type="hits_month"></span>
~~~
* 前台浏览历史记录调用
~~~
<a href="javascript:;" class="mac_history">历史记录</a>
~~~
### 在视频、文章、专题详情页面写入浏览历史记录
~~~
<span style="display:none" class="mac_history_set" alt="设置视频历史记录" data-name="[{$obj.type.type_name}]{$obj.vod_name}" data-pic="{$obj.vod_pic|mac_url_img}"></span>
<span style="display:none" class="mac_history_set" alt="设置文章历史记录" data-name="[{$obj.type.type_name}]{$obj.art_name}" data-pic="{$obj.art_pic|mac_url_img}"></span>
<span style="display:none" class="mac_history_set" alt="设置专题历史记录" data-name="{$obj.topic_name}" data-pic="{$obj.topic_pic|mac_url_img}"></span>
~~~
* 访问页面触发定时任务，建议放到首页底部； 由于入口文件名可变，默认是api.php，如需修改请自定义 data-file="xxx.php"
~~~
<span style="display: none;" class="mac_timming" data-file="" ></span>
~~~
* 网址导航来路记录统计；建议放到首页底部。来路域名必须和网址导航里的跳转url里的一致。
~~~
<span style="display: none;" class="mac_referer" data-file="" ></span>
~~~
* 自动获取短网址连接
~~~
<input type="text" name="shorten" class="mac_shorten" />
~~~
* 短网址自定义用法，js来获取
~~~
<script>
MAC.Shorten.Get("http://www.baidu.com/",function(r){
alert(r.data.url_short);
});
</script>
~~~
* 获取用户记录日志，比如1浏览、2收藏、3想看、4点播、5下载
* `MAC.Ulog.Get`有`4`个参数`type`类型`0`代表全部,`page`页码,`limit`每页条数,`call`回调函数
~~~
<script>
MAC.Ulog.Get(0,1,999,function(r){
if(r.code == 1){
$.each(r['list'],function(index,row){
console.log(row['data']['id'] + '--' + row['data']['name'] + '--' + row['data']['pic'] + '--' + row['data']['link'] + '--' + row['data']['type']['type_name'] + '--' + row['data']['type']['link'] + '--' );
});
}else{
console.log('获取失败');
}
});
</script>
~~~
## 使用默认值
我们可以给变量输出提供默认值，例如：
~~~
{$obj.user_nickname|default="这个人没有昵称"}
~~~
对系统变量依然可以支持默认值输出，例如：
~~~
{$obj.vod_actor|default="演员为空"}
~~~
默认值和函数可以同时使用，例如：
~~~
{$Think.get.name|getName|default="名称为空"}
~~~
## 使用运算符
我们可以对模板输出使用运算符，包括对“+”“-” “\*” “/”和“%”的支持。 例如：
| 运算符 | 使用示例 |
| --- | --- |
| + | {$a+$b} |
| \- | {$a-$b} |
| \* | {$a\*$b} |
| / | {$a/$b} |
| % | {$a%$b} |
| ++ | {$a++} 或 {++$a} |
| \-- | {$a--} 或 {--$a} |
| 综合判断 | {$a+$b\*10+$c} |
在使用运算符的时候，不再支持常规函数用法，例如：
~~~
{$user.score+10} //正确的
{$user['score']+10} //正确的
{$user['score']*$user['level']} //正确的
{$user['score']|myFun*10} //错误的
{$user['score']+myFun($user['level'])} //正确的
~~~
## 三元运算
模板可以支持三元运算符，例如：
~~~
{$status? '正常' : '错误'}
{$info['status']? $info['msg'] : $info['error']}
{$info.status? $info.msg : $info.error }
~~~
5.0版本还支持如下的写法：
~~~
{$varname.aa ?? 'xxx'}
~~~
表示如果有设置$varname则输出$varname,否则输出'xxx'。 解析后的代码为：
~~~
<?php echo isset($varname['aa']) ? $varname['aa'] : '默认值'; ?>
~~~
~~~
{$varname?='xxx'}
~~~
表示$varname为真时才输出xxx。 解析后的代码为：
~~~
<?php if(!empty($name)) echo 'xxx'; ?>
~~~
~~~
{$varname ?: 'no'}
~~~
表示如果$varname为真则输出$varname，否则输出no。解析后的代码为：
~~~
<?php echo $varname ? $varname : 'no'; ?>
~~~
~~~
{$a==$b ? 'yes' : 'no'}
~~~
前面的表达式为真输出yes,否则输出no， 条件可以是==、===、!=、!==、>=、<=
## 模板继承
模板继承是一项更加灵活的模板布局方式，模板继承不同于模板布局，甚至来说，应该在模板布局的上层。模板继承其实并不难理解，就好比类的继承一样，模板也可以定义一个基础模板（或者是布局），并且其中定义相关的区块`block`，然后继承`extend`该基础模板的子模板中就可以对基础模板中定义的区块进行重载。
因此，模板继承的优势其实是设计基础模板中的区块`block）和子模板中替换这些区块。
每个区块由`{block} {/block}`标签组成。 下面就是基础模板中的一个典型的区块设计（用于设计网站标题）：
~~~
{block name="title"}<title>网站标题</title>{/block}
~~~
block标签必须指定name属性来标识当前区块的名称，这个标识在当前模板中应该是唯一的，block标签中可以包含任何模板内容，包括其他标签和变量，例如：
~~~
{block name="title"}<title>{$web_title}</title>{/block}
~~~
你甚至还可以在区块中加载外部文件：
~~~
{block name="include"}{include file="Public:header" /}{/block}
~~~
一个模板中可以定义任意多个名称标识不重复的区块，例如下面定义了一个`base.html`基础模板：
~~~
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>{block name="title"}标题{/block}</title>
</head>
<body>
{block name="menu"}菜单{/block}
{block name="left"}左边分栏{/block}
{block name="main"}主内容{/block}
{block name="right"}右边分栏{/block}
{block name="footer"}底部{/block}
</body>
</html>
~~~
然后我们在子模板（其实是当前操作的入口模板）中使用继承：
~~~
{extend name="base" /}
{block name="title"}{$title}{/block}
{block name="menu"}
<a href="/" >首页</a>
<a href="/info/" >资讯</a>
<a href="/bbs/" >论坛</a>
{/block}
{block name="left"}{/block}
{block name="main"}
{volist name="list" id="vo"}
<a href="/new/{$vo.id}">{$vo.title}</a><br/>
{$vo.content}
{/volist}
{/block}
{block name="right"}
最新资讯：
{volist name="news" id="new"}
<a href="/new/{$new.id}">{$new.title}</a><br/>
{/volist}
{/block}
{block name="footer"}
{__block__}
@ThinkPHP 版权所有
{/block}
~~~
上例中，我们可以看到在子模板中使用了extend标签来继承了base模板。 在子模板中，可以对基础模板中的区块进行重载定义，如果没有重新定义的话，则表示沿用基础模板中的区块定义，如果定义了一个空的区块，则表示删除基础模板中的该区块内容。 上面的例子，我们就把left区块的内容删除了，其他的区块都进行了重载。而
~~~
{block name="footer"}
{__block__}@苹果cms pgcms.net 版权所有
{/block}
~~~
这一区块中有`{_block_}`这个标签，当区块中有这个标记时，就不只是直接重载这个区块，它表示引用所继承模板对应区块的内容到这个位置，最终这个区块是合并后的内容。所以这里`footer`区块最后的内容是： 底部@大图模板 版权所有`extend`标签的用法和`include`标签一样，你也可以加载其他模板：
~~~
{extend name="Public:base" /}
~~~
或者使用绝对文件路径加载
~~~
{extend name="./Template/Public/base.html" /}
~~~
在当前子模板中，只能定义区块而不能定义其他的模板内容，否则将会直接忽略，并且只能定义基础模板中已经定义的区块。 例如，如果采用下面的定义：
~~~
{block name="title"}<title>{$title}</title>{/block}
<a href="/" >首页</a>
<a href="/art/index" >资讯</a>
<a href="/actor/" >明星</a>
~~~
导航部分将是无效的，不会显示在模板中。 模板可以多级继承，比如B继承了A，而C又继承了B，最终C中的区块会覆盖B和A中的同名区块，但C和B中的区块必须是A中已定义过的。 子模板中的区块定义顺序是随意的，模板继承的用法关键在于基础模板如何布局和设计规划了，如果结合原来的布局功能，则会更加灵活。
## 比较标签
比较标签用于简单的变量比较，复杂的判断条件可以用if标签替换，比较标签是一组标签的集合，基本上用法都一致，如下：
| 标签 | 含义 |
| --- | --- |
| eq或者 equal | 等于 |
| neq 或者notequal | 不等于 |
| gt | 大于 |
| egt | 大于等于 |
| lt | 小于 |
| elt | 小于等于 |
| heq | 恒等于 |
| nheq | 不恒等于 |
他们的用法基本是一致的，区别在于判断的条件不同，并且所有的比较标签都可以和else标签一起使用。 例如，要求name变量的值等于value就输出，可以使用：
~~~
{eq name="name" value="value"}value{/eq}
~~~
或者
~~~
{equal name="name" value="value"}value{/equal}
~~~
也可以支持和else标签混合使用：
~~~
{eq name="name" value="value"}
相等
{else/}
不相等
{/eq}
~~~
当 name变量的值大于5就输出
~~~
{gt name="vod_name" value="5"}value{/gt}
~~~
当name变量的值不小于5就输出
~~~
{egt name="name" value="5"}value{/egt}
~~~
比较标签中的变量可以支持对象的属性或者数组，甚至可以是系统变量，例如： 当vo对象的属性（或者数组，或者自动判断）等于5就输出
~~~
{eq name="vo.vod_name" value="5"}
{$vo.vod_name}
{/eq}
~~~
当`vo`对象的属性等于5就输出
~~~
{eq name="vo:vod_name" value="5"}
{$vo.vod_name}
{/eq}
~~~
当`$vo['vod_name']`等于5就输出
~~~
{eq name="vo['vod_name']" value="5"}
{$vo.name}
{/eq}
~~~
而且还可以支持对变量使用函数 当`vo`对象的属性值的字符串长度等于`5`就输出
~~~
{eq name="vo:name|strlen" value="5"}{$vo.name}{/eq}
~~~
变量名可以支持Thinkphp5.0系统变量的方式，例如：
~~~
{eq name="Think.get.name" value="value"}相等{else/}不相等{/eq}
~~~
通常比较标签的值是一个字符串或者数字，如果需要使用变量，只需要在前面添加`$`标志： 当`vo`对象的属性等于`$a`就输出
~~~
{eq name="vo:vod_name" value="$a"}{$vo.vod_name}{/eq}
~~~
所有的比较标签可以统一使用`compare`标签（其实所有的比较标签都是`compare`标签的别名），例如： 当`name`变量的值等于5就输出
~~~
{compare name="name" value="5" type="eq"}value{/compare}
~~~
等效于
~~~
{eq name="name" value="5" }value{/eq}
~~~
其中type属性的值就是上面列出的比较标签名称
## 条件判断
### SWITCH标签
用法：
~~~
{switch name="变量" }
{case value="值1" break="0或1"}输出内容1{/case}
{case value="值2"}输出内容2{/case}
{default /}默认情况
{/switch}
~~~
使用方法如下：
~~~
{switch name="User.level"}
{case value="1"}value1{/case}
{case value="2"}value2{/case}
{default /}default
{/switch}
~~~
其中name属性可以使用函数以及系统变量，例如：
~~~
{switch name="Think.get.userId|abs"}
{case value="1"}admin{/case}
{default /}default
{/switch}
~~~
对于case的value属性可以支持多个条件的判断，使用”|”进行分割，例如：
~~~
{switch name="Think.get.type"}
{case value="gif|png|jpg"}图像格式{/case}
{default /}其他格式
{/switch}
~~~
表示如果`$_GET["type"]`是`gif`、`png`或者`jpg`的话，就判断为图像格式。
`Case`标签还有一个`break`属性，表示是否需要`break`，默认是会自动添加`break`，如果不要`break`，可以使用：
~~~
{switch name="Think.get.userId|abs"}
{case value="1" break="0"}admin{/case}
{case value="2"}admin{/case}
{default /}default
{/switch}
~~~
也可以对case的value属性使用变量，例如：
~~~
{switch name="User.userId"}
{case value="$adminId"}admin{/case}
{case value="$memberId"}member{/case}
{default /}default
{/switch}
~~~
TIP
使用变量方式的情况下，不再支持多个条件的同时判断。
简洁的用法
~~~
{switch $User.userId}
{case $adminId}admin{/case}
{case $memberId}member{/case}
{/switch}
~~~
### IF标签
用法示例：
~~~
{if condition="($name == 1) OR ($name > 100) "} value1
{elseif condition="$name eq 2"/}value2
{else /} value3
{/if}
~~~
除此之外，我们可以在condition属性里面使用php代码，例如：
~~~
{if condition="strtoupper($user['name']) neq 'THINKPHP'"}ThinkPHP
{else /} other Framework
{/if}
~~~
condition属性可以支持点语法和对象语法，例如： 自动判断user变量是数组还是对象
~~~
{if condition="$user.name neq 'ThinkPHP'"}ThinkPHP
{else /} other Framework
{/if}
~~~
或者知道user变量是对象
~~~
{if condition="$user:name neq 'ThinkPHP'"}ThinkPHP
{else /} other Framework
{/if}
~~~
由于`if`标签的`condition`属性里面基本上使用的是`php`语法，尽可能使用判断标签和`Switch`标签会更加简洁，原则上来说，能够用`switch`和比较标签解决的尽量不用`if`标签完成。因为`switch`和比较标签可以使用变量调节器和系统变量。如果某些特殊的要求下面，`IF`标签仍然无法满足要求的话，可以使用原生`php`代码或者`PHP`标签来直接书写代码。 简洁的用法
~~~
{if condition="表达式"}
{if (表达式)}
{if 表达式}
~~~
这三种写法结果是一样的
### 范围判断
范围判断标签包括`in``notin``between``notbetween`四个标签，都用于判断变量是否中某个范围。
#### IN和NOTIN
用法： 假设我们中控制器中给id赋值为1：
~~~
$id = 1;
$this->assign('id',$id);
~~~
我们可以使用in标签来判断模板变量是否在某个范围内，例如：
~~~
{in name="id" value="1,2,3"}
id在范围内
{/in}
~~~
最后会输出：`id`在范围内。
如果判断不在某个范围内，可以使用`notin`标签：
~~~
{notin name="id" value="1,2,3"}
id不在范围内
{/notin}
~~~
最后会输出：`id`不在范围内。 可以把上面两个标签合并成为：
~~~
{in name="id" value="1,2,3"}
id在范围内
{else/}
id不在范围内
{/in}
~~~
`name`属性还可以支持直接判断系统变量，例如：
~~~
{in name="Think.get.id" value="1,2,3"}
$_GET['id'] 在范围内
{/in}
~~~
TIP
更多的系统变量用法可以参考系统变量部分。
value属性也可以使用变量，例如：
~~~
{in name="id" value="$range"}
id在范围内
{/in}
~~~
`$range`变量可以是数组，也可以是以逗号分隔的字符串。`value`属性还可以使用系统变量，例如：
~~~
{in name="id" value="$Think.post.ids"}
id在范围内
{/in}
~~~
### BETWEEN 和 NOTBETWEEN
可以使用between标签来判断变量是否在某个区间范围内，可以使用：
~~~
{between name="id" value="1,10"}
输出内容1
{/between}
~~~
同样，也可以使用notbetween标签来判断变量不在某个范围内：
~~~
{notbetween name="id" value="1,10"}
输出内容2
{/notbetween}
~~~
也可以使用`else`标签把两个用法合并，例如：
~~~
{between name="id" value="1,10"}
输出内容1
{else/}
输出内容2
{/between}
~~~
当使用between标签的时候，value只需要一个区间范围，也就是只支持两个值，后面的值无效，例如
~~~
{between name="id" value="1,3,10"}
输出内容1
{/between}
~~~
实际判断的范围区间是`1~3`，而不是`1~10`，也可以支持字符串判断，例如：
~~~
{between name="id" value="A,Z"}
输出内容1
{/between}
~~~
`name`属性可以直接使用系统变量，例如：
~~~
{between name="Think.post.id" value="1,5"}
输出内容1
{/between}
~~~
value属性也可以使用变量，例如：
~~~
{between name="id" value="$range"}
输出内容1
{/between}
~~~
变量的值可以是字符串或者数组，还可以支持系统变量。
~~~
{between name="id" value="$Think.get.range"}
输出内容1
{/between}
~~~
### RANGE
也可以直接使用range标签，替换前面的判断用法：
~~~
{range name="id" value="1,2,3" type="in"}
输出内容1
{/range}
~~~
其中`type`属性的值可以用`in/notin/between/notbetween`，其它属性的用法和`IN`或者`BETWEEN`一致。
### PRESENT NOTPRESENT标签
present标签用于判断某个变量是否已经定义，用法：
~~~
{present name="name"}
name已经赋值
{/present}
~~~
如果判断没有赋值，可以使用：
~~~
{notpresent name="name"}
name还没有赋值
{/notpresent}
~~~
可以把上面两个标签合并成为：
~~~
{present name="name"}
name已经赋值
{else /}
name还没有赋值
{/present}
~~~
`present`标签的`name`属性可以直接使用系统变量，例如：
~~~
{present name="Think.get.name"}
$_GET['name']已经赋值
{/present}
~~~
### EMPTY NOTEMPTY 标签
empty标签用于判断某个变量是否为空，用法：
~~~
{empty name="name"}
name为空值
{/empty}
~~~
如果判断没有赋值，可以使用：
~~~
{notempty name="name"}
name不为空
{/notempty}
~~~
以把上面两个标签合并成为：
~~~
{empty name="name"}
name为空
{else /}
name不为空
{/empty}
~~~
`name`属性可以直接使用系统变量，例如：
~~~
{empty name="Think.get.name"}
$_GET['name']为空值
{/empty}
~~~
### DEFINED 标签
DEFINED标签用于判断某个常量是否有定义，用法如下：
~~~
{defined name="NAME"}
NAME常量已经定义
{/defined}
~~~
**TIP**
name属性的值要注意严格大小写
如果判断没有被定义，可以使用：
~~~
{notdefined name="NAME"}
NAME常量未定义
{/notdefined}
~~~
可以把上面两个标签合并成为：
~~~
{defined name="NAME"}
NAME常量已经定义
{else /}
NAME常量未定义
{/defined}
~~~
## 标签嵌套
模板引擎支持标签的多层嵌套功能，可以对标签库的标签指定可以嵌套。
系统内置的标签中，`volist`、`switch`、`if`、`elseif`、`else`、`foreach`、`compare`（包括所有的比较标签）、（`not`）`present`、（n`ot`）`empty`、（`not`）`defined`等标签都可以嵌套使用。例如：
~~~
{volist name="list" id="vo"}
{volist name="vo['sub']" id="sub"}
{$sub.name}
{/volist}
{/volist}
~~~
* 嵌套循环外层分类内部视频或文章,重点在于外部和内部标签各自设置 id 和 key，系统默认都是vo不适合会导致数据冲掉。
~~~
{maccms:type ids="1,2,3,4" order="asc" by="sort" id="vo1" key="key1"}
{maccms:vod num="10" type="'.$vo1['type_id'].'" order="desc" by="time" id="vo2" key="key2"}
{$vo1.type_name}:{$vo2.vod_name}；
{/maccms:vod}
{/maccms:type}
~~~
* 嵌套循环一级和二级分类数据
~~~
{maccms:type ids="1,2,3,4,5" order="asc" by="sort" id="vo" key="key"}
{maccms:type parent="'.$vo['type_id'].'" order="asc" by="sort" id="vo2" key="key2"}
<li><a href=":mac_url_type($vo2)}">{$vo2.type_name}</a></li>
{/maccms:type}
{/maccms:type}
~~~
## 使用PHP
php代码可以和标签在模板文件中混合使用，可以在模板文件里面书写任意的PHP语句代码 ，包括下面两种方式：
### 使用php标签
~~~
{php}echo 'Hello,world!';{/php}
~~~
我们建议需要使用PHP代码的时候尽量采用php标签，因为原生的PHP语法可能会被配置禁用而导致解析错误。
### 使用原生php代码
~~~
<?php echo 'Hello,world!'; ?>
~~~
**TIP**
注意：php标签或者php代码里面就不能再使用标签（包括普通标签和XML标签）了，因此下面的几种方式都是无效的：
~~~
{php}{eq name='name'value='value'}value{/eq}{/php}
~~~
Php标签里面使用了`eq`标签，因此无效
~~~
{php}if( {$user} != 'ThinkPHP' ) echo 'ThinkPHP' ;{/php}
~~~
php标签里面使用了`{$user}`普通标签输出变量 ，因此无效。
~~~
{php}if( $user.name != 'ThinkPHP' ) echo 'ThinkPHP' ;{/php}
~~~
Php标签里面使用了$user.name 点语法变量输出 ，因此无效。
**TIP**
简而言之，在PHP标签里面不能再使用PHP本身不支持的代码。
如果设置了`tpl_deny_php`参数为`true`，就不能在模板中使用原生的`PHP`代码，但是仍然支持`PHP`标签输出。
### 自定义标签
**ASSIGN标签**`ASSIGN`标签用于在模板文件中定义变量，用法如下：
~~~
{assign name="var" value="123" /}
~~~
在运行模板的时候，赋值了一个`var`的变量，值是`123`。
`value`属性也支持变量，例如：
~~~
{assign name="var" value="$val" /}
~~~
或者直接把系统变量赋值给var变量，例如：
~~~
{assign name="var" value="$Think.get.name" /}
~~~
相当于，执行了：`$var = $_GET['name'];`
**DEFINE标签**`DEFINE`标签用于中模板中定义常量，用法如下：
~~~
{define name="MY_DEFINE_NAME" value="3" /}
~~~
在运行模板的时候，就会定义一个`MY_DEFINE_NAME`的常量。
`value`属性可以支持变量（包括系统变量），例如：
~~~
{define name="MY_DEFINE_NAME" value="$name" /}
~~~
或者
~~~
{define name="MY_DEFINE_NAME" value="$Think.get.name" /}
~~~
