跳转到内容

主题总览

「主题」决定前台访客看到的样子——首页布局、配色、字体、Header 与 Footer 结构、产品 / 文章卡片样式……

后台入口:扩展市场 → 主题 Tab

待补充截图 网格式展示所有主题:内置主题 + 第三方主题,每张卡片含名称 / 截图 / 状态 / 操作按钮
后台「扩展市场 → 主题」页全貌
  • 整体布局:Header / Footer / 边栏 / 内容区的排版
  • 配色方案:主色、辅色、背景、文字色(通常支持深浅模式切换)
  • 字体方案:主标题字体、正文字体
  • 首页结构:Hero 区、精选产品、行业洞察等模块
  • 组件样式:按钮、卡片、表单、菜单的视觉
  • 交互动效:页面切换、滚动、点击反馈
  • 响应式:手机 / 平板 / 桌面三端适配
维度内置主题第三方主题
来源系统自带(开箱即用)你上传的 .zip
能否禁用❌ 不能(确保前台永远能渲染)✅ 可以
能否卸载❌ 不能✅ 可以(先切换走)
能否修改源码不建议可以(自己开发)
质量保证官方保证取决于开发者

内置主题是”保命兜底”——即使你装的第三方主题崩了 / 删错了,前台仍能用内置主题渲染,不会出现整站白屏。

整站有且只有一个 active 状态的主题

切换时:

  • 当前 active 主题 → 自动降为 disabled
  • 新选的主题 → 升为 active
  • 切换是原子的——不会出现”两个主题同时生效”的混乱状态

多数主题都暴露了颜色与字体的设置项——后台「主题设置」面板里改。详见 主题设置项

改主题写主题是两件事:

  • ✅ 调主题暴露的设置(如改主色 → 改 favicon → 调 hero 文字)→ 运营自己干
  • ❌ 改主题源码(如新加一个区块、改一个组件位置)→ 让开发者干

2. 我能在不同语言下用不同主题吗

Section titled “2. 我能在不同语言下用不同主题吗”

不能——一个站点同时只一个主题。

如果你想”中文站和英文站完全不同的视觉”,建议:

  • 部署两套独立的 BangNiCMS 实例
  • 各装各的主题
  • 两个站点之间通过外链关联

不会——主题只决定”怎么显示”,不决定”显示什么”。

切换主题前后:

  • ✅ 所有产品 / 文章 / 页面 / 下载完整保留
  • ✅ 所有图片 / 文件完整保留
  • ✅ 所有翻译完整保留
  • ⚠️ 可能丢的:主题独有的设置(如旧主题的颜色配置不会自动迁移到新主题)

安全做法:切换前截图保存当前的主题配置 + 首页效果,新主题装好后对照恢复。

当前 BangNiCMS 还没有官方主题市场。你可以:

  • 联系 BangNiCMS 官方提供定制主题
  • 找开发者按你的设计稿开发主题
  • 等未来主题市场上线

详见 安装与切换主题

5. 我能预览第三方主题不立刻切换吗

Section titled “5. 我能预览第三方主题不立刻切换吗”

当前不支持”预览”模式——只能装好 + 激活才能看效果。

安全做法

  • 测试环境先装新主题、看效果
  • 满意了再到生产环境装
  • 测试环境 = 部署在另一台服务器或同一服务器的另一个端口的 BangNiCMS

主题在固定位置预留可挂插件的槽位(如首页 Hero 下方、Footer 之上)。

为什么这么设计

  • 主题决定”骨架”,插件决定”血肉”
  • 同一个主题搭配不同插件 = 不同站点
  • 插件可以独立升级,不需要换主题

举例

官方主题 official-site 提供这些槽位:
- homepage-hero → 主题已有 hero,但运营可换插件
- homepage-features → 默认空,挂插件填充
- homepage-testimonials → 默认空
- header-utility → Header 右上角(语言切换 + 搜索)
- footer-extra → Footer 底部追加内容

详见 主题与插件协作

主题 .zip 包上传后解压到服务器存储目录——不存在数据库里。这意味着:

  • 服务器存储空间需要预留 100 MB-1 GB(主题通常较小,但可能含设计图)
  • 备份服务器时记得备份主题目录

详见 备份与升级 章节(建设中)。

接下来 4 篇带你走完主题相关的全部能力:

1. 安装与切换主题

上传第三方主题 zip / 激活 / 切换 / 卸载的完整流程

阅读 →

2. 主题设置项

颜色、字体、Logo 位置、布局选项——主题通常暴露的可调配置

阅读 →

3. 首页模块管理

Hero、精选产品、行业洞察、CTA 等首页区块的配置

阅读 →

4. 主题与插件协作

把插件挂到主题预留的”槽位”上——扩展前台能力的关键

阅读 →

不建议改——内置主题是”兜底”层,被 BangNiCMS 升级覆盖时你的修改会丢失。

如果你想深度定制,做一个第三方主题——基于内置主题复制一份代码 → 改 → 打包成 zip → 上传安装。

前台恢复

  1. 后台「扩展市场」找到当前 active 主题 → 点 切换到其他主题
  2. 内置主题作为兜底
  3. 前台立刻恢复(用内置主题渲染)
  4. 联系开发者修复出问题的主题

后台进不去

让运维直接改数据库

-- 先把所有第三方主题降级
UPDATE extension SET status = 'disabled'
WHERE extension_type = 'theme' AND is_builtin = false;
-- 内置主题自动接管

详见 故障排查 章节(建设中)。

取决于主题设计

  • 通用主题(如 official-site)—— 适合多数 B2B 站,通过设置调整
  • 行业垂直主题(如”工业设备站”、“美妆电商站”)—— 视觉风格更针对性,但跨行业不一定合适

选主题时考虑:行业匹配度 + 设置灵活度 + 开发者支持。

我能同时启用多个主题做 A/B 测试吗?

Section titled “我能同时启用多个主题做 A/B 测试吗?”

不能——同时只一个 active 主题。

如果想做 A/B 测试,需要部署两套 BangNiCMS 实例 + 通过 DNS / 反向代理把流量分给两套,分别记录数据。这是运维方案,不是功能问题。

安装与切换主题 → — 实操开始