Image Clear

# Image Cleaner

WordPress 图片清理插件，删除未被引用的图片。

## 功能

### 1.0 版本

– 删除文章时自动删除其附带的未被其他文章引用的图片
– 检测文章内容中的图片 URL
– 可选择删除文章时一并删除特色图片
– 可设置排除特定关键字的图片
– 记录删除操作的日志

### 2.0 版本新增

– 手动扫描媒体库，显示未使用的图片
– 批量选择和删除图片
– 显示图片缩略图
– 检测图片在以下位置的引用：
– 文章和页面内容
– 特色图片设置
– 小工具和菜单
– 主题自定义设置
– 页面构建器（Elementor、WPBakery 等）
– 插件设置（智能过滤误报）
– 用户头像
– 自定义字段
– 筛选功能：
– 按图片类型（未使用/ 有引用）
– 按文件大小
– 按上传日期
– 按文件类型（JPG、PNG、GIF、WebP、SVG）
– 显示图片的引用位置和类型
– 显示文件大小、上传时间
– 删除前确认
– 详细的调试日志

## 安装

1. 上传插件文件夹到 `/wp-content/plugins/`
2. 在 WordPress 后台启用插件

## 使用

### 自动清理（1.0 功能）

– 启用插件后，删除文章时会自动删除未引用的图片
– 在” 图片清理” 设置页面配置选项

### 手动扫描（2.0 功能）

1. 进入” 图片清理” 设置页面
2. 设置筛选条件
3. 点击” 开始扫描”
4. 查看结果，选择要删除的图片
5. 点击” 删除选中图片”

### 设置选项

– 选择要检测的文章类型
– 设置是否删除特色图片
– 启用/ 禁用日志
– 设置排除关键字

## 版本对比

| 功能 | 1.0 | 2.0 |
| ——– | —- | —- |
| 自动清理 | ✓ | ✓ |
| 手动扫描 | ✗ | ✓ |
| 引用检测 | 基础 | 全面 |
| 误报过滤 | ✗ | ✓ |
| 批量操作 | ✗ | ✓ |
| 筛选功能 | ✗ | ✓ |
| 详细日志 | 基础 | 完整 |

## 注意事项

– 操作前请备份数据
– 只删除未被引用的图片
– 2.0 版本移除了幽灵图片检测功能

## 兼容性

– WordPress 6.0+
– 测试过 `7B2`、`Zibll` 主题
– 理论上兼容所有主题

## 更新日志

### v2.0.0

– 新增媒体库扫描
– 新增全面引用检测
– 新增误报过滤
– 新增批量操作
– 新增筛选功能
– 优化检测算法
– 移除幽灵图片检测

### v1.0.0

– 基础图片清理
– 自动删除未引用图片
– 基础日志