【插件】SLS 资源下载（子比主题适配）

================================================================
SLS 资源下载（子比主题适配） 安装说明
适用主题：Zibll 子比主题（V7 / V9，已在 V9.1 验证）
站点：https://www.028wp.com
================================================================

【功能简介】
—————————————————————-
· 下载必须登录 WordPress，并按 角色权限 / 子比 VIP（SVIP）会员
身份控制：免费软件登录可下、SVIP 软件会员可下、收费软件需授权。
· 本地安装包存放在受保护目录，真实地址完全隐藏，支持断点续传；
网盘链接在权限校验通过后才跳转。
· 后台可视化管理：发表、修改、上架/下架、上传安装包、批量操作。
· 提供 REST API 接口，可用外部程序/应用密码发布和修改软件。
· 前台序号按分组自动连续编号，删除软件后自动重排。
· 页面颜色全部读取子比主题变量，明暗（深色）模式自动跟随。

【文件清单】
—————————————————————-
1. sls-resource-download.php 插件主文件
2. page-soft-download.php 前台页面模板
3. preview.html 效果预览（本地双击即可查看，不用上传）
4. 安装说明.txt 本说明

================================================================
一、安装插件
================================================================

1. 在站点目录 wp-content/plugins/ 下新建文件夹：
sls-resource-download

2. 把 sls-resource-download.php 上传到该文件夹内，最终路径为：

wp-content/plugins/sls-resource-download/sls-resource-download.php

也可以把该文件夹压缩成 zip，通过后台
「插件 → 安装插件 → 上传插件」安装。

3. 登录 WordPress 后台，「插件 → 已安装插件」中找到
「SLS 资源下载（子比主题适配）」，点击 启用。

4. 启用时插件会自动完成：
· 创建数据表 wp_sls_resources，并写入初始 83 项软件；
· 创建受保护目录 wp-content/uploads/sls-protected/
（自动写入 Apache 禁止访问规则，外部无法直接下载）。

注意：请确保 wp-content/uploads 目录可写。

================================================================
二、安装页面模板
================================================================

把 page-soft-download.php 上传到子比主题的 pages 目录：

wp-content/themes/zibll/pages/page-soft-download.php

· 推荐放到 子主题 目录（如 zibll-child/pages/），
主题升级时不会被覆盖；
· 没有子主题可直接放主主题目录，但升级主题前记得备份。

================================================================
三、新建下载页面
================================================================

1. 后台「页面 → 新建页面」，标题填：软件下载（可自定）。
2. 右侧「页面属性 → 模板」选择：深蓝软件资源下载页。
3. 点击 发布。
4. 访问该页面即可看到软件下载页。
建议把该页面加入网站导航菜单。

================================================================
四、后台软件管理（发表 / 修改 / 上下架）
================================================================

后台左侧「资源下载」菜单：

资源概况 —— 分组数量、已发表/草稿、已配置数、累计下载、
下载量排行。
软件管理 —— 全部软件列表，支持按分组/状态筛选、关键词搜索、
分页、行内编辑、上架/下架、删除。
添加软件 —— 发表新软件。

软件字段：
· 软件名称（必填）、功能说明
· 资源分组：免费软件 / SVIP 软件 / 收费软件
· 发布状态：立即发表（前台可见）/ 存为草稿（前台隐藏）
· 广告情况、广告下发接口、备注
· 网盘/远程链接：权限通过后跳转
· 本地安装包：表单中直接选择文件上传，自动保存到受保护目录；
可替换或删除旧文件

批量操作：勾选多条后可批量上架、批量下架、批量删除。

前台 # 序号为显示编号，与数据库无关，删除软件后自动连续重排。

================================================================
五、下载权限规则
================================================================

游客 登录用户 VIP/SVIP 管理员
收费软件 登录按钮 购买/定做 购买/定做 下载
免费软件 登录按钮 下载 下载 下载
SVIP 软件 登录按钮 开通SVIP 下载 下载

· 未登录点击 → 跳转登录页，登录后返回继续；
· 草稿（未发表）软件任何人无法下载；
· SVIP 判断优先调用子比内置函数，否则读取用户字段
zib_vip_expire（时间戳或“永久/终身”等标识）。

================================================================
六、服务器防护设置（重要）
================================================================

