主题用于管理官网、购物车和会员中心的显示。当前版本默认使用随包交付的新版主题,后台提供 上传主题、选择主题、编辑主题 三类操作。
三端主题
| 类型 | 目录约定 | 主要用途 |
|---|---|---|
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 更新后不继续返回旧入口或旧资源。