WP Media Toolkit：让 WordPress 媒体库更容易管理

WordPress 媒体库用久以后，最让我犹豫的通常不是怎么上传图片，而是另一些问题：这个附件有多大、在哪里被引用、能不能安全删除，以及如何统一团队的上传规则。

WP Media Toolkit 是我为这些日常问题整理的轻量媒体增强插件。它不依赖 Elementor 等页面构建器，各模块默认关闭，可以在「媒体」菜单中按实际需要开启。

一、在媒体列表中看到真正有用的信息

开启列表增强后，WordPress 媒体库会增加文件大小、图片分辨率和引用次数三列。文件大小来自实际附件文件，分辨率优先读取附件元数据；数据缺失时再尝试读取图片文件。

引用次数通过后台 AJAX 批量加载，避免在列表初次渲染时直接执行所有查询。有引用的附件可以点击数字进入编辑页，继续查看具体使用位置。

插件会在附件编辑页显示图片的使用位置，搜索范围不只包括文章正文，还包括特色图、文章 meta、option 和用户资料等场景。对于常见的 JPG、PNG 与 WebP 转换，也会尝试匹配不同尺寸、相对上传路径和对应的文件名变体。

这项功能的目标不是替人直接删除文件，而是把判断依据补齐。如果没有找到引用，会显示未使用提示；如果只找到 meta 类型引用，则会提醒手动检查，避免把系统元数据误当成可以直接删除的无效记录。

仅在后台写一句「图片不要超过某个大小」很容易被忽略，所以插件同时处理提示和上传校验。管理员可以按 KB 设置单文件上限，开启后不仅媒体页会显示提示，上传预过滤和 WordPress 的上传大小上限也会一起生效。

格式控制使用禁止列表：JPG、PNG、WebP、PDF、CSV 等常见类型都可以按需禁用。与只修改界面提示不同，插件会同步调整允许的 MIME 类型，并在上传和 sideload 阶段返回明确错误。

SVG 是单独的开关，并且只允许拥有 manage_options 权限的管理员上传。当前版本不对 SVG 内容做消毒，因此设置页会明确提示风险，不适合接收不可信来源的 SVG 文件。

如果站点使用 Simple Local Avatars，可以选择启用兼容补丁。它会根据当前上传目录重写头像数据里的旧域名，处理开发、测试和正式环境切换后头像 URL 仍指向旧站点的问题。

补丁还针对更换头像时的删除流程保留媒体 ID 和原图信息，降低误删媒体库原文件的风险。没有安装 Simple Local Avatars 时，开启这个选项也不会强制产生依赖。

插件内置了前台图片灯箱，支持放大、缩小、恢复 1:1，以及上一张、下一张切换。样式和脚本由插件自己提供，不依赖主题中的 Tailwind 或其他前端框架。

预览不是全站无差别绑定，而是通过容器元素 ID 指定范围。后台可以每行填写一个 ID，也可以在主题或其他插件中调用公共 API：

if ( function_exists( 'wpmt_image_preview_init' ) ) {
    wpmt_image_preview_init( 'article-content' );
}

API 注册的选择器会与后台配置合并去重。即使后台总开关关闭，只要代码调用了 API，对应容器仍会加载预览功能。emoji 和标记为图标的图片会被排除，避免普通 UI 图标也被当成内容图片打开。

WP Media Toolkit 适合图片较多、多人维护，或需要明确上传规范的 WordPress 站点。它把「查看信息、判断引用、限制上传、前台预览」放在同一个插件中，但每项能力仍可独立开关。

它不会替代专业图片压缩、SVG 消毒或完整的数字资产管理系统。更合适的用法，是把它作为 WordPress 媒体库的日常辅助层：上传前落实规则，删除前提供线索，展示时按指定区域补充预览体验。

WP Media Toolkit 已在 GitHub 开源：

如果这个插件对你的媒体管理有帮助，欢迎到 GitHub 点一个 Star。使用中遇到问题或有新的需求，也欢迎提交 Issue。