主题(Theme)
决定整站视觉的代码包。包含布局、颜色、组件、首页结构。
本组文档面向开发者——不是运营。如果你只是用 BangNiCMS 不开发扩展,可以跳过这组。
主题(Theme)
决定整站视觉的代码包。包含布局、颜色、组件、首页结构。
插件(Plugin)
扩展具体功能的小代码包。如客服浮窗、订阅、统计、轮播图。
模型包(Model Package)
给内容追加字段的扩展。比如给产品加”型号”、“规格”等行业字段。
自定义集成
通过 API 集成第三方系统(CRM、ERP、邮件服务)。
| 层 | 技术 |
|---|---|
| 前台 / 主题 | Astro + React + TypeScript |
| 后台 / 管理 | Next.js + React + TypeScript |
| 后端 / API | NestJS + TypeScript |
| 数据库 | PostgreSQL(默认) / MySQL |
| ORM | Prisma |
| 存储 | 本地文件系统 / OSS / S3 |
| 包管理 | pnpm Workspaces |
| 文档 | 内容 |
|---|---|
| API 总览 | REST API 入口、认证、版本 |
| 主题开发 | 主题包结构、模板系统、Slot 机制 |
| 插件开发 | 插件包结构、Hooks、Slot 渲染 |
| 模型包开发 | 字段定义、迁移、验证 |
| 本地开发环境 | 搭建开发环境 |
| 打包与发布 | 打包 zip、发布、分发 |
| 贡献指南 | 提 PR、报 bug、社区规范 |
1. 先用 BangNiCMS 当用户体验一遍 ↓2. 看运营文档了解功能 ↓3. 看本组的 [API 总览] ↓4. 搭建本地开发环境 ↓5. 先做小修改:改主题颜色 / 加 1 个字段1. 看 [主题开发] 完整文档 ↓2. fork 内置主题修改 ↓3. 打包 + 安装到自己站点 ↓4. 学 [插件开发]1. 阅读官方主题源码 ↓2. 写复杂插件(如 CRM 集成) ↓3. 贡献到官方升级 BangNiCMS 时,老的主题 / 插件应该仍然工作。
把可变的配置暴露给运营,避免硬编码(详见 插件配置)。
所有用户可见文案支持 i18n——不要硬编码”Submit”按钮。
延迟加载、CDN、缓存——做好性能。