开发文档

云枢官网授权系统 · 安装教程

一、环境要求

二、部署三步（一个域名一套程序）

1. 上传：把发布包 zip 上传到服务器并解压，站点目录指向 public/；
2. 安装：浏览器访问你的域名 /install，按向导填写数据库信息，一键安装（自动建库、导入官网与授权两套表结构）；
3. 初始化：安装完成后登录后台（默认 admin / admin123456），按弹窗引导完成站点名称、联系方式、支付、QQ 等必设项。

三、主控站（星聚自用）部署注意

• 主站部署后 auth_siteurl 保持留空（授权设置里），系统自动使用当前域名；
• 登录后台 → 授权中心 → 授权设置：把「官网程序 uid」设为本站在「程序管理」中的 uid（后台首页广告位展示用）；
• 在「程序管理」上传你要分发的程序包，填写广告位声明（或由上传时自动扫描识别）；
• 打包分发买家版时修改 package.conf：主站域名、官网程序 uid、授权密钥，运行 php package.php 即自动注入。

四、客户站（买家）部署

• 与主站同样三步部署，无需任何主站配置：主站信息已随发布包注入数据库；
• 安装后登录后台 → 授权验证 → 填写购买的授权码完成激活（域名绑定，换域名需在主站授权记录中重置）；
• 后台首页广告位自动展示主站投放的广告（1-2 小时缓存自动同步）；应用中心自动对接主站插件市场。

五、数据表自动创建（无需手动导入）

系统新增的模块（在线客服 cms_chat_user / cms_chat_session / cms_chat_message / cms_chat_quick 等）有三条建表通道，任意一条生效即可，不需要你手动执行 SQL：

1. 全新安装：安装向导导入 install/schema.sql 时一并建好；
2. 在线更新：后台「系统更新 → 一键更新」时，按更新包声明的 SQL 文件（install/update/*.sql，全部为 CREATE TABLE IF NOT EXISTS，可重复执行）在官网库自动执行；
3. 运行时自愈：首次访问相关页面时程序自己探测并补建（app/service/CmsSchema.php），老站即使漏了更新包 SQL 也能自动补齐。

若主机数据库账号没有 CREATE 权限导致建表失败，在线客服会自动退回原来的「在线留言」表单，页面不会报错。此时请在「网站设置 → 文档管理」之外检查数据库账号权限。

六、计划任务（可选，建议配置）

在线客服有一个兜底计划任务，作用是结束超时会话、清理过期消息（默认：无消息 30 分钟自动结束会话、消息保留 90 天，均可在后台调整）：

1. 后台 → 客服中心 → 在线接待 → 右上角「设置」，找到「定时任务地址」，点「复制」；
2. 宝塔面板 → 计划任务 → 添加任务：任务类型「访问 URL」，执行周期「每 5 分钟」，URL 填入刚才复制的内容（形如 https://你的域名/chat/cron?key=xxxxxxxx）；
3. 保存即可，无需其他配置。

不配置也不影响聊天：会话超时会在访客下次发消息时顺手处理，只是过期数据清理得没那么及时。

七、常见问题

1. 安装页打不开：确认站点目录指向 public/（不是程序根目录），且已配置伪静态；
2. 安装卡在检测环境：确认 PHP 扩展 openssl/pdo_mysql/fileinfo 已启用、uploads 目录可写；
3. 后台提示未授权：授权验证页填写授权码；本机 localhost 开发环境自动放行；
4. 广告位一直显示招租：主控尚未投放该广告位广告，或缓存未到期（1-2 小时）；
5. 更换域名：需在主站授权记录中重置域名，客户站重新激活；
6. 前台看不到「在线咨询」浮窗：检查 后台 → 客服中心 → 在线接待 → 设置 里「开启在线客服」是否为「开启」；若数据库表没建上（见第五章），浮窗会自动退回留言表单；
7. 在线客服没有提示音/角标：浏览器要求先有一次点击才允许播放声音，登录后台随便点一下页面即可；另外检查是否停留在「在线接待」页（该页用页面内提醒，不再重复角标）。