请从左侧列表选择公告查看详情
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 =
- 初版：目录扫描、批量导入、进度与统计、设置与日志