网站运行时间越长，WordPress 媒体库中往往会积累大量历史图片、无效附件和未关联文件。这些文件不仅增加服务器存储占用，也会让媒体库越来越杂乱，给日常维护、网站迁移和数据备份带来额外负担。

Gaaai Media Delete 是一款面向 WordPress 网站管理员开发的媒体批量清理插件。它支持按照文章分类、上传时间和媒体关联状态筛选附件，在正式删除之前生成预览，并提供删除当前页、批量删除全部匹配结果等功能，帮助管理员更加高效、可控地整理媒体库。

插件主要功能

多条件筛选，快速定位目标媒体

Gaaai Media Delete 支持组合使用多种筛选条件，减少误删风险。

按文章分类筛选

选择指定文章分类后，插件会查找附加在该分类文章下的媒体文件。

这种方式适合以下场景：

• 清理已经停止维护的栏目图片；
• 删除测试分类中的历史附件；
• 整理指定项目或专题产生的媒体文件；
• 清理准备下线的文章分类资源。

需要注意的是，分类筛选针对的是媒体所关联的父文章，而不是给媒体文件单独设置分类。

按上传时间筛选

可以设置开始日期和结束日期，查找指定时间范围内上传的媒体。

例如：

• 清理某次批量导入产生的图片；
• 删除测试阶段上传的临时文件；
• 清理某个项目周期内产生的附件；
• 按年度或月份整理历史媒体。

开始日期和结束日期可以单独使用，也可以组合使用。

筛选独立媒体

启用“仅显示独立媒体”后，插件会筛选没有附加到文章的媒体文件。

独立媒体通常包括：

• 上传后未插入文章的图片；
• 删除文章后遗留的附件记录；
• 测试上传的临时文件；
• 批量导入过程中产生的无关联文件。

需要说明的是，WordPress 中显示为“未附加”的媒体，不一定代表网站前端没有使用该文件。例如主题设置、插件设置、自定义字段或手动填写的图片地址，也可能引用独立媒体。因此，删除前仍应通过预览列表确认文件用途。

删除前先预览，操作更加可控

设置筛选条件后，点击“生成预览”，插件会显示：

• 匹配到的媒体总数；
• 当前预览页码；
• 媒体附件 ID；
• 媒体标题；
• 文件访问地址；
• 上传时间；
• 父文章 ID。

管理员可以在正式删除前检查匹配结果，确认筛选条件是否正确。

预览数量可根据实际需求进行设置，单页最多可显示 500 个媒体。媒体数量较多时，还可以通过上一页和下一页查看完整结果。

支持两种删除方式

彻底删除

选择“彻底删除”后，插件会同时删除：

• WordPress 数据库中的附件记录；
• 附件相关的元数据；
• 服务器 uploads 目录中的实际文件；
• WordPress 自动生成的缩略图文件。

适合确定不再需要这些媒体文件的清理场景。

仅删除数据库记录

选择“仅删除数据库记录”后，插件会删除 WordPress 中的附件记录和相关数据，但保留服务器上的实际文件。

适合以下场景：

• 只想整理 WordPress 媒体库记录；
• 文件仍需由其他系统继续使用；
• 准备手动整理 uploads 目录；
• 需要保留服务器原始文件作为备份。

仅删除数据库记录后，保留在服务器上的文件将不会继续显示在 WordPress 媒体库中。

删除当前页或全部匹配结果

删除当前页

“删除当前页”只处理当前预览页面显示的媒体。

这种方式适合：

• 少量媒体清理；
• 分页检查后逐页删除；
• 希望对每一批文件进行人工确认；
• 首次使用插件时进行小范围测试。

删除全部匹配结果

确认筛选条件无误后，可以使用“删除全部匹配结果”，自动删除所有符合条件的媒体文件。

插件采用分批处理方式，不会在一次请求中直接处理全部文件，可以降低大量媒体删除时发生请求超时或服务器中断的概率。

删除过程中会实时显示：

• 已删除数量；
• 匹配媒体总数；
• 当前完成百分比；
• 删除任务状态。

支持暂停与继续删除

在批量删除全部匹配结果时，可以点击“暂停”。

插件会在当前批次处理完成后停止继续请求，并保留已经完成的删除结果。之后点击“继续删除全部匹配结果”，即可继续处理剩余文件。

该功能适合媒体数量较多、服务器性能有限，或者需要临时停止操作的场景。

独立后台管理菜单

安装并启用插件后，WordPress 后台会增加独立菜单：

Gaaai 媒体删除

所有筛选、预览和删除操作都集中在同一个管理页面中，不需要进入 WordPress 默认媒体库逐个选择文件。

后台同时提供“帮助与更新”入口，可在新标签页中打开插件说明页面，方便查看使用教程、更新记录和后续版本信息。

安全与权限控制

Gaaai Media Delete 的删除功能仅允许具有网站管理权限的用户使用，并通过 WordPress 权限检查和安全验证机制处理后台请求。

在执行删除前，插件还会显示二次确认提示，降低误操作风险。

不过，媒体删除属于不可逆操作，特别是选择“彻底删除”后，服务器上的实际文件也会被移除。因此，正式清理前建议先完成网站文件和数据库备份。

适用场景

Gaaai Media Delete 适合用于：

• WordPress 媒体库长期未清理；
• 网站存在大量未附加媒体；
• 需要清理指定文章分类的附件；
• 需要删除指定时间范围内上传的文件；
• 网站改版后清理历史图片；
• 测试站转正式站前整理媒体库；
• 数据迁移或网站备份前减少无效文件；
• 批量导入失败后清理残留附件；
• 降低服务器存储空间占用；
• 提高媒体库日常管理效率。

使用方法

1. 安装并启用 Gaaai Media Delete 插件。
2. 进入 WordPress 后台的“Gaaai 媒体删除”。
3. 选择文章分类、上传时间或独立媒体筛选条件。
4. 设置每页预览数量。
5. 选择彻底删除或仅删除数据库记录。
6. 点击“生成预览”检查匹配结果。
7. 选择“删除当前页”或“删除全部匹配结果”。
8. 批量删除时可根据需要暂停或继续。
9. 删除完成后重新检查媒体库和网站前端页面。

使用建议

正式清理前，建议先执行以下操作：

• 备份 WordPress 数据库；
• 备份 wp-content/uploads 目录；
• 先设置较小的时间范围进行测试；
• 先使用“删除当前页”验证筛选结果；
• 检查主题设置、插件设置和自定义字段是否引用目标图片；
• 确认无误后，再删除全部匹配结果。

插件优势总结

让 WordPress 媒体管理更简单

Gaaai Media Delete 不只是一个删除工具，更是一套 WordPress 媒体库整理方案。

通过智能筛选、安全预览和批量处理，可以帮助站长快速清理无效附件，释放服务器空间，提高网站维护效率。

对于长期运营的 WordPress 网站，定期清理媒体库，是保持网站轻量、高效运行的重要步骤。

立即使用 Gaaai Media Delete，让 WordPress 媒体管理更加简单、高效、安全。