39 lines
1.6 KiB
Markdown
39 lines
1.6 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/` 目录。
|
|
|
|
## 重要约束
|
|
|
|
- 不提交后台密码、Cookie、API 密钥、生产配置或本地运维交接材料。
|
|
- 主题启用钩子包含历史数据初始化逻辑，可能创建内容、菜单、商品变体与媒体资源；生产环境切换主题前必须先备份并人工确认。
|
|
- 投票、SKU 初始化、海报生成等业务功能目前仍在主题内。后续应逐步迁移至独立插件，避免主题切换影响业务数据。
|
|
|
|
## 首次推送前
|
|
|
|
1. 确认 `git status --ignored` 中没有敏感文件。
|
|
2. 轮换曾出现在旧交接文档中的后台凭据。
|
|
3. 在 Git 平台新建空仓库后，按团队身份配置 Git 用户信息、添加远程地址并推送。
|