Apache：插件已自动生成 .htaccess，无需操作。

Nginx（必须手动配置）：
Nginx 不读取 .htaccess，请在站点配置中加入：

location ^~ /wp-content/uploads/sls-protected/ {
deny all;
return 403;
}

保存后执行：nginx -t && nginx -s reload

================================================================
七、自定义设置（可选，写入子主题 functions.php）
================================================================

// 1. 开放软件管理权限给编辑角色（默认仅管理员）
add_filter( ‘sls_dl_manage_cap’, function () {
return ‘edit_pages’;
} );

// 2. 修改会员开通页地址（默认 站点域名/vip/）
add_filter( ‘sls_dl_vip_url’, function () {
return home_url( ‘/user/vip/’ );
} );

// 3. 修改收费软件购买/定做链接（默认 mailto 管理员邮箱）
add_filter( ‘sls_dl_purchase_url’, function () {
return home_url( ‘/custom/’ );
} );

// 4. 收费软件的直接下载权限（默认管理员）
add_filter( ‘sls_dl_paid_capability’, function () {
return ‘sls_paid_member’;
} );

// 5. 接入其它会员插件判断
add_filter( ‘sls_dl_user_is_vip’, function ( $is_vip, $user_id ) {
return my_membership_plugin_is_vip( $user_id );
}, 10, 2 );

// 6. 追加允许上传的文件扩展名
add_filter( ‘sls_dl_allowed_extensions’, function ( $exts ) {
$exts[] = ‘xz’;
return $exts;
} );

================================================================
八、REST API 管理接口
================================================================

基础地址：
https://你的域名/wp-json/sls-dl/v1/resources

鉴权：需要软件管理权限（默认管理员）。
推荐使用「应用程序密码」：
后台「用户 → 个人资料 → 应用程序密码」生成。

接口列表：
GET /sls-dl/v1/resources 软件列表（含草稿）
POST /sls-dl/v1/resources 发表软件
GET /sls-dl/v1/resources/{id} 查看单个软件
PUT /sls-dl/v1/resources/{id} 修改软件（可只传变更字段）
DELETE /sls-dl/v1/resources/{id} 删除软件（同时删除本地文件）

列表参数：status（publish/draft）、res_group（paid/free/svip）、
search、page、per_page（最大100）

字段：name（名称，必填）、description（说明）、
res_group（free/svip/paid）、status（publish/draft）、
ad、ad_api、note、file、url、downloads（只读）

示例 1：发表软件
curl -X POST “https://你的域名/wp-json/sls-dl/v1/resources” ^
-u “管理员用户名:应用密码” ^
-H “Content-Type: application/json” ^
-d “{\”name\”:\”示例软件\”,\”res_group\”:\”free\”,\”status\”:\”publish\”,\”url\”:\”https://pan.baidu.com/s/xxxx\”}”

示例 2：下架 id=84 的软件
curl -X PUT “https://你的域名/wp-json/sls-dl/v1/resources/84” ^
-u “管理员用户名:应用密码” ^
-H “Content-Type: application/json” ^
-d “{\”status\”:\”draft\”}”

说明：二进制安装包请通过后台表单上传；API 的 file 字段仅用于
指定已存在于受保护目录的文件名。

================================================================
九、常见问题
================================================================

Q：页面提示“资源下载模块未启用”？
A：插件未安装或未启用，请先按第一步启用插件。

Q：点击下载提示“链接已失效”？
A：下载地址带安全签名，页面长时间停留会过期，刷新页面重新点击即可。

Q：发表后前台看不到软件？
A：检查发布状态是否为“立即发表”，草稿仅后台可见。

Q：上传文件失败？
A：检查文件扩展名是否允许、受保护目录是否可写。

Q：深色模式切换后页面不变色？
A：请确认使用的是最新版 page-soft-download.php；模板已兼容
子比 V7（body.theme-dark）与 V9（body.dark-theme）。

Q：网盘链接是否会暴露？
A：仅登录且权限通过后才跳转；需要完全隐藏地址请使用本地安装包。

Q：升级主题后下载页没了？
A：模板若放在主主题目录会被升级覆盖，请改用子主题目录。

================================================================
安装完成后如显示正常，建议在后台「软件管理」中删除不需要的
初始软件，再上传自己的安装包或填写网盘链接。
================================================================