苹果CMSV10常用标签、视频文章字段及模板调用方法

苹果CMS V10模板系统提供了丰富的标签和变量，可以用于调用网站基本信息、分类、视频、文章、专题、播放地址、下载地址、分页数据以及会员行为等内容。通过合理使用这些模板标签，可以快速完成影视网站首页、分类页、搜索页、详情页、播放页以及会员中心等页面的数据调用。

本文整理苹果CMS V10常用模板标签，包括全局标签、条件判断、友情链接、留言、评论、分类、专题、视频、文章、分页、处理函数、JavaScript交互标签以及常用的嵌套调用技巧，方便制作和修改苹果CMS V10模板时查询使用。

一、苹果CMS V10全局标签

全局标签可以在模板中调用网站的基本配置和当前页面信息，常用于网站头部、底部、SEO信息以及公共模板文件。

二、常用页面 ID

{$maccms.aid} 可以用于判断当前访问的系统页面，不同页面对应不同的 AID。

三、引入公共模板文件

苹果CMS V10支持通过 include 标签引入公共模板文件，例如网站头部、底部等公共部分可以单独制作，然后在其他模板中重复调用。

{include file="public/head"}

这样可以减少重复代码，也方便后期统一修改网站公共区域。

四、条件判断 if 标签

苹果CMS V10模板中的 if 标签可以使用 PHP 条件表达式进行判断。对于简单的判断，也可以使用 if、elseif 和 else 组合。

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

五、empty 和 notempty 标签

empty 标签用于判断变量是否为空。

{empty name="name"}
name为空值
{/empty}

如果需要判断变量已经存在且不为空，可以使用 notempty。

{notempty name="name"}
name不为空
{/notempty}

六、友情链接标签

友情链接可以通过 maccms:link 标签进行调用。

常用参数包括：

• type：友情链接类型，font 表示文字链接，pic 表示图片链接。

• num：获取友情链接的数量。

{maccms:link num="2" type="pic"}
{$key} 序号
{$vo.link_name} 名称
{$vo.link_url} 地址
{$vo.link_pic} 图片
{/maccms:link}

七、留言本标签

留言本可以使用 maccms:gbook 标签调用。

常用参数：

• num：数据条数，默认值为 10。

• paging：是否开启分页，例如 yes 或 no。

• order：排序方向，例如 desc、asc。

• by：排序依据，例如 id、time。

{maccms:gbook num="10" paging="no" order="desc" by="time"}
{$key} 序号
{$vo.gbook_id} 编号ID
{$vo.gbook_name} 留言昵称
{$vo.gbook_content} 留言内容
{$vo.gbook_reply} 回复内容
{$vo.gbook_ip} 留言者IP
{$vo.gbook_time} 留言时间
{$vo.gbook_replytime} 回复时间
{/maccms:gbook}

八、评论标签

评论数据可以使用 maccms:comment 标签调用。

{maccms:comment num="10" paging="no" order="desc" by="time"}
{$key} 排序位
{$vo.comment_id} 编号ID
{$vo.comment_name} 评论昵称
{$vo.comment_content} 评论内容
{$vo.comment_ip} 评论者IP
{$vo.comment_time} 评论时间
{$vo.childs} 回复评论项
{/maccms:comment}

九、分类标签

maccms:type 可以用于调用视频和文章分类数据。

常用参数包括：

• order：排列顺序，desc 倒序、asc 正序。

• by：排序依据。

• start：从第几条开始。

• num：获取数据条数。

• ids：指定分类，例如 all、parent、child 或指定分类 ID。

• flag：指定模块，例如 vod 表示视频，art 表示文章。

{maccms:type num="10" order="asc" by="sort" ids="all"}
{$key} 序号
{$vo.type_id} 分类ID
{$vo.type_name} 分类名称
{:mac_url_type($vo)} 分类链接
{/maccms:type}

在分类列表循环中，当前分类数据通常使用 $vo。如果是在分类详情页面，则使用 $obj 获取当前分类对象。

十、分类页独有标签

在分类页面中，可以通过 $obj 获取当前分类信息。

十一、专题列表标签

专题列表可以使用 maccms:topic 标签进行调用。

常用参数包括排序、数量、指定 ID、添加时间、点击时间、更新时间以及点击量筛选等。

{maccms:topic num="10" paging="no" order="asc" by="sort" ids="all"}
{$key} 序号
{$vo.topic_id} 专题ID
{$vo.topic_name} 专题名称
{:mac_url_topic_detail($vo)} 专题详情链接
{/maccms:topic}

时间筛选可以使用 -1 day、-1 week、-1 month、-1 hour 等形式。例如：

{maccms:topic num="10" timeadd="-1 week" order="desc" by="time"}

点击量条件可以使用 gt、lt 和 between 等条件，例如：

