- 前台默认样式迁入插件：`weapp/doc_bundle/assets/css/download.css`，经 `` 按需加载
- 新增 `` 默认三列卡片 markup，主题一行插槽即可
- 升级日志后台样式统一为 `pv-weapp-changelog-*` 类名
文档扩展
文档附件包
给文档挂可下载附件：可限制登录后下载，并统计下载次数。
商品属性
品牌官方插件
语言PHP 8.1+
数据库MySQL 5.7+ / MariaDB
环境PivArk 1.5+ · weapp 标装
类型文档扩展
版本v1.0.1
编码UTF-8
交付方式官方插件 · 授权安装
商品介绍
下载附件插件是做什么的？
给网站上的每一篇文章挂上可下载的资源：本地安装包、PDF 课件、压缩包，或百度网盘 / 夸克 / 阿里云盘等分享链接（含提取码）。访客在文章页一键下载或跳转网盘，站长在后台统一管理范围、权限与展示样式。
适合软件站、教程站、资源分享站、会员素材站。模板怎么写请看「前台调用说明」Tab。
四类典型场景
核心能力一览
- 一篇多包：同一文章可挂多个资源包，例如「Windows 版 + Mac 版 + 网盘备用链接」，各自独立排序与权限。
- 本地 + 网盘混排：附件直接上传，或填远程链接；提取码会随前台一起展示，无需访客再去找口令。
- 灵活权限：每个资源包可设「游客可下 / 登录后可下 / 指定会员等级 / 扣积分」；与文章「阅读权限」分开配置，可实现「能看不能下」或「能下不能看全文」。
- 下载统计：记录累计下载次数，便于观察哪份资料最受欢迎。
- 智能粘贴：复制网盘分享文案后，在后台粘贴即可自动识别链接与提取码，大幅节省录入时间。
- 两种维护方式：发布页可用独立「下载资源」页签，或与正文同屏嵌入，按站点习惯二选一（全站统一，在「基础设置 → 发布页展现」切换）。
从配置到访客下载：整体怎么运转？
一篇文章，多个资源包
发布页两种维护方式
复制网盘口令，自动回填
站长上手：四步即可上线
- 在「基础设置」选择使用范围（全部文档 / 指定标签组 / 指定标签）和发布页展现方式，保存。
- 打开一篇符合范围的文章，在「下载资源」页签（或正文旁嵌入区）新建资源包，上传文件或粘贴网盘链接。
- 为每个资源包设置显示名称、排序，以及是否需要登录、会员等级或积分。
- 确认主题已在文章详情页放置下载区块（见「前台调用说明」）。发布文章后，前台即可看到下载入口。
访客在前台看到什么？
- 文章详情页出现「相关下载」或你自定义标题的区块，列出该文所有可用资源。
- 本地文件：点击后直接下载；网盘链接：点击后跳转或复制（由主题样式决定）。
- 若资源要求登录：未登录时会引导去登录页，成功后回到当前文章再下载。
- 若要求会员等级或积分不足：前台可展示提示文案（主题可自定义），引导升级或充值。
- 该文未配置下载、或未启用插件、或不在使用范围内：整块下载区不会出现，页面其它内容不受影响。
阅读与下载：两个开关，别搞混
| 配置位置 | 控制什么 | 举例 |
|---|---|---|
| 文章「基础内容」里的阅读权限 | 能不能看正文全文 | 未登录只看摘要，登录后看全文 |
| 下载资源包里的下载权限 | 能不能下载附件 | 正文免费看，附件登录后可下 |
两者可自由组合，满足「引流阅读 + 付费下载」「会员专享素材」等常见运营需求。
常见问题（站长视角）
- 为什么发布页看不到下载入口？ 检查插件是否已启用；文章标签是否在「使用范围」内；是否在「基础设置」保存过范围策略。
- 为什么前台没有下载区？ 该文是否已配置资源包；主题是否已插入下载标签（见前台调用说明）；资源是否处于启用状态。
- 能否只对部分栏目开放？ 可以。将「使用范围」设为指定标签组或标签即可，例如仅「资源下载」组下的文章可配。
使用说明
写给主题 / 前端：你要做的事
在文章详情页模板里插入 标签体为空时，系统会使用默认单行链接： 以下任一情况， 因此模板里不必再写 标签循环输出的是扁平资源项；分组布局请参考主题默认模板或 API
完整列表示例（可直接套用）
<section class="pv-download-block">
<h3 class="pv-download-block__title">相关下载</h3>
</section>
<a href=""></a>卡片式布局示例
标签属性
属性 说明 id文章 ID，详情页最常用 document_id / aid与 id 相同，任选其一（不写属性） 自动取当前页面的 document_id（仅详情页有效）循环变量
{$field.*}（每个下载项）
变量 含义 前台怎么用 本条资源的显示名称 推荐作为链接文字 所属资源包标题 分组标题、卡片主标题 下载 / 跳转地址 写在 <a href> 上，点击即触发下载或跳转人类可读大小 如 1.2 MB字节数 需自行换算时使用 网盘提取码 有值时展示「提取码：xxxx」 原始网盘链接 想做「复制链接」按钮时使用 local 或 remote本地附件 / 远程链接，可用来切换图标 权限类型文字 如免费、登录、会员等级等，可做角标 累计下载次数 展示热度 下载项 ID 一般无需展示，统计埋点可用 访客看到的效果（示意）
登录 / 权限相关（模板侧要知道的）
会跳转登录页，登录成功后回到当前文章再点即可。（若主题已有该变量）：
{if $document_login_required}<p class="pv-tip">登录后可查看全文与下载附件</p>{/if}什么时候整段不输出？
整段消失（不会留空壳）：
{if} 判断「有没有下载」，直接写标签即可。样式建议
pv-download-*，避免与主题其它模块冲突。）。 或 ）。自检清单（发布主题前）
常见问题（前端视角）
。id 是否传对；该文是否在插件使用范围内；资源是否启用。document_id 上下文，需在列表项循环内对每行单独写
GET /api/v1/plugins/doc_bundle/list/:document_id 返回结构。
升级日志
- 文档挂载可下载附件，登录后下载与计数
- 文档编辑器「相关下载」Tab 与 `` 前台标签
- 会员中心「我的下载」记录
- 官方 weapp 标装参考实现
购买与安装
- 登录官网会员，在本页右侧选择限时免费套餐完成开通（到期后须续费或升级）。
- 在 用户中心 → 我的授权 绑定客户站域名并同步到站点后台。
- 客户站 → 应用市场 搜索
doc_bundle在线安装并启用。
交易须知
- 交付形式官方插件 · 授权安装；通过应用市场安装，不提供独立源码包下载。
- 授权范围插件授权绑定单个站点域名；小程序类 SKU 规则以套餐说明为准。
- 限时免费免费授权含有效期，到期后功能受限；续费或升级付费套餐可继续使用。
- 退款规则请确认功能需求后再购买；非功能缺陷恕不退款。
- 官方保障官方插件由元舟提供安装指导与技术支持。