附件上传内容

一、插件简介

发帖拓展插件：作者在发帖时可上传附件（支持多文件），可设置积分/金币付费下载。支持配置允许后缀、单文件大小、单帖数量上限及储存位置（本地文件管理或光鸭云盘）。

二、核心能力

三、依赖与安装

1. 将插件置于 plugins/attachment/。
2. 在应用中心安装「附件上传」。
3. 安装时创建 topic_attachment、topic_attachment_unlock 表。
4. 依赖：community（发帖、Coin 服务）。
5. 可选：guangya（云盘储存）、vip（跳过付费下载）。

四、应用中心基础配置

五、后台重点配置

无独立后台菜单。储存选「光鸭云盘」时需：

1. 安装并启用 guangya 插件。
2. 在光鸭插件中完成账号登录授权。
3. 确认 PHP upload_max_filesize、post_max_size 不小于配置的单文件上限。

六、前台用户流程

作者发帖

1. 在发帖拓展区「附件」区块点击上传（需用户组有上传权限）。
2. 选择文件；可设置每个附件是否付费及价格/币种。
3. 发布帖子；附件列表显示在正文下方。

读者下载

1. 打开帖子查看附件列表。
2. 免费附件直接下载；付费附件需解锁后下载。
3. VIP 用户在配额内可跳过付费附件。

前台路由

七、后台审核与运维

无审核流程。卸载会删除 topic_attachment、topic_attachment_unlock 表及附件关联数据。

帖子生命周期

• afterTopicSave：帖子保存后同步附件（AttachmentService::syncForTopic）。
• afterTopicsDeleted：帖子删除时清理附件引用。
• topicMetaMap：为列表页提供附件元信息。
• fileReferenceKeys：返回 /storage/attachments/、/guangya/file/ 供文件清理引用。

八、特殊说明

• 插槽：topic_after_content、compose_extra、admin_topic_form、compose_assets。
• 数据表：topic_attachment（帖子附件，含 price/currency/download_count）、topic_attachment_unlock（解锁记录）。
• 储存驱动：local 或 guangya，由 storage_driver 配置。
• Schema 迁移：自动补充 price、currency、download_count 字段及解锁表。
• coinTypeLabels：注册「附件下载」币种类型标签供社区展示。

九、推荐上线清单

• 配置允许后缀、大小与数量限制
• 设置可上传用户组（务必勾选允许的用户组）
• 确认 PHP 与 Nginx 上传限制足够
• 若使用光鸭，完成 guangya 插件配置
• 测试上传、付费解锁、下载全流程
• 测试帖子删除后附件清理

十、常见问题

Q：上传失败或提示文件过大？ 检查应用中心「单文件大小」、PHP upload_max_filesize、post_max_size 及 Web 服务器限制。

Q：发帖页没有附件拓展？ 检查插件启用；用户组是否在「可上传用户组」中（不勾选=全部不可用）。

Q：光鸭储存无法上传？ 确认 guangya 插件已安装启用且已登录；网络可达光鸭 API。

Q：付费下载作者没收到分成？ 检查「付费下载分成给作者」开关；确认解锁走 Coin 服务且作者 ID 有效。

Q：允许后缀不生效？ 后缀列表英文逗号分隔，不含点号；比较时不区分大小写。