如何修改PbootCMS的模板？

修改 PbootCMS 模板主要涉及‌更换整套模板风格‌、‌调整模板文件结构‌以及‌微调具体页面内容‌。以下是基于系统机制的详细操作指南：
一、 更换整套模板风格（最常用）

如果你下载了新的模板包，或者想切换不同的设计风格，请按以下步骤操作：

‌上传模板文件‌
通过 FTP 或宝塔面板文件管理器，进入网站根目录下的 /template/ 文件夹。
将新模板文件夹（例如命名为 new_theme）上传至此目录。
‌注意‌：确保新模板文件夹内包含核心文件：index.html（首页）、list.html（列表页）、content.html（详情页）等。

‌后台切换模板‌
登录 PbootCMS 后台。
进入 ‌【全局配置】‌ -> ‌【站点信息】‌（或部分版本在【基本配置】）。
找到 ‌“站点模板”‌ 或 ‌“模板风格”‌ 选项。
在下拉菜单或输入框中，选择或填写你刚才上传的文件夹名称（如 new_theme）。
点击保存。

‌清除缓存‌
切换后若前台显示异常，请在后台右上角点击 ‌“清除缓存”‌，或在浏览器中使用 Ctrl + F5 强制刷新页面。

二、 修改模板子目录结构（进阶管理）

为了更好地区分 PC 端和移动端，或管理多套皮肤，可以设置模板子目录。

‌创建子目录‌
在 /template/默认模板名/ 下新建文件夹，例如 html 或 wap。
将对应的 .html 模板文件移动到新建立的子目录中。

‌配置子目录路径‌
登录后台，进入 ‌【全局配置】‌ -> ‌【安全配置】‌。
找到 ‌“模板子目录”‌ 选项。
填入你创建的子目录名称（如 html）。
保存并清除缓存。
注：若启用独立手机版，需在手机端配置中同样指定对应的 WAP 子目录。

三、 修改具体页面内容（日常维护）

直接编辑 HTML 文件来调整布局、样式或标签调用。

‌定位文件‌
首页：/template/当前模板/index.html
列表页：/template/当前模板/list.html
详情页：/template/当前模板/content.html
单页/关于我们要：通常也是 content.html 或通过 {pboot:if} 判断区分，具体视模板设计而定。

‌编辑代码‌
使用代码编辑器（如 VS Code、Notepad++）打开文件。
‌修改静态内容‌：直接修改 HTML 文本、图片路径、CSS 类名。
‌修改动态数据‌：使用 PbootCMS 标签调用数据。
导航栏：{pboot:nav}…{/pboot:nav}
文章列表：{pboot:list}…{/pboot:list}
当前位置：{pboot:position}
‌资源路径规范‌：引用 CSS/JS/图片时，建议使用系统标签 {pboot:sitetplpath} 以确保路径正确，例如：

html
<link rel=”stylesheet” href=”{pboot:sitetplpath}/css/style.css”>
<img src=”{pboot:sitetplpath}/images/logo.png”>

‌保存与测试‌
保存文件后，刷新前台页面查看效果。
若出现乱码，请确保文件编码为 ‌UTF-8 without BOM‌。

四、 修改默认首页文件名（特殊需求）

如果希望首页不叫 index.html 而叫 home.html：

打开 /apps/home/controller/IndexController.php。
找到 getIndexPage() 方法。
修改代码中的默认值：

php
// 原代码
$template = $this->config(‘home_index_tpl’) ?: ‘index.html’;

// 修改为
$template = $this->config(‘home_index_tpl’) ?: ‘home.html’;

确保模板目录下存在 home.html 文件，并清除缓存。

五、 常见问题与避坑指南
表格
问题现象 可能原因 解决方案
‌页面显示错乱/无样式‌ CSS/JS 路径错误 检查 HTML 中资源链接是否使用了 {pboot:sitetplpath} 标签；检查浏览器控制台报错。
‌修改后不生效‌ 缓存未清除 后台点击“清除缓存”；浏览器强制刷新（Ctrl+Shift+R）；检查服务器是否开启了 OpCache。
‌中文乱码‌ 文件编码不对 使用编辑器将文件另存为 ‌UTF-8 (无BOM)‌ 格式。
‌权限不足‌ 无法生成缩略图或缓存 检查 /runtime/ 和 /static/upload/ 目录权限，建议设置为 755 或 777。
‌移动端显示异常‌ 未适配响应式或未启用独立手机版 检查 CSS 媒体查询；若使用独立手机版，需在后台【全局配置】中启用“独立手机版”并配置对应模板路径。
※开发建议

‌备份先行‌：修改任何模板文件前，务必复制一份副本作为备份。
‌调试模式‌：开发过程中，可在后台【全局配置】中开启“调试模式”，以便查看详细的错误信息。
‌标签参考‌：不熟悉标签用法时，可参考 PbootCMS 官方文档或查看默认模板（default）中的写法进行模仿。