Skip to contentSkip to main navigation Skip to footer

开发模板

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

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

必备js

自带的 home.js已经做好了很多必备的功能,开发者直接引入既可以使用里面 MAC 对象封装的函数,例如:历史记录、顶踩收藏、访问量统计,评论等等功能,俗称苹果cms模板必备三段。

使用标签

苹果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} 等等。

使用函数

我们往往需要对模板输出变量使用函数,可以使用:

  • 编译后的结果是:
  • 如果函数有多个参数需要调用,则使用:

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

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

表示输出

虽然也可以使用:

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

编译后的结果是:

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

常用处理函数

  • 允许使用多个函数,都使用|分隔开
  • 所有图片地址,不管是远程的本地的都建议使用 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自动绑定处理事件

  • 会员-收藏视频内容
  • 会员-收藏文章内容页
  • 会员-收藏专题内容页

以下内容一般放到body结尾之前,不用于显示,只用户记录信息。

  • 会员-文章浏览记录
  • 会员-专题浏览记录
  • 会员-视频浏览记录
  • 会员-视频播放记录
  • 会员-视频下载记录
  • 视频、文章、专题 顶和踩 通用

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

总点击量:

  • 日点击量:
  • 周点击量:
  • 月点击量:
  • 前台浏览历史记录调用

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

  • 访问页面触发定时任务,建议放到首页底部; 由于入口文件名可变,默认是api.php,如需修改请自定义 data-file=”xxx.php”
  • 网址导航来路记录统计;建议放到首页底部。来路域名必须和网址导航里的跳转url里的一致。
  • 自动获取短网址连接
  • 短网址自定义用法,js来获取
  • 获取用户记录日志,比如1浏览、2收藏、3想看、4点播、5下载
  • MAC.Ulog.Get4个参数type类型0代表全部,page页码,limit每页条数,call回调函数

使用默认值

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

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

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

使用运算符

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

运算符使用示例
+{$a+$b}
{$a-$b}
*{$a*$b}
/{$a/$b}
%{$a%$b}
++{$a++} 或 {++$a}
{$a–} 或 {–$a}
综合判断{$a+$b*10+$c}

在使用运算符的时候,不再支持常规函数用法,例如:

三元运算

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

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

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

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

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

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

模板继承

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

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

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

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

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

一个模板中可以定义任意多个名称标识不重复的区块,例如下面定义了一个base.html基础模板:

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

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

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

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

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

导航部分将是无效的,不会显示在模板中。 模板可以多级继承,比如B继承了A,而C又继承了B,最终C中的区块会覆盖B和A中的同名区块,但C和B中的区块必须是A中已定义过的。 子模板中的区块定义顺序是随意的,模板继承的用法关键在于基础模板如何布局和设计规划了,如果结合原来的布局功能,则会更加灵活。

比较标签

比较标签用于简单的变量比较,复杂的判断条件可以用if标签替换,比较标签是一组标签的集合,基本上用法都一致,如下:

标签含义
eq或者 equal等于
neq 或者notequal不等于
gt大于
egt大于等于
lt小于
elt小于等于
heq恒等于
nheq不恒等于

他们的用法基本是一致的,区别在于判断的条件不同,并且所有的比较标签都可以和else标签一起使用。 例如,要求name变量的值等于value就输出,可以使用:

或者

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

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

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

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

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

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

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

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

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

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

等效于

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

条件判断

SWITCH标签

用法:

使用方法如下:

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

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

表示如果$_GET["type"] 是gifpng或者jpg的话,就判断为图像格式。

Case标签还有一个break属性,表示是否需要break,默认是会自动添加break,如果不要break,可以使用:

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

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

简洁的用法

IF标签

用法示例:

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

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

或者知道user变量是对象

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

这三种写法结果是一样的

范围判断

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

IN和NOTIN

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

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

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

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

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

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

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

BETWEEN 和 NOTBETWEEN

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

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

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

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

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

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

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

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

RANGE

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

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

PRESENT NOTPRESENT标签

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

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

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

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

EMPTY NOTEMPTY 标签

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

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

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

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

DEFINED 标签

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

TIP
name属性的值要注意严格大小写
如果判断没有被定义,可以使用:

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

标签嵌套

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

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

  • 嵌套循环外层分类内部视频或文章,重点在于外部和内部标签各自设置 id 和 key,系统默认都是vo不适合会导致数据冲掉。
  • 嵌套循环一级和二级分类数据

使用PHP

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

使用php标签

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

使用原生php代码

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

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

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

自定义标签

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

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

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

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

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

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

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

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

或者