hitsmonth="gt 1000"
hitsweek="lt 1000"
hitsday="between 1000,2000"

十二、专题页独有标签

十三、剧情分类、地区、语言、年代、版本和资源标签

苹果CMS V10可以分别通过不同的标签调用剧情分类、地区、语言、年代、版本和资源状态。

1. 剧情分类标签

{maccms:class num="10" order="desc"}
{$key} 序号
{$vo.class_name} 分类名称
{$vo.class_link} 链接
{/maccms:class}

2. 地区标签

{maccms:area num="5" order="desc"}
{$key} 排序位
{$vo.area_name} 地区名称
{$vo.area_link} 链接地址
{/maccms:area}

3. 语言标签

{maccms:lang num="5" order="desc"}
{$key} 排序位
{$vo.lang_name} 语言名称
{$vo.lang_link} 链接地址
{/maccms:lang}

4. 年代标签

{maccms:year num="5" order="desc"}
{$key} 排序位
{$vo.year_name} 年代名称
{$vo.year_link} 链接地址
{/maccms:year}

5. 版本标签

{maccms:version num="5" order="desc"}
{$key} 排序位
{$vo.version_name} 版本名称，例如高清版、剧场版
{$vo.version_link} 链接地址
{/maccms:version}

6. 资源标签

{maccms:state num="5" order="desc"}
{$key} 排序位
{$vo.state_name} 状态名称，例如正片、预告片
{$vo.state_link} 链接地址
{/maccms:state}

十四、视频列表标签

maccms:vod 是苹果CMS V10中最常用的视频数据调用标签之一，可以按照分类、标签、地区、语言、年代、推荐等级、更新时间以及点击量等条件筛选视频。

常用参数包括：

• order：排序方向。

• by：排序字段。

• start：起始位置。

• num：获取数量。

• ids：指定视频 ID。

• type：指定分类。

• class：扩展分类。

• tag：Tag 标签。

• level：推荐等级。

• area：地区。

• lang：语言。

• year：年代。

• state：资源类别。

• version：资源版本。

• weekday：更新周期。

• rel：关联数据。

• timeadd：添加时间条件。

• timehits：点击时间条件。

• time：更新时间条件。

• hitsmonth：月点击量条件。

• hitsweek：周点击量条件。

• hitsday：日点击量条件。

• hits：总点击量条件。

• paging：是否开启分页。

• pageurl：分页地址。

{maccms:vod num="10" paging="no" type="all" order="asc" by="sort"}
{$key} 序号
{$vo.vod_id} 视频ID
{$vo.vod_name} 视频名称
{:mac_url_vod_detail($vo)} 视频详情链接
{/maccms:vod}

在视频列表循环中，当前数据通常使用 $vo；而在视频详情页，则通常使用 $obj。

十五、视频内容页独有标签

视频详情页通过 $obj 获取当前视频对象。以下是常用的视频字段。

十六、视频详情页和播放页调用播放地址

可以通过 obj.vod_play_list 循环当前视频的播放组和剧集信息。

{maccms:foreach name="obj.vod_play_list" id="vo"}
<div class="ui-box marg" id="playlist_{$key}">
    <div class="down-title">
        <h2>{$vo.from}-在线播放</h2>
        <span>[{$vo.player_info.tip}]</span>
    </div>
    <div class="video_list fn-clear">
        {maccms:foreach name="vo.urls" id="vo2"}
        <a href="{:mac_url_vod_play($obj,['sid'=>$vo.sid,'nid'=>$vo2.nid])}">{$vo2.title}</a>
        {/maccms:foreach}
    </div>
</div>
{/maccms:foreach}

十七、列出视频下载地址

下载地址可以使用 obj.vod_down_list 进行循环调用，整体结构与播放地址调用方式类似。

{maccms:foreach name="obj.vod_down_list" id="vo"}
<div class="ui-box marg" id="downlist_{$key}">
    <div class="down-title">
        <h2>{$vo.from}-下载</h2>
        <span>[{$vo.player_info.tip}]</span>
    </div>
    <div class="video_list fn-clear">
        {maccms:foreach name="vo.urls" id="vo2"}
        <a href="{:mac_url_vod_down($obj,['sid'=>$vo.sid,'nid'=>$vo2.nid])}">{$vo2.title}</a>
        {/maccms:foreach}
    </div>
</div>
{/maccms:foreach}

十八、播放器详细信息

在播放组循环过程中，可以通过 $vo.player_info 获取播放器相关信息。

十九、视频播放页独有标签

在视频播放页中，可以通过 $param 获取当前播放组和当前集数参数。

下载页获取播放组及集数信息时，可以将 vod_play_list 替换为 vod_down_list，其他参数按照实际页面结构使用。

