帝国CMS搜索页面模板编辑零基础可直接上手实操完整指南

前置准备

你需要提前完成帝国CMS的安装部署，可正常登录后台，后台默认地址为：你的域名/e/admin，以下操作基于帝国CMS 7.5版本，其他版本操作逻辑完全一致，无需调整。

第一步：找到搜索页面模板入口

帝国CMS将搜索模板归类在模板组内，按以下步骤操作即可找到编辑入口：

• 1. 输入后台地址，填写账号密码完成登录
• 2. 点击左侧导航栏的「模板」分类，展开后点击「模板管理」，再点击进入「模板组管理」页面
• 3. 在模板组列表中，找到你当前站点默认启用的模板组，点击模板右侧的「管理模板」按钮，进入该模板组的所有模板列表

定位搜索相关模板

进入模板列表后，找到「其他模块模板」分类，分类下包含两个搜索相关模板：搜索页面模板（用户访问的搜索入口页，带搜索框）、搜索结果模板（关键词搜索完成后展示结果的页面），点击对应模板右侧的「修改」按钮，即可进入编辑界面。

第二步：核心自定义编辑实操（附可复制代码）

1. 自定义搜索表单

搜索表单是搜索页的核心，以下是完整可自定义的搜索表单代码，可直接替换默认代码，根据需求修改：

```html

搜索

```

关键注意项：如果需要开启全站所有内容搜索，不需要限定模型，直接删除代码中name为tbname的隐藏域即可。

2. 自定义搜索结果列表

搜索结果页核心是结果列表循环，以下是完整可复用的结果列表代码，可直接替换默认模板内容：

```html ```

常用标签说明：[!--titleurl--]为内容链接，[!--title--]为内容标题，[!--smalltext--]为内容简介，[!--newstime--]为发布时间，[!--titlepic--]为内容封面图，所有标签都是帝国CMS原生支持，不需要额外配置。

3. 添加筛选功能

如果需要给搜索添加分类、时间筛选，直接在搜索表单内对应位置插入以下代码即可，帝国CMS原生支持参数解析，不需要修改后端代码：

分类筛选代码：

```html 全部分类 [!--empirenews.class--] [!--classname--] [!--empirenews.class--] ```

时间范围筛选代码：

```html 全部时间 今天 近7天 近30天 近一年 ```

第三步：保存更新确保生效（关键步骤不能漏）

修改完成后，必须按以下顺序操作，否则修改不会在前台生效：

• 1. 点击模板编辑页面下方的「保存模板」按钮，等待系统提示保存成功
• 2. 返回模板组管理页面，找到当前模板组，点击右侧的「更新模板组文件」，等待执行完成
• 3. 最后清理缓存：点击左侧导航栏「系统」->「更新缓存」，点击「更新数据缓存」，完成后即可前往前台查看修改效果。

常见问题排查

• 修改后前台无变化

  90%以上的原因是未更新模板组文件或未清理缓存，按照第三步重新操作即可。如果仍无变化，检查你修改的模板是否对应站点当前启用的模板组，可在「系统设置」->「站点设置」中查看当前默认模板组ID。

• 搜索不到任何结果

  首先检查表单action地址是否正确，必须为[!--news.url--]e/search/index.php；如果指定了模型，检查tbname的表名是否和后台模型管理中的表名一致；另外未审核的内容默认不会被搜索到，确认内容状态为已发布。

• 如何把搜索框加到所有页面头部？

  直接把编辑好的搜索表单代码复制粘贴到公共头部模板，保存更新后即可全站调用，不需要额外配置。