60 lines
3.3 KiB
Markdown
60 lines
3.3 KiB
Markdown
# MING 明命品牌电商站
|
|
|
|
MING 明命陶瓷内胆杯品牌官网与商城的源码仓库。前台主题位于 `ming-theme/`，基于 WordPress 与 WooCommerce，不依赖页面构建器。
|
|
|
|
## 仓库结构
|
|
|
|
```text
|
|
ming-theme/ 可部署的 WordPress 主题源码
|
|
assets/reference/ 非运行时的品牌视觉参考素材
|
|
docs/brief/ 系统说明、业务策略等交付资料
|
|
docs/private/ 本地运维交接资料；已由 .gitignore 排除
|
|
scripts/ 可重复执行的打包脚本
|
|
dist/ 生成的主题 ZIP；不进入 Git
|
|
```
|
|
|
|
## 开发与打包
|
|
|
|
运行环境应使用 PHP 7.4+、WordPress 6.0+ 和 WooCommerce。修改主题时，保持 `ming-theme/functions.php` 中的 `MING_VERSION` 与 `ming-theme/style.css` 的 `Version` 一致。
|
|
|
|
执行以下命令生成可上传的主题包：
|
|
|
|
```bash
|
|
./scripts/package-theme.sh
|
|
```
|
|
|
|
产物为 `dist/ming-theme.zip`，其中包含顶层 `ming-theme/` 目录。
|
|
|
|
## 版本与更新记录
|
|
|
|
主题当前版本为 **1.7.4**。主题版本必须同时更新 `ming-theme/style.css` 的 `Version` 和 `ming-theme/functions.php` 的 `MING_VERSION`；前者供 WordPress 识别主题版本，后者用于 CSS、JS 与字体资源的缓存刷新。
|
|
|
|
| 版本 | 更新内容 |
|
|
|---|---|
|
|
| 1.2.4 | 品牌页面、电商页面与新品投票系统的功能基线。 |
|
|
| 1.5.2 | 订单页增加 BACS 汇款信息卡；重构未登录会员中心为双卡片布局。 |
|
|
| 1.5.3 | 增加移动端汉堡按钮与全屏抽屉导航。 |
|
|
| 1.5.4 | 优化已登录会员中心的移动端导航与内容布局。 |
|
|
| 1.5.5 | 修复移动端订单列表数据被最小宽度挤出屏幕的问题。 |
|
|
| 1.5.6 | 字体改为本地托管的 Noto TC 字体子集，移除 Google Fonts 外链并精简字重。 |
|
|
| 1.6.0 | 增加首页宣传片、站内商品搜索、三栏页脚与启用主题时的信息页初始化。 |
|
|
| 1.7.0 | 增加 OG/Twitter 分享标签、许愿分享、品牌专栏、SKU/色卡体系与海报生成器；同步修复视频、库存与移动端布局。 |
|
|
| 1.7.1 | 协调移动端字体与断行，修复变体库存状态、色卡属性与投票商品过滤。 |
|
|
| 1.7.2 | 修复分享按钮的 `hidden` 状态、色点点击换图/跳转及移动端页脚三栏布局。 |
|
|
| 1.7.3 | 当前主题源码整理与 Git 仓库基线版本；未发现独立的功能变更记录。 |
|
|
| 1.7.4 | 字体、SVG 文字与分享语言标识改为跟随 WordPress 后台“站点语言”：繁中使用自托管 TC 字体，简中、日文、韩文及其他语言使用相应字型回退。 |
|
|
|
|
每次发布必须：更新上述两处版本号、在本表和项目 Agent 文档记录变更、提交 Git、重新打包并验证主题包。
|
|
|
|
## 重要约束
|
|
|
|
- 不提交后台密码、Cookie、API 密钥、生产配置或本地运维交接材料。
|
|
- 主题启用钩子包含历史数据初始化逻辑，可能创建内容、菜单、商品变体与媒体资源；生产环境切换主题前必须先备份并人工确认。
|
|
- 投票、SKU 初始化、海报生成等业务功能目前仍在主题内。后续应逐步迁移至独立插件，避免主题切换影响业务数据。
|
|
|
|
## 首次推送前
|
|
|
|
1. 确认 `git status --ignored` 中没有敏感文件。
|
|
2. 轮换曾出现在旧交接文档中的后台凭据。
|
|
3. 在 Git 平台新建空仓库后，按团队身份配置 Git 用户信息、添加远程地址并推送。
|