二十、获取与当前视频关联的视频和文章

苹果CMS V10支持通过 vod_rel_vod 和 vod_rel_art 调用当前视频关联的视频及文章。

<h2>与<strong>“{$obj.vod_name}”</strong>关联的视频</h2>
<ul class="img-list dis">
{maccms:vod num="6" rel="' .$obj['vod_rel_vod']. '" order="desc" by="time"}
    <li>
        <a href="{:mac_url_vod_detail($vo)}" title="{$vo.vod_name}">
            <img src="{:mac_url_img($vo.vod_pic)}" alt="{$vo.vod_name}">
            <h2>{$vo.vod_name}</h2>
            <p></p>
            <i>{$vo.vod_version}</i>
            <em></em>
        </a>
    </li>
{/maccms:vod}
</ul>

<h2>与<strong>“{$obj.vod_name}”</strong>关联的文章</h2>
<ul class="img-list dis">
{maccms:art num="6" rel="' .$obj['vod_rel_art']. '" order="desc" by="time"}
    <li>
        <a href="{:mac_url_art_detail($vo)}" title="{$vo.art_name}">
            <img src="{:mac_url_img($vo.art_pic)}" alt="{$vo.art_name}">
            <h2>{$vo.art_name}</h2>
            <p></p>
            <i>{$vo.vod_from}</i>
            <em></em>
        </a>
    </li>
{/maccms:art}
</ul>

二十一、文章列表标签

maccms:art 用于调用文章列表数据，其常用参数与视频列表标签比较接近。

• order：排序方向。

• by：排序依据。

• start：起始位置。

• num：获取数量。

• ids：指定文章 ID。

• type：指定文章分类。

• class：扩展分类。

• tag：Tag 标签。

• level：推荐等级。

• rel：关联数据。

• timeadd：添加时间。

• timehits：点击时间。

• time：更新时间。

• hitsmonth：月点击量。

• hitsweek：周点击量。

• hitsday：日点击量。

• hits：总点击量。

• paging：是否分页。

• pageurl：分页地址。

{maccms:art num="10" paging="no" type="all" order="asc" by="sort"}
{$key} 序号
{$vo.art_id} 文章ID
{$vo.art_name} 文章标题
{:mac_url_art_detail($vo)} 文章详情链接
{/maccms:art}

二十二、文章内容页独有标签

二十三、获取与当前文章关联的视频和文章

文章详情页可以通过 art_rel_vod 和 art_rel_art 调用相关联的视频和文章。

<h2>与<strong>“{$obj.art_name}”</strong>关联的视频</h2>
<ul class="img-list dis">
{maccms:vod num="6" ids="' .$obj['art_rel_vod']. '" order="desc" by="time"}
    <li>
        <a href="{:mac_url_vod_detail($vo)}" title="{$vo.vod_name}">
            <img src="{:mac_url_img($vo.vod_pic)}" alt="{$vo.vod_name}">
            <h2>{$vo.vod_name}</h2>
            <p></p>
            <i>{$vo.vod_version}</i>
            <em></em>
        </a>
    </li>
{/maccms:vod}
</ul>

<h2>与<strong>“{$obj.art_name}”</strong>关联的文章</h2>
<ul class="img-list dis">
{maccms:art num="6" ids="' .$obj['art_rel_art']. '" order="desc" by="time"}
    <li>
        <a href="{:mac_url_art_detail($vo)}" title="{$vo.art_name}">
            <img src="{:mac_url_img($vo.art_pic)}" alt="{$vo.art_name}">
            <h2>{$vo.art_name}</h2>
            <p></p>
            <i>{$vo.vod_from}</i>
            <em></em>
        </a>
    </li>
{/maccms:art}
</ul>

二十四、分页标签详解

分页标签可以用于分类页、筛选页、搜索页、文章内容页、留言本、评论、专题首页等需要分页的数据页面。

使用分页功能的前提是对应的数据标签开启 paging="yes"，同时建议明确指定 pageurl，以匹配当前页面的分页路由。

{maccms:vod num="10" paging="yes" pageurl="vod/type"}{/maccms:vod}

常见分页地址包括：

系统提供 $__PAGING__ 分页变量，可以用于制作自定义分页样式。

