#Zsens 插件介绍附件上传插件功能介绍及配置说明~

张先生主理

社区管理

部署教程 141 浏览 2 回复

附件上传插件

发帖拓展功能：为帖子增加本地/云盘附件挂载，支持积分或金币付费下载。

功能

发帖拓展：发帖/编辑时勾选「附件上传」，上传并挂载文件
多文件上传：支持进度显示、删除、数量上限
付费下载：每个附件可单独设置价格与币种（积分 / 金币），0 为免费
权限控制：可配置允许上传的用户组；实际上传/下载仍受社区 upload / download 权限约束
储存位置：文件管理（本地）：写入 public/storage/attachments/，并登记到附件库光鸭云盘：走光鸭上传（需已安装、启用并登录光鸭插件）
作者分成：付费解锁后可将等额积分/金币发放给帖子作者（可开关）
帖内展示：主题详情下方展示附件列表；免费/已解锁/作者/管理员可直接下载，否则先付费解锁
列表标记：含附件的帖子会带「含附件」标识

安装

将本目录放置到 plugins/attachment/。
进入后台「应用中心」，找到「附件上传」并安装。
打开插件配置，按需填写后保存。

后台配置

配置项	说明
启用附件上传	总开关；关闭后发帖页不展示、帖内不渲染
付费下载分成给作者	用户付费解锁后，等额币种发给帖子作者
可上传用户组	勾选后仅这些用户组可在发帖时添加附件；不勾选表示不限制；管理员不受限
允许后缀	英文逗号分隔，如 zip,pdf,doc
单文件大小(MB)	单个附件上限
单帖附件数量	每个主题最多挂载个数（1–50）
储存位置	文件管理（本地） / 光鸭云盘

使用说明

发帖 / 编辑

打开发帖页，在「拓展功能」中勾选附件上传。
点击「选择文件」上传；可设置每个文件的币种与价格。
发布或保存后，附件与帖子绑定。
编辑已有附件的帖子时，会自动勾选并回填附件列表。

下载

免费附件：有下载权限即可直接下载。
付费附件：点击「支付 N 积分/金币下载」确认后解锁，再下载。
作者 / 管理员：无需付费，可直接下载。
未解锁时访问下载地址会被拦截。

接口

方法	路径	说明
POST	/attachment/upload	上传附件（需登录 + 可发布用户组 + upload 权限）
POST	/attachment/unlock	付费解锁（参数 id）
GET	/attachment/download	下载跳转（参数 id；付费附件需已解锁）

数据表

topic_attachment：帖子附件（含价格、币种、储存方式等）
topic_attachment_unlock：付费解锁记录

目录结构

plugins/attachment/
├── AttachmentPlugin.php      # 插件入口 / 配置 / 钩子
├── plugin.json               # 元数据
├── install.sql               # 数据表
├── routes.php                # 前台路由
├── icon.svg
├── README.md
├── controller/
│   └── Index.php             # 上传 / 解锁 / 下载
├── service/
│   └── AttachmentService.php # 同步、付费、渲染
└── static/
    ├── attachment.css
    ├── attachment-editor.js  # 发帖拓展编辑器
    └── attachment.js         # 帖内解锁

说明

选择「光鸭云盘」前，请先安装并启用光鸭插件，并在后台完成登录。
单文件大小还需满足 PHP / Web 服务器上传限制。
插件未安装或关闭时，不影响其它发帖拓展与站点功能。

下载地址/后台安装

https://www.zsens.cn/market/32.html