1. 插件简介

媒体文件夹增强 是一款专为 WordPress 中文用户打造的媒体库 & 内容文件夹管理插件。

核心能力包括：

• 无限层级树形文件夹管理（媒体库、文章、页面、自定义文章类型、插件页面）
• 拖拽式媒体分类（支持单选/多选/批量整理）
• 上传时选择目标文件夹（所有后台上传入口通用）
• 媒体悬停元数据卡片（跟随鼠标 4 象限自动翻转）
• 媒体原地替换（保留原 URL 和附件 ID）
• 媒体回收站 & 未使用媒体清理
• 动态文件夹（按年月/作者/类型/未分类自动分组）
• SVG 安全上传、自动重命名、ZIP 下载
• 角色权限 & 用户权限精细控制
• 邮件通知（新上传/删除/文件夹变更/用户删除）
• 配置导入导出 & 第三方插件迁移（WPMF / Real Media Library / FileBird）

2. 快速上手（3 分钟）

Step 1：开启内容类型

进入 设置 → 媒体文件夹增强 → 文件夹设置，在「启用文件夹的内容类型」中勾选你需要的类型（至少勾选「媒体库」），保存。

Step 2：创建文件夹

进入 媒体库，在左侧栏点击 「+ 新建文件夹」，或右键空白 → 新建文件夹。支持多级嵌套：在任意文件夹上右键 → 新建子文件夹。

Step 3：拖拽分类

在右侧媒体网格里，点选或按住 Shift 多选图片，按住鼠标左键拖到左侧文件夹即可移动。拖到目标文件夹时会出现稳定的蓝色高亮边框，松手即刻移动成功，媒体库会自动刷新并跳转到目标文件夹。

Step 4：自定义设置

打开设置页面的各个选项卡，开启你需要的功能：悬停元数据、媒体替换、批量下载 ZIP、媒体回收站、SVG 上传等。改完点击「保存更改」，然后 Ctrl + F5 强刷缓存即可生效。

3. 核心功能详解

3.1 文件夹操作

3.2 拖拽与媒体移动

支持两种拖拽模式：

• 内部移动：从右侧媒体网格拖到左侧文件夹（不会显示蓝色全屏上传蒙层，文件夹有高亮）
• 上传到指定文件夹：从电脑桌面拖真实文件进来，拖到具体文件夹松手上传，上传后媒体自动进入该文件夹

3.3 上传时选择目标文件夹

在任何后台页面的媒体上传模态框里（编辑文章、页面、小工具、自定义器、媒体库等），切换到「上传文件」Tab 时，「选择文件」按钮下方会自动出现一个紧凑的文件夹选择器：

• 选择目标文件夹后立即生效，无需点「应用」按钮
• 选择后，拖入或点选上传的文件自动归入此文件夹
• 选择器会记忆上次选择，下次打开模态框自动恢复
• 与媒体库浏览 Tab 的筛选器双向同步

前提条件：必须在「文件夹设置」→「在哪些内容类型启用」里勾选「媒体(attachment)」。文章/页面类型不需要勾选——只要媒体勾选了，编辑文章时的上传模态框也会有选择器。

技术实现：通过 6 层兜底机制确保选择器在各种场景下都能出现并持久存在（Tab 切换不消失）：

1. Modal.prototype.open 补丁
2. UploaderInline.render 同步注入（并入 Backbone 渲染链）
3. 长驻 MutationObserver
4. 自适应轮询（活跃 300ms/次，空闲 4s/次，无限运行）
5. Tab 切换监听
6. 点击按钮延迟扫描

3.4 媒体悬停元数据

在设置「文件夹设置」→ 媒体悬停字段中勾选要显示的列（标题/尺寸/类型/上传日期/文件大小/作者等），鼠标停在媒体缩略图上无需点击即可查看。

卡片会跟随鼠标位置自动做 4 象限翻转定位，就算缩略图在屏幕角落也不会被裁切。

3.5 媒体替换（原地替换附件，不换 URL）

需要更新某个图片但保留原始链接时使用：

1. 在媒体列表模式或媒体编辑页，找到「替换媒体」按钮
2. 上传新文件（支持同格式或不同格式）
3. 系统会保持原附件 ID / URL 不变，旧文件按设置保留副本时间或立即覆盖
4. 所有引用此附件的文章/页面自动显示新图，不用重新插入

可选设置：替换媒体文件时同步更新媒体标题。

3.6 媒体回收站

开启后，误删媒体不会真的从数据库删掉：

• 左栏出现回收站文件夹，30 天内可恢复（时间可配置）
• 超过保留天数自动永久删除
• 恢复后媒体原文件夹归属不变

3.7 媒体清理（检测 & 移除未使用附件）

清理没有被任何文章/页面/菜单/小工具/特色图像引用的「孤儿附件」，节省空间。

注意：清理前一定要先备份数据库和 wp-content/uploads。建议先「扫描查看结果列表」，确认都是没用的再点「清理」。

3.8 动态文件夹（智能自动分类）

开启后会自动生成以下只读虚拟文件夹，媒体一上传就自动归档：

可设置「动态文件夹仅管理员可见」。

3.9 内容类型白名单

每个内容类型的启用是独立的，没勾选则对应页面完全不显示文件夹管理（不注入侧边栏/不加载 JS CSS/不做查询过滤）。

提示：如果只想在编辑文章时使用上传文件夹选择器，但不想在文章列表页显示文件夹侧边栏，可以只勾选「媒体」不勾选「文章」。编辑文章时的媒体上传模态框仍然会有选择器（已做特殊放行）。

3.10 其他实用功能

4. 设置选项卡详解

4.1 文件夹设置（常规）

80% 的功能开关都在这：

4.2 外观自定义

4.3 导入/导出

4.4 角色权限

按 WordPress 角色设置文件夹系统访问级别：

可按角色（管理员/编辑/作者/投稿者）分别设置。

4.5 用户权限

按用户单独指定权限，适合：

• A 用户只能看自己的文件夹
• B 用户是共享管理员

用户权限优先级高于角色权限。

4.6 邮件通知

4.7 使用说明/教程

就是当前说明文档的后台版本，包含快速上手、核心功能详解、快捷键速查、设置选项卡速览、常见问题 FAQ。

5. 快捷键速查表

以下快捷键需先在「文件夹设置」中开启「启用键盘快捷键」（默认开启）。

6. 联系支持

发邮件时请附上：WordPress 版本、插件版本、问题截图、复现步骤。