请从左侧列表选择公告查看详情
LEAF媒体库文件上传工具


我在日常迁站/换域名时,最麻烦的往往不是“把文件拷过去”,而是数据库里的旧域名(链接、图片地址、设置项、区块数据、短代码等)要替换成新域名。
更麻烦的是:WordPress 里大量数据是序列化存储的,直接“全库字符串替换”容易把序列化长度搞坏,导致站点异常。
所以这次把一套“更稳、更可控”的迁移方案做进插件:在后台上传 SQL 备份,按需选择导入/不导入,并用序列化安全替换完成域名迁移。
功能一:媒体库去重——删除保护开关

当检测到重复媒体时,如果“将被删除的重复项”已经在文章中被引用,默认会跳过删除,避免误删造成文章缺图。
如果你已经确认引用会被替换(或确定无引用),可以在设置里开启“允许删除已在文章中使用的重复项”。
适合场景:
– 迁站后统一替换引用:确认后可放开删除
功能二:媒体导入——图片内容去重开关(单次任务可控)

在“媒体 → LEAF媒体导入”页面新增“导入时启用图片内容去重”。
同内容图片只导入一次,避免素材重复占用空间;同时支持单次任务开关,不需要先去设置页保存。
适合场景:
– 批量整理素材:开启,保证媒体库干净
– 同图多版本保留:关闭,允许重复入库
功能三:数据库迁移(换域名)——导入并替换
入口:工具 → LEAF数据库迁移(换域名)
上传 `.sql` 或 `.sql.gz`,选择导入模式后执行:
– 覆盖导入:按 SQL 原样执行(可能包含 DROP/CREATE)
– 加入导入:跳过 DROP/CREATE/TRUNCATE,INSERT 自动改为 INSERT IGNORE(更适合合并到现有库)
导入完成后,会对数据库的文本字段进行“序列化安全替换”:能处理序列化数组/对象,避免替换后站点异常。
强烈建议:操作前先备份当前数据库。
功能四:数据库迁移(换域名)——仅生成替换后的 SQL 并下载(不导入)

如果你不想直接修改当前数据库,可以选择“仅生成替换后的 SQL 并下载”:
插件会把上传的 SQL 进行流式解析与安全替换,生成一个新的 replaced.sql,生成完成后可一键下载。
适合场景:
– 先在本地/测试环境验证,再导入线上
– 交给其它迁移工具继续处理
– 只需要一个“换好域名”的 SQL 成品
功能五:替换规则更灵活(多格式 + 多规则 + 边界匹配)

除了“旧域名→新域名”,还支持:
– 同时替换 http→https(统一到 https)
– 同时替换裸域名(old.com→new.com)
– 额外替换规则:每行一条,支持
– `old => new` / `old=new` / `old->new`
– 左侧逗号分隔多个 old:`a.com, b.com => new.com`
– 分号分隔多条:`a=>b; c=d`
– 可选:忽略大
– 可选:整域名边界匹配(避免 old.com 命中 old.com.cn)
## 使用提示(经验总结)
– 数据库导入与删除不可逆,务必先备份。
– 如果只想“换域名”不想改当前库,优先用“仅生成并下载”,最安全。
– 替换规则越多越强,越要在测试环境先跑一遍确认效果。
插件介绍:
=== LEAF媒体库文件上传工具 ===
Contributors: leaf
Tags: media, import, upload, library
Requires at least: 5.8
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 1.0.11
License: GPLv2 or later
批量扫描服务器目录,将图片/视频导入到WordPress媒体库。
== Description ==
启用插件后,会自动使用默认扫描目录(位于上传目录下的 leaf-media-import 目录)。
将待导入的图片/视频放入该目录(可包含子目录),然后在“媒体 → LEAF媒体导入”中点击“开始扫描并导入”即可。
支持格式:jpg、jpeg、png、gif、webp、mp4、avi、mov、wmv
== Installation ==
- 上传插件目录到 wp-content/plugins/,或通过后台上传ZIP安装
- 启用插件
- 进入“媒体 → LEAF媒体导入”
== Frequently Asked Questions ==
= 扫描目录在哪里? =
默认在 wp-content/uploads/leaf-media-import ,可在“设置 → LEAF媒体导入”中修改。
更新日志:
## v1.0.15
– 增强:额外替换规则支持 `old=new`、`old->new`、左侧逗号分隔多个 old
– 新增:额外替换规则支持忽略大小写、整域名边界匹配选项
## v1.0.14
– 增强:生成 SQL 模式支持同时替换 http→https、替换裸域名(old.com→new.com),并支持追加多条替换规则
## v1.0.13
– 新增:数据库迁移支持“仅生成替换后的 SQL 并下载(不导入)”模式
## v1.0.12
– 新增:LEAF数据库迁移(换域名)工具页,支持上传 SQL 备份导入并安全替换旧域名为新域名
– 支持:覆盖导入 / 加入导入(跳过 DROP/CREATE,INSERT 改为 INSERT IGNORE)
– 支持:仅处理当前站点表前缀(避免误改其它表)
## v1.0.11
– 新增:去重删除支持开关“允许删除已在文章中使用的重复项”(默认保护不删除)
– 新增:导入页面支持开关“图片内容去重”,可单次覆盖设置
= 1.0.10 =
- 新增:SVG 转 PNG 支持选择白底/透明底与输出宽度(需 Imagick)
= 1.0.9 =
- 改进:按文件夹日期设置媒体日期新增支持 YYYY_MM_DD 与“YYYY年MM月DD日”
- 修复:媒体库框选不再影响普通单击打开
- 新增:导入 SVG 时可自动转换为 PNG 入库(需 Imagick)
= 1.0.8 =
- 改进:按文件夹日期设置媒体日期支持 YYYYMM 与 YYYY-MM-DD/点号格式
= 1.0.7 =
- 改进:按文件夹日期设置媒体日期支持“YYYYMMDDxxx”前缀目录(如 20231105bjcc)
= 1.0.6 =
- 新增:按源文件夹“YYYY/MM(或YYYY/MM/DD)”自动设置媒体日期,并尽量写入对应 uploads 年/月目录
= 1.0.5 =
- 改进:媒体库框选支持从缩略图上直接拖拽开始(无需先找到空白处)
= 1.0.4 =
- 修复:媒体库框选在部分环境未生效的问题(改为全局事件绑定)
= 1.0.3 =
- 新增:媒体库重复检测与删除(精准内容哈希、视觉相似去重)
- 新增:媒体库网格视图支持鼠标框选,批量删除更快
= 1.0.1 =
- 改进:错误提示更明确,便于定位导入失败原因
- 改进:图片支持按内容去重导入,避免重复入库
= 1.0.0 =
- 初版:目录扫描、批量导入、进度与统计、设置与日志