LoadImagesPlugin 插件说明文档

一、简介

LoadImagesPlugin 是为 Grav CMS 编写的图片加载与管理插件，支持递归扫描图片目录，提取图片信息，生成缩略图，并提供 API 接口。

二、主要功能

• 递归扫描图片目录（支持子目录）
• 提取图片尺寸、EXIF信息（描述、日期）
• 生成图片缩略图
• 支持分类管理（目录作为类别）
• 支持排序（日期、名称、类别）
• 支持分页加载
• 缓存机制提升性能

三、配置参数

四、API接口示例

• 获取所有分类：GET /loadimages?categorylist=1
• 获取特定类别图片（分页）：GET /loadimages?category=travel&page=1&limit=20
• 排序示例：GET /loadimages?category=travel&sort=date&order=desc

返回内容（JSON）示例：

{
  "total": 120,
  "images": [
    {
      "url": "/images/uploads/travel/img1.jpg",
      "name": "IMG_20240101",
      "category": "travel",
      "width": 1920,
      "height": 1080,
      "date": "2024-01-01",
      "timestamp": 1704067200,
      "description": "A beautiful sunrise",
      "thumbnailUrl": "/images/cache/abc123.jpg"
    },
    ...
  ]
}

五、插件下载

loadimages.zip