- SVG / JPEG / WebP 输出与标签独立尺寸
- 按标题 seed 生成炫彩占位图，支持水印
- 批量预热缓存与后台缩略图策略配置
平台能力
动态缩略图
文档没有封面时，按标题自动生成彩色占位图，并可批量预热缓存。
商品属性
品牌官方插件
语言PHP 8.1+
数据库MySQL 5.7+ / MariaDB
环境PivArk 1.5+ · weapp 标装
类型平台能力
版本v1.2.0
编码UTF-8
交付方式官方插件 · 授权安装
商品介绍
这个插件能帮你做什么？
当文档没有上传封面，或封面仍是主题自带的灰色占位图时，系统会按文档标题自动生成一张炫彩占位缩略图， 让新闻列表、产品卡片、相关推荐不再出现「空白方块」。
与 图集（gallery） 分工：thumb 解决「列表没图」；gallery 解决「正文里多图相册」。
什么时候会自动出图？
| 文档封面情况 | 前台表现 |
|---|---|
litpic 为空 | 生成彩色占位图（标题文字 + 渐变背景） |
URL 含占位规则（如 preview.svg、no_pic） | 视为无效封面，生成占位图 |
| 已上传真实封面 URL | 保持原图不变 |
| 封面 URL 已失效（404） | 开启「坏链回退」后，列表图片加载失败时自动换占位图 |
怎么用？（运营向四步）
- 插件中心安装并授权「动态缩略图」。
- 进入 插件 → 动态缩略图 → 基础设置，打开功能开关。
- 选择默认宽高、模板风格（炫酷 / 渐变 / 简约 / 几何 / 毛玻璃）、输出格式（推荐 SVG）。右侧可实时预览。
- 按需配置：水印文字、标签独立尺寸、占位路径规则、坏链回退、保存后重建静态页 → 点击保存配置。
后台还能做什么？
- 占位路径规则：每行一条 URL 片段，与内置规则（
preview.svg、default_litpic等）合并识别。 - 标签独立尺寸：关闭「响应式尺寸」时，文档主标签可指定不同宽高（如产品 400×400、新闻 320×240）。
- 缓存维护：清除全部或指定标签下的生成缓存；批量预热无图文档（可选按标签）。
- 静态 HTML 联动：站点开启静态页时，保存配置可自动排队重建首页、频道与占位封面文档页。
- JPEG / WebP：需服务器安装 Imagick 或 GD；未安装时自动回退 SVG，后台会提示。
对模板作者友好
绝大多数站点无需改模板：内核在列表、详情、相关推荐、API 输出前自动写入
litpic / thumb_url。现有 <img src=""> 即可生效。
需要自定义时可使用 ，详见本插件 Tab「前台调用说明」。
使用说明
功能简介（前端向）
动态缩略图由内核自动注入列表/详情字段；模板作者通常只需使用 。
需要固定尺寸或直链 URL 时，可使用 标签或 REST 图片地址。
推荐写法（零改动）
频道 / 标签列表循环内：
<img src="" alt="" loading="lazy">
文档详情页：
以上字段已由内核处理：无图 → 占位图 URL；有真实封面 → 原 URL。
显式标签
输出完整 <img>（属性见下表）：
<img src="" alt="" loading="lazy">
仅输出 URL 字符串（用于背景图、JSON-LD 等）：
litpic 标签别名（与 thumb 等价）：
标签属性
| 属性 | 说明 | 示例 |
|---|---|---|
id / aid / document_id | 文档 ID（决定 seed 与标题） | id="$field.id" |
litpic / thumb / image | 库内封面 URL | litpic="$field.litpic" |
title / text / name | 占位图显示文字 | title="$field.title" |
tag_id / typeid | 标签 ID（命中标签独立尺寸） | tag_id="12" |
width / w | 宽度像素 | width="320" |
height / h | 高度像素 | height="240" |
seed | 无文档 ID 时的自定义 seed | seed="custom-key" |
mode | url 仅输出 URL；默认输出 img 片段 | mode="url" |
列表 / API 注入字段
以下字段在 、文档 API、相关推荐等场景自动可用：
| 字段 | 说明 |
|---|---|
| 最终展示 URL（无图时为占位图） |
| thumb 插件解析结果（与 litpic 在无图/占位时一致） |
| 有真实封面时：坏链回退用的占位图 URL（API/H5 可用） |
图片直链 URL
GET /api/v1/plugins/doc_thumb/{文档ID}.svg?w=400&h=300
GET /plugins/doc_thumb/{文档ID}.svg?w=400&h=300
Query 参数（均可选）：
| 参数 | 说明 |
|---|---|
w / h | 宽高；开启「响应式尺寸」时 URL 参数优先生效 |
text | 覆盖占位图文字 |
tag_id | 指定标签以命中独立尺寸 |
template | 临时覆盖模板：vibrant / gradient / minimal / geometric / glass |
format | svg / jpeg / webp |
响应：200 图片二进制；若文档有有效封面则 302 跳转原图。
文档列表 API 示例
GET /api/v1/documents?tag_id=1&page=1
JSON 每条记录含 litpic、thumb_url；有真实封面且开启坏链回退时另有 thumb_fallback_url。
内置列表 HTML 坏链回退
内核渲染的默认列表布局（如演示站 demo-news）在真实封面 404 时会附加 onerror 回退占位图；自定义模板若需同样行为，可参考：
<img src="" alt="" onerror="this.onerror=null;this.src=''" loading="lazy">
需在后台开启「坏链回退」；无真实封面时 thumb_fallback_url 可能为空。
升级日志
- 文档无缩略图时自动生成占位图
购买与安装
- 登录官网会员，在本页右侧选择限时免费套餐完成开通（到期后须续费或升级）。
- 在 用户中心 → 我的授权 绑定客户站域名并同步到站点后台。
- 客户站 → 应用市场 搜索
doc_thumb在线安装并启用。
交易须知
- 交付形式官方插件 · 授权安装；通过应用市场安装，不提供独立源码包下载。
- 授权范围插件授权绑定单个站点域名；小程序类 SKU 规则以套餐说明为准。
- 限时免费免费授权含有效期，到期后功能受限；续费或升级付费套餐可继续使用。
- 退款规则请确认功能需求后再购买；非功能缺陷恕不退款。
- 官方保障官方插件由元舟提供安装指导与技术支持。