快速开始
欢迎使用苹果CMS V12！本指南将帮助您快速了解系统并开始搭建您的第一个站点。
五分钟快速体验
- 从下载中心获取最新版安装包
- 上传到支持PHP的服务器并解压
- 访问您的域名，进入安装向导
- 按照提示完成数据库配置
- 登录后台，开始配置您的站点
给新手的建议
如果您是第一次使用苹果CMS，建议先完成基础安装，然后在后台的“演示模式”下体验各项功能，最后再开始正式的内容建设。
安装部署
环境要求
| 组件 | 最低要求 | 推荐配置 |
|---|---|---|
| PHP | 7.4.0 | 8.0+ |
| MySQL | 5.7 | 8.0+ |
| 内存 | 128MB | 256MB+ |
| 磁盘空间 | 100MB | 1GB+ |
完整安装教程
1. 上传文件
将下载的ZIP包解压，将所有文件通过FTP或文件管理器上传到您的网站根目录。
2. 设置权限
# Linux服务器权限设置示例
chmod -R 755 /path/to/your/site
chmod -R 777 /path/to/your/site/runtime
chmod -R 777 /path/to/your/site/public/upload
chmod -R 755 /path/to/your/site
chmod -R 777 /path/to/your/site/runtime
chmod -R 777 /path/to/your/site/public/upload
3. 运行安装向导
在浏览器中访问您的网站域名，系统会自动检测并跳转到安装页面。
4. 数据库配置
填写正确的数据库连接信息：
- 数据库主机（通常为 localhost）
- 数据库名（需提前创建）
- 数据库用户名和密码
- 表前缀（默认为 mac_）
5. 完成安装
设置管理员账号密码，点击“开始安装”，等待系统自动完成初始化。
重要提示
安装完成后，请务必删除或重命名 /install 目录，防止被恶意利用重新安装。
常见安装问题
Q: 安装时提示“数据库连接失败”
A: 请检查：1) 数据库信息是否正确 2) 数据库用户是否有权限 3) 服务器防火墙是否放行3306端口。
Q: 页面显示空白或500错误
A: 开启PHP错误日志，检查runtime目录权限，或查看是否缺少必要的PHP扩展（如pdo_mysql）。
模板开发
模板目录结构
# 默认模板目录结构
template/
├── default/ # 默认模板
│ ├── index.html # 首页模板
│ ├── vod/ # 视频列表/详情页
│ ├── art/ # 文章列表/详情页
│ └── ...
├── config.php # 模板配置文件
└── static/ # 静态资源
template/
├── default/ # 默认模板
│ ├── index.html # 首页模板
│ ├── vod/ # 视频列表/详情页
│ ├── art/ # 文章列表/详情页
│ └── ...
├── config.php # 模板配置文件
└── static/ # 静态资源
常用模板标签
| 标签 | 说明 | 示例 |
|---|---|---|
| {$site_name} | 站点名称 | {$site_name} |
| {mac:vod} | 视频列表调用 | {mac:vod num="10" order="desc" by="time"} |
| {mac:art} | 文章列表调用 | {mac:art num="5" order="desc"} |
| {if condition} | 条件判断 | {if $user.id}...{/if} |
| {volist} | 循环输出 | {volist name="list" id="vo"}...{/volist} |
首页模板示例
<!-- 首页头部 -->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{$site_name} - {$site_subtitle}</title>
<meta name="keywords" content="{$site_keywords}">
</head>
<body>
<!-- 导航栏 -->
{include file="public/header" /}
<!-- 轮播图 -->
{mac:slide type="1" num="5"}
<div class="swiper-slide">
<a href="{$vo.slide_url}">
<img src="{$vo.slide_pic}" alt="{$vo.slide_name}">
</a>
</div>
{/mac:slide}
<!-- 最新视频 -->
<h2>最新视频</h2>
{mac:vod num="12" order="desc" by="time"}
<div class="vod-item">
<a href="{$vo.vod_url}">{$vo.vod_name}</a>
</div>
{/mac:vod}
{include file="public/footer" /}
</body>
</html>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>{$site_name} - {$site_subtitle}</title>
<meta name="keywords" content="{$site_keywords}">
</head>
<body>
<!-- 导航栏 -->
{include file="public/header" /}
<!-- 轮播图 -->
{mac:slide type="1" num="5"}
<div class="swiper-slide">
<a href="{$vo.slide_url}">
<img src="{$vo.slide_pic}" alt="{$vo.slide_name}">
</a>
</div>
{/mac:slide}
<!-- 最新视频 -->
<h2>最新视频</h2>
{mac:vod num="12" order="desc" by="time"}
<div class="vod-item">
<a href="{$vo.vod_url}">{$vo.vod_name}</a>
</div>
{/mac:vod}
{include file="public/footer" /}
</body>
</html>