苹果CMS开发

自定义模板目录搭建

制作独立模板时,在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适配远程附件。修改模板后要清理缓存,否则页面不会更新。

标签:二次开发