主题用于管理官网、购物车和会员中心的显示。当前版本默认使用随包交付的新版主题,后台提供 上传主题、选择主题、编辑主题 三类操作。

三端主题

类型 目录约定 主要用途
home public/themes/web/<name>/ 官网首页与门户内容
clientarea public/themes/clientarea/<name>/ 会员中心
cart public/themes/cart/<name>/ 购物车与购买流程

已安装主题以后台实际扫描结果为准。不同端可分别选择,启用前应确认该主题包含需要的页面与资源。

上传主包

在 主题模板 → 上传主题 中选择或拖入 ZIP 主包,页面显示上传进度。系统会识别支持的子主题结构并放到对应位置,不需要用户拆开主包逐一拷贝。

推荐格式:

主题主包/
├── themes/
│   ├── web/<主题名>/
│   ├── clientarea/<主题名>/
│   └── cart/<主题名>/
└── theme-admin/              可选,第三方主题编辑器

允许主题包存在一层外目录。只应包含主题需要的文件,不要携带业务配置、数据库备份、真实账号或无关程序。

同名主题更新前先备份自定义内容。上传成功不代表所有第三方主题均兼容,应在独立测试站完成检查。

选择与编辑

  • 选择主题:分别检查官网、会员中心和购物车的当前启用项。
  • 编辑主题:修改该主题支持的区块文案、图片和其他配置。
  • 首页模块配置:按主题支持情况调整区块开关和顺序。

站点名称、Logo、图标与客服链接在站点设置中维护;首页区块文案在主题编辑中维护,站点信息中不再另设“首页文案”。

第三方主题自带独立编辑后台时,按其说明完成安装和管理员认证。不要公开配置文件,上传目录禁止执行脚本。

页面路径

页面 新版地址
首页 /home
商店 /store
商品详情 /product/<id>
登录与注册 /login、/register
购物车 /cart
会员中心 /console

访问根域名会进入首页。主题导航应使用以上真实路径,不能再把 /home/#/store、/home/#/login 等旧入口作为独立页面。页面直接访问、刷新和手机菜单都应正常。

站点页脚署名

各页面保留 Powered by Mercuryseek,链接到 https://mall.mercuryseek.cn。

署名属于页脚正常内容,放在页脚右侧;随页面滚动到达页面底部,不能使用悬浮定位遮挡内容。主题作者应保留该署名和链接。

主题开发

可使用主题 CSS、配置变量或受支持的模板扩展。CSS 必须加主题作用域,避免污染其他页面;主题不应修改核心程序或要求替换系统认证流程。

最小样式主题示例:

public/themes/web/mytheme/
├── theme.json
└── theme.css
{
  "title": "我的主题",
  "assets": {
    "css": ["theme.css"],
    "js": []
  }
}

详细格式与样式教程见主题开发教程。已有模板的兼容效果需按主题逐页验证,不能通过恢复旧页面壳来解决样式问题。

检查清单

  • 首页、商店、登录、注册、购物车和会员中心使用预期主题。
  • 站点名称、Logo、导航和页脚正确,图片不被裁切。
  • 商店分组标题滚动时不覆盖顶部菜单。
  • 手机有可用导航,商品和表格不会造成整页横向溢出。
  • 接口返回业务数据,静态资源返回对应文件,不被误写成 HTML 页面。
  • CDN 更新后不继续返回旧入口或旧资源。

相关文档:管理员操作指南 · 主题开发教程

下载文档
原始 Markdown 文件