<div class="mac_pages">
    <div class="page_tip">
        共{$__PAGING__.record_total}条数据，当前{$__PAGING__.page_current}/{$__PAGING__.page_total}页
    </div>

    <div class="page_info">
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=1}" title="首页">首页</a>
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=$__PAGING__.page_prev}" title="上一页">上一页</a>

        {maccms:foreach name="$__PAGING__.page_num" id="num"}
        {if condition="$__PAGING__['page_current'] eq $num"}
        <a class="page_link page_current" href="javascript:;" title="第{$num}页">{$num}</a>
        {else}
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=$num}" title="第{$num}页">{$num}</a>
        {/if}
        {/maccms:foreach}

        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=$__PAGING__.page_next}" title="下一页">下一页</a>
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=$__PAGING__.page_total}" title="尾页">尾页</a>

        <input class="page_input" type="text" placeholder="页码" id="page" autocomplete="off" style="width:40px">
        <button class="page_btn mac_page_go" type="button"
            data-url="{$__PAGING__.page_url}"
            data-total="{$__PAGING__.page_total}"
            data-sp="{$__PAGING__.page_sp}">GO</button>
    </div>
</div>

二十五、视频搜索页参数和标签

视频搜索页可以通过 $param 获取当前搜索条件。常用搜索参数包括：

搜索页面常用独有标签：

{$param.page} 当前页码
{$param.wd} 关键字
{$param.area} 地区
{$param.lang} 语言
{$param.year} 年代
{$param.actor} 演员
{$param.director} 导演
{$param.class} 扩展分类

二十六、常用处理函数

苹果CMS V10模板支持使用多个处理函数，并通过 | 分隔，可以对同一个变量进行连续处理。

多个处理函数可以连续使用，例如：

{$vo.vod_content|mac_filter_html|mac_substring=100}

二十七、常用会员和 JavaScript 处理标签

苹果CMS V10前台很多交互功能通过元素的 class 自动绑定 JavaScript 事件，因此模板只需要按照规定的数据属性生成对应 HTML 元素即可。

1. 会员收藏视频

<a href="javascript:;" class="mac_ulog" data-type="2" data-mid="{$maccms.mid}" data-id="{$obj.vod_id}">我要收藏</a>

2. 会员收藏文章

<a href="javascript:;" class="mac_ulog" data-type="2" data-mid="{$maccms.mid}" data-id="{$obj.art_id}">我要收藏</a>

3. 会员收藏专题

<a href="javascript:;" class="mac_ulog" data-type="2" data-mid="{$maccms.mid}" data-id="{$obj.topic_id}">我要收藏</a>

4. 记录会员浏览、播放和下载行为

<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>

5. 顶和踩

<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="{$obj.vod_id}{$obj.art_id}{$obj.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>

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>

日点击量：<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>

7. 前台浏览历史记录调用

<a href="javascript:;" class="mac_history">历史记录</a>

8. 写入视频、文章、专题浏览历史

<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>

二十八、AJAX 数据接口

苹果CMS V10预留了 AJAX 数据接口，可以用于瀑布流等前端加载方式。

示例接口：

index.php/ajax/data.html?mid=1&page=1&limit=10

实际使用时应结合网站自身的 AJAX 请求方式和前端代码进行调用，同时注意对请求参数进行合理限制。

二十九、常用标签技巧：循环中获取分类数据量

在分类循环中，可以直接通过分类 ID 配合 mac_data_count 获取对应分类的视频或文章数量。

{maccms:type ids="1,2,3,4" order="asc" by="sort" id="vo1" key="key1"}
分成：{$vo1.type_name}；总数量：{$vo1.type_id|mac_data_count=all}；今日数量：{$vo1.type_id|mac_data_count=today}。
{/maccms:type}

三十、常用标签技巧：嵌套循环分类与视频

如果需要在外层分类循环中继续调用该分类下的视频，需要注意外层和内层循环分别设置 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}

这里外层分类使用 vo1，内层视频使用 vo2，可以避免两个循环同时使用 $vo 导致数据被覆盖。

三十一、苹果CMS V10模板标签使用注意事项

苹果CMS V10模板标签需要结合具体页面环境使用。同一个字段在列表页和详情页中的调用方式可能不同，最常见的区别就是列表循环使用 $vo，详情页使用 $obj。

制作模板时，如果不确定当前对象包含哪些字段，可以在测试环境中使用 print_r 等方式查看实际数据结构，再根据当前页面返回的数据选择对应变量。

对于播放、下载、分页以及会员行为等功能，还需要确保网站对应的 JavaScript 文件正常加载，否则即使模板标签写法正确，前台交互功能也可能无法正常工作。

三十二、总结

苹果CMS V10模板标签涵盖范围较广，从网站全局配置、分类和专题，到视频、文章、播放下载、分页、会员收藏、历史记录以及 AJAX 数据接口，都可以通过对应标签完成数据调用。

在实际制作苹果CMS V10模板时，建议重点掌握 $maccms、$obj、$vo、$param 和 $__PAGING__ 这几个核心变量，并熟悉 maccms:vod、maccms:art、maccms:type、maccms:topic 等常用数据标签。

掌握这些基础标签后，就可以根据不同页面的数据结构组合调用，从而快速制作和修改苹果CMS V10影视模板。