PHPCMS 的首页模板文件主要存放在 phpcms/templates/ 目录下。

phpcms 二次开发 首页模板在哪里
（图片来源网络，侵删）

下面我们分几个部分来详细说明：

核心位置：模板目录结构

PHPCMS 的模板系统基于目录结构来组织，默认情况下，所有模板文件都位于：

/phpcms/
└── templates/
    └── default/      <-- 默认模板文件夹
        ├── index/    <-- 首页相关的模板文件夹
        │   └── index.html  <-- 这就是最核心的首页模板文件！
        ├── list/     <-- 列页页模板文件夹
        ├── show/     <!-- 内容页模板文件夹
        └── ...       <!-- 其他模块的模板文件夹

关键点解释：

  1. /phpcms/templates/：这是所有网站模板的根目录。
  2. /phpcms/templates/default/：这是系统默认使用的模板文件夹，如果你没有在后台切换过模板，那么网站使用的就是这里的文件。
  3. /phpcms/templates/default/index/：专门用于存放首页相关模板的文件夹，虽然最核心的 index.html 但首页可能还会调用其他模块的模板片段。
  4. /phpcms/templates/default/index/index.html：这就是你正在寻找的首页模板文件，你直接编辑这个 HTML 文件，就可以改变首页的布局和内容。

如何找到并修改你的首页模板

步骤 1：确认你使用的模板名称

最稳妥的方法不是直接去 default 文件夹，而是通过后台确认。

phpcms 二次开发 首页模板在哪里
（图片来源网络，侵删）
  1. 登录你的 PHPCMS 后台。
  2. 进入 -> 模板风格。
  3. 你会看到一个列表,显示了当前网站正在使用的模板名称，默认是 default，如果你自定义过，这里会显示你的自定义模板名（mytemplate）。

记住这个 “目录名”，这就是你真正要找的模板文件夹。

步骤 2：通过 FTP 或文件管理器访问文件

使用 FTP 工具（如 FileZilla, WinSCP）或你的虚拟主机提供的文件管理器，登录到你的网站服务器根目录（通常是 public_html 或 www）。

步骤 3：定位到正确的模板文件

根据步骤 1 中确认的模板目录名，导航到对应的文件夹：

/phpcms/templates/[你的模板目录名]/index/index.html

如果你使用的模板是 default，那么路径就是： /phpcms/templates/default/index/index.html

phpcms 二次开发 首页模板在哪里
（图片来源网络，侵删）

将这个 index.html 文件下载到你的电脑上，用 VS Code、Sublime Text、Dreamweaver 等代码编辑器打开它进行修改。

index.html 文件里有什么？如何理解它？

打开 index.html，你看到的将是一个混合了 HTML 和 PHPCMS 特定标签的文件。

  1. HTML/CSS/JS 代码：这是网页的骨架和样式，和你平时写的静态网页一样。
  2. PHPCMS 模板标签：这是 PHPCMS 的核心，用于动态调用数据库中的内容，它们通常用 大括号包围。

常见的首页模板标签示例：

  • 调用站点信息：

    <meta name="keywords" content="{$SEO['keyword']}">
<meta name="description" content="{$SEO['description']}">

    这部分通常在 <head> 标签内，用于动态设置网站的标题、关键词和描述。

  • 调用导航菜单：

    {pc:content action="category" catid="0" num="10" order="listorder ASC"}
<ul>
    {loop $data $r}
    <li><a href="{$r[url]}">{$r[catname]}</a></li>
    {/loop}
</ul>
{/pc}

    这段代码会调用顶级栏目（catid="0"）并循环输出，生成主导航。

  • 调用指定栏目内容（如“公司新闻”）：

    {pc:content action="lists" catid="5" num="5" order="id DESC"}
<div class="news-list">
    {loop $data $r}
    <div class="news-item">
        <h3><a href="{$r[url]}">{$r[title]}</a></h3>
        <p class="date">{date('Y-m-d', $r[updatetime])}</p>
        <p class="summary">{str_cut($r[description], 100)}</p>
    </div>
    {/loop}
</div>
{/pc}
    • catid="5"：这是“公司新闻”栏目的 ID，你需要去后台“内容”->“内容频道管理”里找到你的栏目并记下其 ID。
    • num="5"：调用 5 条新闻。
    • order="id DESC"：按 ID 降序排列（即最新的在最前面）。
    • {$r[title]}。
    • {$r[url]}：文章链接。
    • {$r[description]}：

修改后的模板如何生效？

当你修改完 index.html 文件并重新上传到服务器后，刷新你的网站首页，就能看到变化了。

重要提示：

  • 开启模板缓存：PHPCMS 默认开启模板缓存以提高性能，如果你修改了模板但看不到效果，请进入后台 设置 -> 系统基本参数 -> 性能选项，找到 “模板缓存” 并设置为 “关闭”，修改完成后再开启，或者，直接清空缓存。
  • 权限问题：确保你上传的 index.html 文件具有正确的读写权限（通常是 644）。

进阶：使用不同的首页模板

你可能希望首页有不同的风格（一个电脑版首页，一个手机版首页，或者一个活动专题首页）。

  1. 创建新的首页模板文件： 在 /phpcms/templates/[你的模板目录名]/index/ 目录下，创建一个新的 HTML 文件，index_m.html (手机版) 或 index_event.html (活动版)。

  2. 修改 index.php 文件： 在同一个目录下，有一个 index.php 文件，这个文件负责决定最终调用哪个 index.html 模板。 你可以修改这个 PHP 文件，根据不同条件加载不同的模板。

    示例：根据手机类型加载不同首页

    <?php
// 引入公共函数库
pc_base::load_sys_class('format', '', 0);
// 检测是否为移动设备
if (format::is_mobile()) {
    // 如果是手机，加载手机版首页
    include template('index', 'index_m'); // 对应 index_m.html
} else {
    // 如果是电脑，加载默认首页
    include template('index', 'index'); // 对应 index.html
}
?>

    通过修改 index.php 的逻辑，你可以实现非常灵活的首页切换功能。

问题 答案
首页模板文件在哪里？ /phpcms/templates/default/index/index.html (假设使用默认模板)
如何确定具体位置？ 后台查看“模板风格”确认目录名。
通过 FTP 访问 /phpcms/templates/[你的目录名]/index/index.html。
文件里是什么？ HTML 代码 + PHPCMS 模板标签（如 {pc}、{loop}）。
修改后如何生效？ 直接刷新网站即可，如果没变化，请清空后台缓存或关闭模板缓存。
如何制作不同风格的首页？ 在 index 目录下创建新的 .html 文件（如 index_v2.html），然后修改 index.php 来加载它。

希望这个详细的解答能帮助你顺利完成 PHPCMS 首页的二次开发！