苹果CMS指南

模板目录结构校验

模板必须放置在根目录下 template 文件夹内,规范结构为模板文件夹内直接存放 info.ini 和 html 目录,样式、脚本、图片资源分开存放。解压包容易出现嵌套双层同名文件夹,会导致路径读取失败,需要把内层真实模板文件迁移至外层。文件夹命名只推荐小写英文,禁止中文、空格以及特殊符号,改名后后台配置也要同步更新。

后台参数与缓存处理

在后台系统、网站参数配置、基本设置页面,核对网站模板名称和模板子目录参数,常规子目录填写为 html,PC与移动端分开使用模板时两项配置需要单独核对。保存配置之后,前往缓存管理清空全站缓存,再刷新前台页面验证效果。

文件权限与压缩包完整性检查

Linux环境下目录权限推荐设置755,文件权限设置644,权限不足会造成程序读取失败,宝塔面板可以直接对template目录批量应用权限。优先在服务器内解压压缩包,避免本地解压引发目录错乱,同时检查 info.ini 文件是否存在、文件是否损坏。

服务规则与版本兼容校验

Nginx伪静态、防盗链规则不能拦截 .html 和 .ini 文件访问,防止模板文件被拦截。同时区分程序版本,V8模板结构和V10不互通,旧版本模板不能直接在V10中启用。

  1. 确认模板存放位置在template目录下

  2. 排查是否存在多层嵌套文件夹

  3. 核验info.ini与html目录是否存在

  4. 比对后台模板名称配置

  5. 核对模板子目录参数

  6. 清理系统缓存测试前台

  7. 检查服务器文件权限

  8. 移动端异常单独核查手机模板配置

  9. 确认模板适配V10版本