基于星空授权二开的可用的子比授权插件(开源)

一、插件简介与二开概述

1.1 插件定位

星空授权插件（xk-auth）是基于子比主题（Zibll）的数字商品授权销售管理插件，专为 WordPress + Zibll 生态打造，可售卖软件、源码、在线程序、会员权限等数字商品，支持卡密授权和域名绑定授权两种模式。

1.2 二次开发概述

柒仔日记在原始版本基础上进行了二次开发，重点解决了以下问题：

• 与子比主题的深度兼容冲突（CSF 框架冲突、后台页面冲突、metabox 回调冲突）
• 支付流程适配（子比主题 V9.0 支付接口适配、订单类型 15 自定义）
• 5 大新增功能模块（代理管理、卡密管理、优惠码、举报中心、前端管理日志）
• 8 张新增数据表，完善商业化闭环
• 前端体验优化（用户中心新增日志查询、举报入口、代理中心 Tab）

1.3 技术架构

• 后端 | PHP 7.4+、WordPress 钩子系统、CSF 框架、MySQL/MariaDB
• 前端管理后台 | Vue 3 + Element Plus
• 前端用户中心 | 子比主题用户中心 Tab 集成
• 支付 | 子比 ZibPay（订单类型 13/15）
• 授权验证 | AES-256-CBC + HMAC-SHA256 + REST API
• 数据库 | 11 张表（含 8 张二开新增表）

二、二开重点：修复了什么 + 新增了什么

• 修复 1：CSF 框架冲突导致无法创建设置页后台”星空授权 → 设置”页面白屏，无法配置插件
• 修复 2：后台新建页面
• 修复 3：子比主题 V8.2+ 支付适配:子比 V8.2+ 环境下，用户支付后无授权码返回
• 修复 4：支付表单初始化失败:点击购买按钮后弹窗内套餐列表为空或 JS 报错
• 修复 5：支付重复提交:网络慢时用户连点”立即购买”按钮，会生成多个待支付订单
• 修复 6：Base64 URL 传输空格问题:授权验证或更新时，特定数据签名校验失败
• 新增 1：代理管理模块（二开核心功能）
• 新增 2：卡密管理模块
• 新增 3：优惠码模块
• 新增 4：举报中心模块
• 新增 5：前端管理日志模块
• 新增 6：定时清理任务
• 新增 7：用户中心侧边栏增强

三、部署说明

3.1 环境要求

•  PHP ：7.4（推荐 8.0+）
• WordPress ：6.0+
• 子比主题（Zibll）：8.1+（推荐 V9.x）
• MySQL/MariaDB：5.7+ / 10.3+
• SSL 证书：必须（支付和 API 要求）

3.2 安装步骤

步骤 1：安装子比主题

• 上传 `zibll` 主题包至 `/wp-content/themes/`
• 后台 → 外观 → 主题 → 启用”子比子主题”（推荐）或”子比主题”
• 确保主题已激活并正常运行

步骤 2：安装星空授权插件

• 上传 `xk-auth` 目录至 `/wp-content/plugins/`
• 后台 → 插件 → 已安装插件 → 启用”星空授权插件（柒仔日记二开）”
• 插件自动检测子比主题，若未启用则提示激活

步骤 3：配置插件

1. 后台左侧菜单 → “星空授权” → 设置

2. 基础配置：

   – 授权模式：卡密模式 / 域名绑定模式（可同时开启）

   – API Token：设置 REST API 通信密钥

   – 授权码前缀：可选，如 `QZ-` 前缀

3. 支付配置：

   – 确保 ZibPay 已配置支付宝/微信收款

   – 订单类型选择”自定义类型 15″（已内置）

4. 新增功能配置：

   – 优惠码：是否开启前端优惠码输入

   – 代理管理：是否开启代理申请入口

   – 举报中心：配置举报类型和是否开启未登录举报

   – 帮助中心：配置 FAQ 问答

步骤 4：创建产品

1. 星空授权 → 产品管理 → 添加产品

2. 填写：

   – 产品 ID（唯一标识，如 `nav-001`）

   – 产品名称（如”柒仔导航程序”）

   – 产品描述

   – 价格套餐（月费/年费/永久）

   – 产品图片

步骤 5：创建销售页面

1. 页面 → 新建页面

2. 插入短代码 `[xk-auth-product id=”nav-001″]`

3. 或使用 Gutenberg 区块”星空授权产品”

4. 发布页面，访问测试购买流程

四、展示图