Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/imlaojiang/laoimg/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
LaoIMG - WordPress自定义图片和附件重命名插件
插件简介
laoimg 是一款专业的WordPress插件,用于自定义上传图片和附件的命名规则。支持多种命名格式,帮助您更好地管理媒体文件。
要求: PHP 8.0 或更高版本
插件原出处和下载地址:https://www.itbulu.com/laoimg.html
功能特性
核心功能
- ✅ 插件开关控制 - 可随时启用或禁用插件功能
- ✅ 多种命名格式 - 支持6种命名格式(原始、MD5、时间戳、自定义前缀、日期格式、序号)
- ✅ 灵活应用范围 - 可选择应用到图片或附件,或两者都应用
- ✅ 自动保留扩展名 - 始终保留原始文件扩展名
- ✅ 文件类型过滤 - 支持白名单/黑名单,精确控制哪些文件需要重命名
- ✅ 文件名长度限制 - 防止文件名过长导致的问题
- ✅ 冲突处理 - 自动处理文件名冲突,添加序号后缀
- ✅ PHP 8.0+ 兼容 - 完全兼容PHP 8.0及以上版本
- ✅ 安全可靠 - 符合WordPress官方开发规范,包含完整的安全措施
命名格式选项
- 原始格式 - 保持上传文件的原始文件名
- MD5随机命名 - 生成32位MD5哈希值,确保唯一性
- 时间戳命名 - 使用Unix时间戳加随机数
- 自定义前缀 - 自定义前缀 + 时间戳 + 随机数
- 日期格式命名 - 按日期组织文件,支持自定义日期格式(如:2026-01-26_file_1234.jpg)
- 序号命名 - 按序号命名,支持起始序号、递增步长、位数补零(如:file_001.jpg, file_002.jpg)
安装方法
- 将
laoimg文件夹上传到/wp-content/plugins/目录 - 在WordPress后台的"插件"页面中激活插件
- 前往"设置" > "laoimg" 进行配置
使用方法
- 进入WordPress后台,点击"设置" > "laoimg"
- 勾选"启用插件"开启功能
- 选择要应用的文件类型(图片/附件)
- 选择命名格式:
- 原始格式:不修改文件名
- MD5命名:生成MD5哈希值
- 时间戳命名:时间戳_随机数
- 自定义前缀:前缀_时间戳_随机数
- 日期格式:日期_前缀_随机数(可自定义日期格式)
- 序号命名:前缀_序号(可设置起始序号、步长、位数)
- 根据选择的命名格式配置相关选项:
- 自定义前缀:填写前缀名称
- 日期格式:设置PHP日期格式(如:Y-m-d)
- 序号设置:设置起始序号、递增步长、位数补零
- 设置文件名最大长度(10-255字符)
- 配置文件类型过滤(可选):
- 白名单:只处理列表中的文件类型
- 黑名单:不处理列表中的文件类型
- 点击"保存设置"
注意:插件会自动保留原始文件扩展名,无需额外配置。
文件结构
laoimg/
├── laoimg.php # 主插件文件
├── uninstall.php # 卸载文件
├── README.md # 说明文档
├── admin/
│ └── settings.php # 后台设置页面
└── includes/
└── core.php # 核心功能文件
技术规范
- ✅ 符合WordPress插件开发规范
- ✅ 使用WordPress原生API和函数
- ✅ 遵循WordPress编码标准
- ✅ 支持国际化(i18n)
- ✅ 安全的选项处理和验证
- ✅ 完整的卸载清理功能
- ✅ PHP 8.0+ 兼容性
- ✅ 完整的安全措施(权限检查、Nonce验证、输入清理、输出转义)
系统要求
- PHP版本: 8.0 或更高(推荐 8.1+)
- WordPress版本: 5.0 或更高
- 权限: 管理员权限(用于配置设置)
版本历史
1.1.0
- ✨ 新增日期格式命名选项
- ✨ 新增序号命名选项
- ✨ 新增文件类型白名单/黑名单功能
- ✨ 新增文件名长度限制功能
- 🔧 改进文件名冲突处理(自动添加序号)
- 🔧 要求PHP 8.0+版本
- 🔒 加强安全功能,符合WP官方开发规则
1.0.0
- 初始版本发布
- 实现基本的文件重命名功能
- 支持多种命名格式
- 后台设置界面
开发者
老蒋部落:www.itbulu.com
乐在云工作室:www.lezaiyun.com