苹果CMS V10自定义模板二次开发入门教程
自定义模板目录搭建
制作独立模板时,在template目录下新建模板文件夹theme_tpl,目录内划分css、js、html三个子目录,html用来存放所有页面模板文件。开发需要掌握HTML、CSS、JavaScript基础,缺少前端基础很难完成页面定制。
└─ template └─ theme_tpl ├─ css ├─ js └─ html
模板必备JS引入代码
home.js封装了站点常用交互逻辑,收藏、浏览记录、顶踩、统计、评论功能都依赖它,开发页面必须引入下面三段代码。
<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>模板标签基础使用
苹果CMS V10沿用ThinkPHP5模板语法,变量使用大括号包裹,数组支持点写法。列表标签成对使用,循环读取数据库数据,循环内默认使用$vo作为变量前缀。
基础变量示例:{$maccms.site_name};视频列表标签 {maccms:vod type="all" num="10"}{/maccms:vod},循环字段 {$vo.vod_name}、{$vo.vod_id}。
变量调用函数过滤
变量输出时可以通过竖线调用处理函数。多参数场景用###占位符指代当前变量,也支持连续链式调用多个处理函数,执行顺序从左到右。
{$data.name|md5}{$create_time|date="y-m-d",###}{$data.name|substr=0,3}{$name|md5|strtoupper|substr=0,3}也可以用冒号写法直接执行PHP函数:
{:substr(strtoupper(md5($name)),0,3)}可调用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,读取该分类当日更新数量
{:mac_url('map/index')}:生成站内路由链接
{$obj.vod_content|mac_url_content_img}:把内容内mac协议图片转为http链接
{$vo.vod_content|mac_substring=100}:截取指定长度文本
{$vo.vod_content|mac_filter_html}:清除内容中的HTML标签
{$vo.actor|mac_url_create='actor','vod','search',''}:批量生成演员、标签搜索链接
{$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交互标签(home.js封装)
依靠HTML class绑定事件,不用额外编写JS,直接嵌入页面即可实现收藏、浏览记录、顶踩、访问统计功能。
收藏功能
<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>写入浏览记录(隐藏标签)
<span style="display:none" class="mac_ulog_set" data-type="1" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}"></span>顶踩功能
<a class="digg_link" data-id="{$obj.vod_id}" data-mid="{$maccms.mid}" data-type="up" href="javascript:;">顶<em class="digg_num">{$obj.vod_up}</em></a>
<a class="digg_link" data-id="{$obj.vod_id}" data-mid="{$maccms.mid}" data-type="down" href="javascript:;">踩<em class="digg_num">{$obj.vod_down}</em></a>访问量统计标签
<span class="mac_hits hits" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}" data-type="hits"></span>
<span class="mac_hits hits_day" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}" data-type="hits_day"></span>
<span class="mac_hits hits_week" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}" data-type="hits_week"></span>
<span class="mac_hits hits_month" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}" data-type="hits_month"></span>前台历史记录入口
<a href="javascript:;" class="mac_history">浏览历史</a>
变量默认值输出
字段为空时展示预设文本,使用 |default 语法。
{$obj.vod_actor|default="暂无演员信息"}模板运算符
模板支持四则运算、取模、自增自减,运算符表达式不能搭配过滤函数。
| 运算符 | 示例写法 |
| + | {$a + $b} |
| - | {$a - $b} |
| * | {$a * $b} |
| / | {$a / $b} |
| % | {$a % $b} |
| 自增 | {$a++} 、{++$a} |
| 自减 | {$a--} 、{--$a} |
三元运算符
{$status?'正常':'错误'}{$varname.aa ?? '默认内容'}{$varname ?: '无数据'}模板继承block
继承机制适合统一复用头部、底部公共区块,父模板定义block,子模板使用extend继承并重写区块内容;{__block__}用来保留父模板原有内容。
{block name="title"}<title>网站标题</title>{/block}子模板继承写法:
{extend name="base" /}
{block name="title"}<title>页面标题</title>{/block}比较标签
| 标签 | 作用 |
| eq / equal | 等于 |
| neq / notequal | 不等于 |
| gt | 大于 |
| egt | 大于等于 |
| lt | 小于 |
| elt | 小于等于 |
| heq | 恒等于 |
| nheq | 不恒等于 |
{eq name="vo.vod_id" value="100"}匹配成功{else/}不匹配{/eq}条件判断标签
switch标签
{switch name="$vo.type_id"}
{case value="1"}分类一{/case}
{case value="2"}分类二{/case}
{default /}其他分类
{/switch}if标签
{if condition="$vo.vod_id gt 100"}大于100{elseif condition="$vo.vod_id eq 50"/}等于50{else /}其他{/if}范围判断标签
in、notin 判断变量是否在指定集合;between、notbetween 判断数值是否落在区间内。
{in name="id" value="1,2,3"}命中{else/}未命中{/in}{between name="id" value="1,10"}区间内{else/}区间外{/between}变量存在、空值判断
present / notpresent:检测变量是否已定义
empty / notempty:检测变量内容是否为空
defined / notdefined:检测常量是否定义
{empty name="vo.vod_name"}内容为空{else/}有内容{/empty}标签嵌套循环
多层循环时,每一层循环的id标识必须不同,防止变量覆盖,造成数据错乱。
{maccms:type id="vo1"}
{maccms:vod type="$vo1.type_id" id="vo2"}
{$vo1.type_name}:{$vo2.vod_name}
{/maccms:vod}
{/maccms:type}模板内写PHP代码
推荐使用 {php}{/php} 标签嵌入代码,PHP标签内部不能嵌套模板标签语法。
{php}echo '测试输出';{/php}模板内部自定义变量
assign 在页面内自定义变量:
{assign name="num" value="10" /}define 用来定义常量:
{define name="PAGE_SIZE" value="20" /}开发总结
V10模板引擎基于ThinkPHP5,开发核心是掌握系统标签与内置处理函数。新建模板先要搭建目录结构,home.js脚本不可省略。多层循环需要区分id参数避免冲突,图片输出统一使用mac_url_img适配远程附件。修改模板后要清理缓存,否则页面不会更新。
