苹果CMS介绍与标签大全

一、苹果CMS简介

苹果CMS（maccms）是一套基于 PHP+MySQL 环境下运行的完善而强大的快速建站系统[reference:0]。系统内置了丰富的 CMS 标签并支持 ThinkPHP 框架标签完美融合，可以调取系统内所有的数据，只要你懂一些前端知识就可以快速开发自己的模板功能[reference:1][reference:2]。

核心特点

环境要求

• PHP 5.6+ / 7.x（推荐 PHP 7.0+）[reference:8]
• MySQL 5.5+ / 5.7+[reference:9][reference:10]
• 服务器：Apache / IIS / Nginx

二、模板目录结构

苹果 CMS 所有模板主题包都规定放在 /template/ 目录下，必须严格遵守标准的目录结构，否则会导致前端访问异常[reference:11]。

│─template/模板目录/
│  ├─info.ini      # 模板信息文件
│  ├─ads/           # 广告文件目录
│  ├─js/            # JavaScript 文件
│  ├─css/           # 样式文件
│  ├─images/        # 图片文件
│  └─html/          # 模板 HTML 文件目录
│     ├─art/        # 文章模块模板
│     ├─comment/    # 评论模块模板
│     ├─gbook/      # 留言本模块模板
│     ├─index/      # 首页模块模板
│     ├─topic/      # 专题模块模板
│     ├─user/       # 用户中心模块模板
│     └─vod/        # 视频模块模板[reference:12]
    

三、标签基础语法

1. 变量输出

2. 列表标签

列表标签由起始标签和结束标签组成，内部变量以 $vo. 开头[reference:17]。

{maccms:vod type="all" num="10" order="desc" by="time"}
    <div>{$vo.vod_name}</div>
{/maccms:vod}

3. 变量作用域

• $obj：详情页（视频详情、文章详情等）代表当前主对象[reference:18]
• $vo：循环列表中的每一条数据[reference:19]
• $parent：分类页二级分类时代表上级分类对象[reference:20]

四、全局配置标签

五、视频模块标签（{maccms:vod}）

最常用的视频数据调用标签，支持丰富的筛选参数。

常用参数

使用示例

{maccms:vod num="10" type="all" order="desc" by="time"}
<div class="video-item">
    <a href="{:mac_url_vod_detail($vo)}" title="{$vo.vod_name}">
        <img src="{$vo.vod_pic|mac_url_img}" alt="{$vo.vod_name}">
        <h3>{$vo.vod_name}</h3>
        <p>主演：{$vo.vod_actor}</p>
    </a>
</div>
{/maccms:vod}

六、文章模块标签（{maccms:art}）

文章数据调用标签，参数结构与视频模块类似。

使用示例

{maccms:art num="8" type="2" order="desc" by="hits"}
<li><a href="{:mac_url_art_detail($vo)}">{$vo.art_name}</a>（{$vo.art_time|date='Y-m-d'}）</li>
{/maccms:art}

七、专题模块标签（{maccms:topic}）

专题列表标签，参数如下[reference:26]：

{maccms:topic num="6" order="asc" by="sort"}
<div class="topic">
    <a href="{:mac_url_topic_detail($vo)}">{$vo.topic_name}</a>
</div>
{/maccms:topic}

八、角色模块标签（{maccms:role}）

角色功能针对影视剧里面虚构人物信息进行收集整理[reference:27]。

常用参数

{maccms:role num="10" rid="'.$obj['vod_id'].'" order="asc" by="sort"}
<div>角色名：{$vo.role_name} | 演员：{$vo.role_actor}</div>
{/maccms:role}

角色字段（详情页 $obj）

九、分类标签（{maccms:type}）

分类标签可以调出后台所有数据分类数据，不限定在某个模板中使用[reference:37]。

{maccms:type num="10" order="asc" by="sort" ids="all"}
<div>分类名称：{$vo.type_name}</div>
{/maccms:type}

十、页面独有标签

1. 分类页标签（$obj）

在分类页模板中可用以下变量获取当前分类信息[reference:38][reference:39]：

2. 视频详情页标签（$obj）

在视频详情页（/html/vod/detail.html）可用以下标签[reference:41]：

十一、常用处理函数

苹果 CMS 提供了一系列实用函数，可大幅简化开发流程[reference:42][reference:43]：

十二、数据统计函数

内置数据统计函数，快速获取各模块数据总量[reference:45][reference:46]：

十三、分页标签

分页标签用于列表页实现内容分页显示，通过 paging="yes" 参数启用。

{maccms:vod num="20" paging="yes" type="current"}
    <!-- 循环输出视频列表，$vo 代表每条数据 -->
    <div class="vod-list-item">{$vo.vod_name}</div>
{/maccms:vod}

<!-- 分页导航栏 -->
{include file="public/pagination"}

十四、条件判断标签（{if}）

苹果 CMS 支持 {if} 条件判断标签，语法与 PHP 类似。

{if $obj.vod_hits > 1000}
    <span class="hot-label">热门</span>
{elseif $obj.vod_hits > 500}
    <span class="warm-label">较热</span>
{else}
    <span class="new-label">普通</span>
{/if}

十五、最佳实践建议

• 图片地址统一处理：所有图片地址都使用 mac_url_img 函数处理，确保地址统一性和可维护性[reference:47]。
• 引入必备 JS：模板开发中应引入系统自带的 home.js，封装了历史记录、顶踩收藏、访问量统计、评论等常用功能[reference:48]。
• 合理使用缓存：通过 cachetime 参数设置自定义缓存时间，提升网站访问速度[reference:49]。
• 注意数据排序：使用二分搜索时确保数据已正确排序，否则可能导致错误结果。
• 遵循模板结构：严格遵守标准的目录结构进行模板创建，避免前端访问异常[reference:50]。
• 避免过深嵌套：多级列表一般不超过3-4级，否则影响阅读。

十六、总结

• 苹果 CMS 基于 PHP+MySQL 环境运行，采用 TP5.x 作为核心框架[reference:51]。
• 支持视频、文章、专题、明星、角色、网址导航等八大模块[reference:52]。
• 模板标签完全支持 TP5 语法，使用 {} 包裹变量[reference:53]。
• 列表标签由起始和结束标签组成，内部变量以 $vo. 开头[reference:54]。
• 提供丰富的数据统计函数和处理函数，大幅简化开发流程[reference:55]。
• 分页、条件判断等标签满足复杂模板需求。
• 建议开发者从视频模块标签开始学习，逐步掌握其他模块的标签用法。