- 文档发布页专用壳：7 种展现样式 chip 可选；主图路径置顶；更多设置折叠；Ctrl+V 粘贴路径加图
- 样式区「前台开大示意」live mock + SVG 缩略图，点选即切换
- 保存时由条目带回 `display_style` 写入分组，前台布局立即生效
文档扩展
文档图集
给文档挂图片相册，后台上传管理，前台随文章展示。
商品属性
品牌官方插件
语言PHP 8.1+
数据库MySQL 5.7+ / MariaDB
环境PivArk 1.5+ · weapp 标装
类型文档扩展
版本v1.0.2
编码UTF-8
交付方式官方插件 · 授权安装
商品介绍
这个插件能帮你做什么？
产品案例、教程步骤、活动照片要挂在文章里，却不想把 HTML 写死？图集插件帮你在后台维护分组相册，前台一行标签输出轮播、网格或瀑布流，还支持灯箱浏览与图集广场。
适合产品图集、案例截图、教程分步图、摄影作品集；与 thumb 占位图插件互补——gallery 管正文内相册，thumb 管列表无封面时的占位。
典型场景
使用范围
- 发布页：独立 Tab 或嵌入正文，可拖动与同形态插件排序；
- 使用范围：全部文档 / 指定标签组 / 指定标签；
- 批量维护：文档面板批量选图 + 全站条目列表。
发布页编辑
站长怎么用？
- 启用「图集」插件，打开「基础设置」：配置开关、发布页展现与使用范围，保存。
- 编辑文档时打开「文档图集」Tab：先点选展现样式（网格 / 瀑布流 / 轮播等 7 种）；图片以表格列表维护（文件名 / 缩略图悬停预览·点击素材库 / 路径 / 设为封面 / 上移下移 / 删除）；也可上传、ZIP 解压或空白处 Ctrl+V 粘贴路径。
- 详情模板加入
或分组标签（见前台调用说明）。
常见问题
- 前台无图？ 检查文档是否有条目、模板 group 是否匹配、范围是否包含当前文档标签。
- 与 thumb 区别？ thumb 自动替换列表/正文坏链占位；gallery 是主动维护的相册内容。
使用说明
功能简介（前端向）
为文档挂载图片相册，支持多分组、多种展现样式；前台通过模板标签或 REST API 输出。
后台配置
- 「基础设置」：插件开关、发布页展现、使用范围（全部文档 / 指定标签组 / 指定标签）。
- 文档发布页「图集」面板：分组与展现样式、条目路径/说明、上移/下移/「设为封面」、上传 ZIP 解压（jpg/png/gif/webp 等，按文件名排序入列表）、粘贴路径加图；分组可开启打包下载（需 download 插件）。
- 「条目管理」：按文档 ID、分组标识、状态、关键词筛选；健康检查提示缺 Alt、缺标题等待办；可改 sort 数字。
- 「基础设置」：可配置图集第 1 张写入文档封面（仅空 / 始终跟随）。
前台模板
单分组输出：
循环全部分组（标签内 {gallery} 占位输出该组图集）：
临时覆盖展现样式：
分组循环字段（gallery_groups）
| 字段 | 说明 |
|---|---|
| 分组标识 |
| 分组标题 |
| 展现样式 id |
| 启用条目数 |
| 打包下载 ZIP（需分组开启且 download 插件可用） |
| 首张缩略图 |
图片循环字段（gallery）
| 字段 | 说明 |
|---|---|
| 原图 URL |
| 缩略图 URL |
| 响应式 srcset |
| 标题 / Alt |
| 外链 / 说明 / 拍摄信息 |
| 宽高比（瀑布流优化） |
REST API
GET /api/v1/plugins/doc_gallery/document-items?document_id=123&group_key=case GET /api/v1/plugins/doc_gallery/document-groups?document_id=123 GET /api/v1/plugins/doc_gallery/plaza?page=1&sort=hot&q=关键词
图集广场页面：/doc_gallery（需在设置中开启「图集广场」）。
前台静态资源（weapp 真源 · 默认兜底）
轮播 / 瀑布流 / 灯箱的 默认样式与脚本 打包在 weapp/doc_gallery/assets/，随插件安装即可用，不依赖主题是否单独维护图集 CSS/JS。渲染 时由 GalleryFrontAssets 登记， 按需输出；URL 形如 /weapp/doc_gallery/assets/css/gallery.css、/weapp/doc_gallery/assets/js/lightbox.js。
主题分工：站点主题（template/*/assets）只允许用 SCSS 覆盖皮肤（配色、圆角、卡片阴影等），结构布局与灯箱/轮播交互以插件资源为准。禁止把下列文件复制到 public/static/common/ 或主题 assets/js|css/ 充当第二套真源。
assets/css/gallery.css— 全布局 + 灯箱默认兜底assets/js/carousel.js·masonry.js·lightbox.js（按布局与灯箱开关按需加载）
前台效果示意
静态资源含灯箱与轮播脚本，按所选展现样式按需加载。
升级日志
- 文档图片相册后台管理与排序
- 文档编辑器 inline 图集 Tab
- 前台 `` 标签展示
购买与安装
- 登录官网会员，在本页右侧选择限时免费套餐完成开通（到期后须续费或升级）。
- 在 用户中心 → 我的授权 绑定客户站域名并同步到站点后台。
- 客户站 → 应用市场 搜索
doc_gallery在线安装并启用。
交易须知
- 交付形式官方插件 · 授权安装；通过应用市场安装，不提供独立源码包下载。
- 授权范围插件授权绑定单个站点域名；小程序类 SKU 规则以套餐说明为准。
- 限时免费免费授权含有效期，到期后功能受限；续费或升级付费套餐可继续使用。
- 退款规则请确认功能需求后再购买；非功能缺陷恕不退款。
- 官方保障官方插件由元舟提供安装指导与技术支持。