苹果CMS指南

苹果CMS V10安装模板后,如果前台提示模板文件不存在,可以先检查模板是否放到了网站根目录的 template 文件夹中。模板目录名称建议使用英文小写,并确认目录内部的文件层级没有出现重复嵌套。

检查模板目录结构

进入网站根目录的 template 目录,找到正在使用的模板文件夹。正常情况下,info.ini 和 html 应该直接位于模板目录中,首页模板等文件则放在 html 目录内。

网站根目录
└─ template
   └─ mytpl
      ├─ info.ini
      ├─ html
      │  └─ index.html
      ├─ css
      ├─ js
      └─ images

比较常见的问题是解压后多出一层同名目录,例如 template/mytpl/mytpl/html。这种情况下需要进入内层目录,将实际模板文件调整到正确位置。

同时检查模板目录名称,原有教程要求避免使用中文、空格以及 #、@ 等特殊字符。修改目录名称后,还需要同步检查后台的模板选择设置。

核对后台模板设置

进入苹果CMS后台的系统 → 网站参数配置 → 基本设置,确认“网站模板”选择的是 template 下实际使用的模板文件夹名称,例如 mytpl。

“模板目录”则需要填写模板内部实际使用的目录名称。大多数情况下为 html,如果模板采用了其他目录名称,应以实际文件夹为准。

如果PC端和手机端使用不同模板,还需要分别确认对应设置。完成修改后保存配置,并进入系统 → 缓存管理清空全部缓存,再重新访问前台。

检查服务器文件权限

Linux服务器或宝塔环境下,还可以检查模板目录及文件权限。原有配置建议目录使用 755,文件使用 644。

如果权限设置不正确,程序可能无法正常读取模板文件。使用宝塔时,可以选中 template 目录检查权限,并根据实际情况应用到子目录。

检查模板压缩包

模板上传后还要确认文件是否完整。部分模板压缩包在本地解压后再上传,可能出现目录层级变化或文件名称异常。使用服务器面板直接解压,可以减少这类目录结构问题。

另外检查 info.ini 是否存在,并确认文件不是空文件或已经损坏。如果核心文件缺失,即使后台已经选择了对应模板,也可能无法正常识别。

其他情况

如果目录、后台配置、缓存和权限都没有问题,可以继续检查服务器相关规则。原有教程提到,Nginx不应错误拦截模板目录中的 .html、.ini 文件,防盗链规则也不应阻止 template 目录的正常读取。

还需要确认模板本身适用于苹果CMS V10。V8模板与V10的模板结构存在差异,不能直接按照V10模板的方式使用。如果模板文件包本身缺少必要的HTML文件,也需要重新检查模板文件是否完整。

排查顺序

  1. 确认模板位于 template 目录下。

  2. 检查是否存在多层同名目录。

  3. 确认模板目录中存在 info.ini 和 html。

  4. 核对后台“网站模板”与实际模板目录名称。

  5. 核对“模板目录”与实际目录名称。

  6. 清空系统缓存后重新访问。

  7. 检查目录和文件权限。

  8. 如果只有手机端异常,再单独检查手机模板设置。

  9. 确认模板是否为苹果CMS V10适用模板。

苹果站建议遇到模板文件不存在时按照上述顺序逐项确认,不要直接反复更换模板目录。多数排查工作都可以从文件实际位置和后台对应设置入手。