Skip to content

后台自定义配置

Annoying Theme 的后台配置建议集中成一份主题配置 Schema。站长以后只需要在后台修改字段,前台主题、个人中心、会员充值、AI 自动回复和授权模块都从同一份配置读取。

配置分组

分组用途
site站点名称、品牌文案、主色、强调色、页脚备案等基础信息
navigation顶部导航、侧边栏分区、右上角头像菜单、外链入口
userCenter个人主页、作者卡片、会员徽章、资料卡展示策略
vip会员中心、充值入口、套餐说明、订单入口、Pro 标识
aiAI 自动回复开关、提示词、回复频率、审核策略
license社区版 / Pro 版授权、域名绑定、授权码校验、版本更新

推荐结构

json
{
  "site": {
    "name": "Annoying Theme",
    "slogan": "为 XiunoX 重新打磨的现代主题系统",
    "primaryColor": "#3b82f6",
    "accentColor": "#ec4899"
  },
  "navigation": {
    "avatarMenu": true,
    "sidebarSections": true,
    "items": ["首页", "主题", "文档", "授权"]
  },
  "userCenter": {
    "enabled": true,
    "authorCard": true,
    "vipBadge": true
  },
  "vip": {
    "enabled": true,
    "edition": "permanent",
    "recharge": true
  },
  "ai": {
    "enabled": false,
    "replyMode": "manual-review"
  },
  "license": {
    "edition": "community",
    "domainLimit": 1,
    "permanent": true
  }
}

后端接入

静态官网里的配置页用于确认字段和交互。正式接入 XiunoX 时,建议做成主题插件接口:

text
GET  /plugin/annoying_theme_config
POST /plugin/annoying_theme_config

后台保存时需要校验管理员权限、CSRF 令牌和字段白名单。前台只读取已经发布的配置,不直接暴露敏感授权密钥。

使用方式

先在官网后台配置页调整字段,确认 UI 和字段名稳定后,再把同一份 Schema 落到 XiunoX 插件的 MySQL 配置表。这样以后新增右上角菜单、侧边栏栏目、会员入口或 AI 自动回复,都只改后台配置,不需要反复翻模板文件。