安装与快速开始
KnowSphere 默认主题面向专栏、会员与文章付费站点。这份指南说明如何通过 Halo 控制台配置主题，不需要修改代码。
KnowSphere 基础版免费使用且不开源，默认配套主题可单独购买，永久授权 ¥79。购买 Pro 任一授权周期即赠当前默认主题，无需单独购买；主题兼容基础版和 Pro。赠品期限以对应订单和授权中心记录为准，历史订单权益按购买时约定核验。Pro 月付 ¥12、季付 ¥32、年付 ¥99、永久 ¥199，完整价格与激活步骤请查看 价格、版本选择与升级。后续独立专门主题另行说明。
适用版本
本指南依据 KnowSphere 知识付费主题 1.0.0-beta1 的现有配置整理，核对日期为 2026 年 10 月 12 日。截图来自本地演示站点，配色、内容与套餐价格均为示例，不代表安装后的默认业务数据。
主题声明的 Halo 最低版本为 2.20.0。需要插件前台页面自动复用主题导航、配色和页脚时，建议使用 Halo 2.26.0 或以上版本，并确认插件支持 Halo 页面布局契约。插件本身的最低版本另以对应插件的安装要求为准。
先分清两类配置
| 设置位置 | 管理内容 |
|---|---|
| 外观 → 主题 → 当前主题设置 | 宽度、配色、导航布局、首页编排、页面文案、图片与页脚 |
| KnowSphere 插件管理 | 商品、付费权限、会员套餐、专栏、订单、支付、优惠券及成长规则 |
| 外观 → 菜单 | 菜单名称、层级、链接与打开方式 |
| 内容 → 页面、文章 | 自定义页面、文章、分类与标签 |
主题负责展示。开启主题里的“会员区域”不会自动创建会员套餐，开启签到入口也不会自动设置签到奖励。
安装步骤
- 在 Halo 控制台安装与你的 Halo 版本兼容的 KnowSphere 插件，并完成插件初始化。
- 打开 外观 → 主题 → 主题管理，上传已经构建好的主题 ZIP 安装包。
- 启用 KnowSphere 知识付费主题，进入主题设置。源码压缩包不等同于可安装的构建包。
- 先保存“布局与样式”，再设置导航、首页模块、业务页面与页脚链接。
- 回到前台，以游客和已登录用户分别检查展示结果。
创建需要的自定义页面
在 内容 → 页面 → 新建页面 中设置页面标题、固定链接，并选择对应主题模板，然后发布。页面固定链接由 Halo 页面配置决定，主题不会因为你选择了模板而自动创建全部路由。
| 页面用途 | 主题模板文件 | 建议检查 |
|---|---|---|
| 会员套餐 | page_membership.html | 套餐是否已在插件中配置并可展示 |
| 专栏列表 | page_columns.html | 需要 Pro，且存在已发布专栏 |
| 已购内容 | page_purchases.html | 登录状态与实际购买记录 |
| 订单记录 | page_orders.html | 登录状态与订单权限 |
| 我的优惠券 | page_coupons.html | 插件优惠券配置与用户领取记录 |
| 分销中心 | page_distribution.html | 需要 Pro 及相应业务配置 |
| 任务中心 | page_tasks.html | 需要 Pro 及相应业务配置 |
例如：将会员页面固定链接设为 /membership，就应把首页品牌按钮、快捷入口、轮播自定义链接、页脚按钮和菜单中的会员链接统一为 /membership。部分主题字段初始值使用 /membership/plans，不要直接假定两个地址都会存在。插件自带前台页面与主题自定义页面也应分别核对。
推荐初始化顺序
- 内容与商品：准备文章、分类、会员方案；Pro 站点另准备专栏及分类绑定。
- 布局与样式：选择统一宽度和明暗配色。
- 页面与菜单：发布需要的页面，再用实际链接建立菜单。
- 首页模块编排：只展示已准备好数据的模块。
- 页脚与备案：替换演示链接、文案与备案信息。
- 验收：检查游客、登录用户、手机和明暗模式。
指南目录
- 布局、配色与导航：统一全站宽度，设置顶部或侧边栏菜单。
- 首页模块编排：配置品牌 Hero、轮播、推荐与业务区块。
- 分类、专栏与内容探索：组织分类轮播、标签、归档和搜索。
- 会员、签到与用户中控台：区分展示文案与插件业务能力。
- 文章阅读与图片：调整正文排版和封面兜底。
- 页脚、订阅与备案：维护底部导航与订阅依赖。
- 常见问题与上线检查：排查入口、数据与配置生效问题。