# 开发模板

想要书写一个主题,首先在template录创建一个 theme_tpl 目录作为我们自定义的模板目录,接着创建一个 html文件夹 用来存放所有的html文件

└─ template
   └─ `theme_tpl`
       ├─ css
       ├─ js
       └─ html
1
2
3
4
5

TIP

详细可参考 模板结构 来构建你的模板结构,这里知识点主要是开发技巧,不做详细的构建步骤介绍,开发任何网站模板是要具备一定 html cssjavascript 等前端基础哦

必备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>
1
2
3
4

# 使用标签

苹果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} 
1
  • 编译后的结果是:
<?php echo (md5($data['name'])); ?>
1
  • 如果函数有多个参数需要调用,则使用:
{$create_time|date="y-m-d",###}
1

表示date函数传入两个参数,每个参数用逗号分割,这里第一个参数是y-m-d,第二个参数是前面要输出的create_time变量,因为该变量是第二个参数,因此需要用###标识变量位置,编译后的结果是:

<?php echo (date("y-m-d",$create_time)); ?>

1
2

如果前面输出的变量在后面定义的函数的第一个参数,则可以直接使用:

{$data.name|substr=0,3}
1

表示输出

<?php echo (substr($data['name'],0,3)); ?>
1

虽然也可以使用:

{$data.name|substr=###,0,3}
1

但完全没用这个必要。 还可以支持多个函数过滤,多个函数之间用|分割即可,例如:

{$name|md5|strtoupper|substr=0,3}
1

编译后的结果是:

<?php echo (substr(strtoupper(md5($name)),0,3)); ?>
1

函数会按照从左到右的顺序依次调用。 如果你觉得这样写起来比较麻烦,也可以直接这样写:

{:substr(strtoupper(md5($name)),0,3)}
1

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','&nbsp;'} 把,号相连的一串字符生成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>
1
  • 会员-收藏文章内容页
<a href="javascript:;" class="mac_ulog" data-type="2" data-mid="{$maccms.mid}" data-id="{$obj.art_id}">我要收藏</a>
1
  • 会员-收藏专题内容页
<a href="javascript:;" class="mac_ulog" data-type="2" data-mid="{$maccms.mid}" data-id="{$obj.topic_id}">我要收藏</a>
1

以下内容一般放到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>
1
  • 会员-专题浏览记录
<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>
1
  • 会员-视频浏览记录
<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>
1
  • 会员-视频播放记录
<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>
1
  • 会员-视频下载记录
<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>
1
  • 视频、文章、专题 顶和踩 通用
<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>
1
2
3
4
5
6

# 视频、文章、专题点击量显示 通用

总点击量:

<span class="mac_hits hits" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}{$obj.art_id}{$obj.topic_id}" data-type="hits"></span>
1
  • 日点击量:
<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>
1
  • 周点击量:
<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>
1
  • 月点击量:
<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>
1
  • 前台浏览历史记录调用
<a href="javascript:;" class="mac_history">历史记录</a>
1

# 在视频、文章、专题详情页面写入浏览历史记录

<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>
1
2
3
  • 访问页面触发定时任务,建议放到首页底部; 由于入口文件名可变,默认是api.php,如需修改请自定义 data-file="xxx.php"
<span style="display: none;" class="mac_timming" data-file="" ></span>
1
  • 网址导航来路记录统计;建议放到首页底部。来路域名必须和网址导航里的跳转url里的一致。
<span style="display: none;" class="mac_referer" data-file="" ></span>
1
  • 自动获取短网址连接
<input type="text" name="shorten" class="mac_shorten" />
1
  • 短网址自定义用法,js来获取
<script>
    MAC.Shorten.Get("http://www.baidu.com/",function(r){
        alert(r.data.url_short);
    });
</script>
1
2
3
4
5
  • 获取用户记录日志,比如1浏览、2收藏、3想看、4点播、5下载
  • MAC.Ulog.Get4个参数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>
1
2
3
4
5
6
7
8
9
10
11

# 使用默认值

我们可以给变量输出提供默认值,例如:

{$obj.user_nickname|default="这个人没有昵称"}
1

对系统变量依然可以支持默认值输出,例如:

{$obj.vod_actor|default="演员为空"}
1

默认值和函数可以同时使用,例如:

{$Think.get.name|getName|default="名称为空"}
1

# 使用运算符

我们可以对模板输出使用运算符,包括对“+”“-” “*” “/”和“%”的支持。 例如:

运算符 使用示例
+ {$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'])} //正确的
1
2
3
4
5

# 三元运算

模板可以支持三元运算符,例如:

{$status? '正常' : '错误'}
{$info['status']? $info['msg'] : $info['error']}
{$info.status? $info.msg : $info.error }
1
2
3

5.0版本还支持如下的写法:

{$varname.aa ?? 'xxx'}
1

表示如果有设置$varname则输出$varname,否则输出'xxx'。 解析后的代码为:

<?php echo isset($varname['aa']) ? $varname['aa'] : '默认值'; ?>
1
{$varname?='xxx'} 
1

表示$varname为真时才输出xxx。 解析后的代码为:

<?php if(!empty($name)) echo 'xxx'; ?>
1
{$varname ?: 'no'}
1

表示如果$varname为真则输出$varname,否则输出no。解析后的代码为:

<?php echo $varname ? $varname : 'no'; ?>
1
{$a==$b ? 'yes' : 'no'}
1

前面的表达式为真输出yes,否则输出no, 条件可以是==、===、!=、!==、>=、<=

# 模板继承

模板继承是一项更加灵活的模板布局方式,模板继承不同于模板布局,甚至来说,应该在模板布局的上层。模板继承其实并不难理解,就好比类的继承一样,模板也可以定义一个基础模板(或者是布局),并且其中定义相关的区块block,然后继承extend该基础模板的子模板中就可以对基础模板中定义的区块进行重载。

因此,模板继承的优势其实是设计基础模板中的区块`block)和子模板中替换这些区块。

每个区块由{block} {/block}标签组成。 下面就是基础模板中的一个典型的区块设计(用于设计网站标题):

{block name="title"}<title>网站标题</title>{/block}
1

block标签必须指定name属性来标识当前区块的名称,这个标识在当前模板中应该是唯一的,block标签中可以包含任何模板内容,包括其他标签和变量,例如:

{block name="title"}<title>{$web_title}</title>{/block}
1

你甚至还可以在区块中加载外部文件:

{block name="include"}{include file="Public:header" /}{/block}
1

一个模板中可以定义任意多个名称标识不重复的区块,例如下面定义了一个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>
1
2
3
4
5
6
7
8
9
10
11
12
13

然后我们在子模板(其实是当前操作的入口模板)中使用继承:

{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}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

上例中,我们可以看到在子模板中使用了extend标签来继承了base模板。 在子模板中,可以对基础模板中的区块进行重载定义,如果没有重新定义的话,则表示沿用基础模板中的区块定义,如果定义了一个空的区块,则表示删除基础模板中的该区块内容。 上面的例子,我们就把left区块的内容删除了,其他的区块都进行了重载。而

{block name="footer"}
{__block__}@大图模板datll.com 版权所有
{/block}
1
2
3

这一区块中有{_block_}这个标签,当区块中有这个标记时,就不只是直接重载这个区块,它表示引用所继承模板对应区块的内容到这个位置,最终这个区块是合并后的内容。所以这里footer区块最后的内容是: 底部@大图模板 版权所有 extend标签的用法和include标签一样,你也可以加载其他模板:

{extend name="Public:base" /}
1

或者使用绝对文件路径加载

{extend name="./Template/Public/base.html" /}
1

在当前子模板中,只能定义区块而不能定义其他的模板内容,否则将会直接忽略,并且只能定义基础模板中已经定义的区块。 例如,如果采用下面的定义:

{block name="title"}<title>{$title}</title>{/block}
<a href="/" >首页</a>
<a href="/art/index" >资讯</a>
<a href="/actor/" >明星</a>
1
2
3
4

导航部分将是无效的,不会显示在模板中。 模板可以多级继承,比如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}
1

或者

{equal name="name" value="value"}value{/equal}
1

也可以支持和else标签混合使用:

{eq name="name" value="value"}
相等
{else/}
不相等
{/eq}
1
2
3
4
5

当 name变量的值大于5就输出

{gt name="vod_name" value="5"}value{/gt}
1

当name变量的值不小于5就输出

{egt name="name" value="5"}value{/egt}
1

比较标签中的变量可以支持对象的属性或者数组,甚至可以是系统变量,例如: 当vo对象的属性(或者数组,或者自动判断)等于5就输出

{eq name="vo.vod_name" value="5"}
{$vo.vod_name}
{/eq}
1
2
3

vo对象的属性等于5就输出

{eq name="vo:vod_name" value="5"}
{$vo.vod_name}
{/eq}
1
2
3

$vo['vod_name']等于5就输出

{eq name="vo['vod_name']" value="5"}
{$vo.name}
{/eq}
1
2
3

而且还可以支持对变量使用函数 当vo对象的属性值的字符串长度等于5就输出

{eq name="vo:name|strlen" value="5"}{$vo.name}{/eq}
1

变量名可以支持Thinkphp5.0系统变量的方式,例如:

{eq name="Think.get.name" value="value"}相等{else/}不相等{/eq}
1

通常比较标签的值是一个字符串或者数字,如果需要使用变量,只需要在前面添加$标志: 当vo对象的属性等于$a就输出

{eq name="vo:vod_name" value="$a"}{$vo.vod_name}{/eq}
1

所有的比较标签可以统一使用compare标签(其实所有的比较标签都是compare标签的别名),例如: 当name变量的值等于5就输出

{compare name="name" value="5" type="eq"}value{/compare}
1

等效于

{eq name="name" value="5" }value{/eq}
1

其中type属性的值就是上面列出的比较标签名称

# 条件判断

# SWITCH标签

用法:

{switch name="变量" }
    {case value="值1" break="0或1"}输出内容1{/case}
    {case value="值2"}输出内容2{/case}
    {default /}默认情况
{/switch}
1
2
3
4
5

使用方法如下:

{switch name="User.level"}
    {case value="1"}value1{/case}
    {case value="2"}value2{/case}
    {default /}default
{/switch}
1
2
3
4
5

其中name属性可以使用函数以及系统变量,例如:

{switch name="Think.get.userId|abs"}
    {case value="1"}admin{/case}
    {default /}default
{/switch}
1
2
3
4

对于case的value属性可以支持多个条件的判断,使用”|”进行分割,例如:

{switch name="Think.get.type"}
    {case value="gif|png|jpg"}图像格式{/case}
    {default /}其他格式
{/switch}

1
2
3
4
5

表示如果$_GET["type"]gifpng或者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}
1
2
3
4
5

也可以对case的value属性使用变量,例如:

{switch name="User.userId"}
    {case value="$adminId"}admin{/case}
    {case value="$memberId"}member{/case}
    {default /}default
{/switch}
1
2
3
4
5

TIP

使用变量方式的情况下,不再支持多个条件的同时判断。

简洁的用法

{switch $User.userId}
    {case $adminId}admin{/case}
    {case $memberId}member{/case}
{/switch}
1
2
3
4

# IF标签

用法示例:

{if condition="($name == 1) OR ($name > 100) "} value1
{elseif condition="$name eq 2"/}value2
{else /} value3
{/if}
1
2
3
4

除此之外,我们可以在condition属性里面使用php代码,例如:

{if condition="strtoupper($user['name']) neq 'THINKPHP'"}ThinkPHP
{else /} other Framework
{/if}
1
2
3

condition属性可以支持点语法和对象语法,例如: 自动判断user变量是数组还是对象

{if condition="$user.name neq 'ThinkPHP'"}ThinkPHP
{else /} other Framework
{/if}
1
2
3

或者知道user变量是对象

{if condition="$user:name neq 'ThinkPHP'"}ThinkPHP
{else /} other Framework
{/if}
1
2
3

由于if标签的condition属性里面基本上使用的是php语法,尽可能使用判断标签和Switch标签会更加简洁,原则上来说,能够用switch和比较标签解决的尽量不用if标签完成。因为switch和比较标签可以使用变量调节器和系统变量。如果某些特殊的要求下面,IF标签仍然无法满足要求的话,可以使用原生php代码或者PHP标签来直接书写代码。 简洁的用法

{if condition="表达式"}
{if (表达式)}
{if 表达式}
1
2
3

这三种写法结果是一样的

# 范围判断

范围判断标签包括in notin between notbetween四个标签,都用于判断变量是否中某个范围。

# IN和NOTIN

用法: 假设我们中控制器中给id赋值为1:

$id =    1;
$this->assign('id',$id);
1
2

我们可以使用in标签来判断模板变量是否在某个范围内,例如:

{in name="id" value="1,2,3"}
id在范围内
{/in}
1
2
3

最后会输出:id在范围内。

如果判断不在某个范围内,可以使用notin标签:

{notin name="id" value="1,2,3"}
id不在范围内
{/notin}
1
2
3

最后会输出:id不在范围内。 可以把上面两个标签合并成为:

{in name="id" value="1,2,3"}
id在范围内
{else/}
id不在范围内
{/in}
1
2
3
4
5

name属性还可以支持直接判断系统变量,例如:

{in name="Think.get.id" value="1,2,3"}
$_GET['id'] 在范围内
{/in}
1
2
3

TIP

更多的系统变量用法可以参考系统变量部分。

value属性也可以使用变量,例如:

{in name="id" value="$range"}
id在范围内
{/in}
1
2
3

$range变量可以是数组,也可以是以逗号分隔的字符串。 value属性还可以使用系统变量,例如:

{in name="id" value="$Think.post.ids"}
id在范围内
{/in}
1
2
3

# BETWEEN 和 NOTBETWEEN

可以使用between标签来判断变量是否在某个区间范围内,可以使用:

{between name="id" value="1,10"}
输出内容1
{/between}
1
2
3

同样,也可以使用notbetween标签来判断变量不在某个范围内:

{notbetween name="id" value="1,10"}
输出内容2
{/notbetween}
1
2
3

也可以使用else标签把两个用法合并,例如:

{between name="id" value="1,10"}
输出内容1
{else/}
输出内容2
{/between}
1
2
3
4
5

当使用between标签的时候,value只需要一个区间范围,也就是只支持两个值,后面的值无效,例如

{between name="id" value="1,3,10"}
输出内容1
{/between}
1
2
3

实际判断的范围区间是1~3,而不是1~10,也可以支持字符串判断,例如:

{between name="id" value="A,Z"}
输出内容1
{/between}
1
2
3

name属性可以直接使用系统变量,例如:

{between name="Think.post.id" value="1,5"}
输出内容1
{/between}
1
2
3

value属性也可以使用变量,例如:

{between name="id" value="$range"}
输出内容1
{/between}
1
2
3

变量的值可以是字符串或者数组,还可以支持系统变量。

{between name="id" value="$Think.get.range"}
输出内容1
{/between}
1
2
3

# RANGE

也可以直接使用range标签,替换前面的判断用法:

{range name="id" value="1,2,3" type="in"}
输出内容1
{/range}
1
2
3

其中type属性的值可以用in/notin/between/notbetween,其它属性的用法和IN或者BETWEEN一致。

# PRESENT NOTPRESENT标签

present标签用于判断某个变量是否已经定义,用法:

{present name="name"}
name已经赋值
{/present}
1
2
3

如果判断没有赋值,可以使用:

{notpresent name="name"}
name还没有赋值
{/notpresent}
1
2
3

可以把上面两个标签合并成为:

{present name="name"}
name已经赋值
{else /}
name还没有赋值
{/present}
1
2
3
4
5

present标签的name属性可以直接使用系统变量,例如:

{present name="Think.get.name"}
$_GET['name']已经赋值
{/present}
1
2
3

# EMPTY NOTEMPTY 标签

empty标签用于判断某个变量是否为空,用法:

{empty name="name"}
name为空值
{/empty}
1
2
3

如果判断没有赋值,可以使用:

{notempty name="name"}
name不为空
{/notempty}
1
2
3

以把上面两个标签合并成为:

{empty name="name"}
name为空
{else /}
name不为空
{/empty}
1
2
3
4
5

name属性可以直接使用系统变量,例如:

{empty name="Think.get.name"}
$_GET['name']为空值
{/empty}
1
2
3

# DEFINED 标签

DEFINED标签用于判断某个常量是否有定义,用法如下:

{defined name="NAME"}
NAME常量已经定义
{/defined}
1
2
3

TIP

name属性的值要注意严格大小写

如果判断没有被定义,可以使用:

{notdefined name="NAME"}
NAME常量未定义
{/notdefined}
1
2
3

可以把上面两个标签合并成为:

{defined name="NAME"}
NAME常量已经定义
{else /}
NAME常量未定义
{/defined}
1
2
3
4
5

# 标签嵌套

模板引擎支持标签的多层嵌套功能,可以对标签库的标签指定可以嵌套。

系统内置的标签中,volistswitchifelseifelseforeachcompare(包括所有的比较标签)、(notpresent、(notempty、(notdefined等标签都可以嵌套使用。例如:

{volist name="list" id="vo"}
    {volist name="vo['sub']" id="sub"}
        {$sub.name}
    {/volist}
{/volist}
1
2
3
4
5
  • 嵌套循环外层分类内部视频或文章,重点在于外部和内部标签各自设置 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}
1
2
3
4
5
  • 嵌套循环一级和二级分类数据
{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}
1
2
3
4
5

# 使用PHP

php代码可以和标签在模板文件中混合使用,可以在模板文件里面书写任意的PHP语句代码 ,包括下面两种方式:

# 使用php标签

{php}echo 'Hello,world!';{/php}
1

我们建议需要使用PHP代码的时候尽量采用php标签,因为原生的PHP语法可能会被配置禁用而导致解析错误。

# 使用原生php代码

<?php echo 'Hello,world!'; ?>
1

TIP

注意:php标签或者php代码里面就不能再使用标签(包括普通标签和XML标签)了,因此下面的几种方式都是无效的:

{php}{eq name='name'value='value'}value{/eq}{/php}
1

Php标签里面使用了eq标签,因此无效

{php}if( {$user} != 'ThinkPHP' ) echo  'ThinkPHP' ;{/php}
1

php标签里面使用了{$user}普通标签输出变量 ,因此无效。

{php}if( $user.name != 'ThinkPHP' ) echo  'ThinkPHP' ;{/php}
1

Php标签里面使用了$user.name 点语法变量输出 ,因此无效。

TIP

简而言之,在PHP标签里面不能再使用PHP本身不支持的代码。

如果设置了tpl_deny_php参数为true,就不能在模板中使用原生的PHP代码,但是仍然支持PHP标签输出。

# 自定义标签

ASSIGN标签 ASSIGN标签用于在模板文件中定义变量,用法如下:

{assign name="var" value="123" /}
1

在运行模板的时候,赋值了一个var的变量,值是123

value属性也支持变量,例如:

{assign name="var" value="$val" /}
1

或者直接把系统变量赋值给var变量,例如:

{assign name="var" value="$Think.get.name" /}
1

相当于,执行了:$var = $_GET['name'];

DEFINE标签 DEFINE标签用于中模板中定义常量,用法如下:

{define name="MY_DEFINE_NAME" value="3" /}
1

在运行模板的时候,就会定义一个MY_DEFINE_NAME的常量。

value属性可以支持变量(包括系统变量),例如:

{define name="MY_DEFINE_NAME" value="$name" /}
1

或者

{define name="MY_DEFINE_NAME" value="$Think.get.name" /}
1