开发文档

一、环境要求

• WordPress 6.x 及以上（随包演示站为 WP 7.1 中文版）；PHP 7.4 ~ 8.2（推荐 8.1）；MySQL 5.7+；
• PHP 扩展：mysqli（或 pdo_mysql）、gd（头像/缩略图）、curl、mbstring、json；
• 主题依赖 WordPress 的 Gutenberg 区块系统（WP 5.9+ 自带，无需额外插件）。

二、安装步骤

1. 先装好 WordPress（面板一键部署或手动上传，跑完 WP 安装向导，能进 /wp-admin）；
2. 把主题目录 yunshu/（即压缩包解压后的主题文件夹）整个上传到 wp-content/themes/ 下；
3. 后台 外观 → 主题 找到本主题 → 启用；
4. 进入 外观 → 主题设置，按需配置：站点风格、配色、夜间模式、首页板块、会员与下载相关选项（选项定义来自主题自带框架 pandastudio_framework）；
5. （可选）导入演示数据：随包若提供演示导入（yunshu-demo/import-demo.php 或后台导入入口），按提示导入一遍即可得到与演示站一致的内容结构；
6. 建菜单与首页：外观 → 菜单 建主导航；设置 → 阅读 把首页设为一个页面可用空白模板（page_blank.php）；会员中心页用「会员中心」模板（page_member.php）。

三、授权（重要）

• 本主题带授权验证：主题内的加密文件在运行时由授权加载器解密，必须完成授权后主题功能才完整可用；
• 授权码写在站点根目录 xj_auth.php（下载时已自动填入你的授权码）；主题包内提供 xj_panel.php 时，访问 https://你的域名/xj_panel.php 可「验证授权 / 在线更新」；
• 换域名：授权绑定域名，换域名需重新绑定（用户中心自助换绑或联系客服），否则前台/后台主题设置会受限；
• 不要把 xj_auth.php / xj_loader.php（如随包提供）删除或改名。

四、常见问题

• 启用主题后前台报错/白屏：PHP 版本过低（需 7.4+）或 gd 扩展缺失；
• 样式全丢 / 页面裸 HTML：站点是 https 但 WordPress 以为自己是 http（常见于 Nginx 反代），在 wp-config.php 顶部加：

  if (empty($_SERVER["HTTPS"]) || "off" === $_SERVER["HTTPS"]) { $_SERVER["HTTPS"] = "on"; }

• 后台主题设置页空白：主题文件没传全（pandastudio_framework/、pandastudio_plugins/ 必须一起上传）；
• 想固定白天配色：主题设置里把「夜间模式自动切换」关掉即可（夜间模式的总开关可保留，访客仍能手动切）；
• 二开/改主题：用商家提供的明文源码包改（服务器上的主题文件是加密壳），改完按原目录结构覆盖。

五、升级

有新版本时：后台 外观 → 主题 上传新包覆盖（WordPress 会自动替换同名目录），或走 xj_panel.php 的「在线更新」。升级前建议备份你改过的模板文件（更稳妥的做法是建子主题放改动）。