LeTinypng

一款轻量的 WordPress 图片上传压缩插件：在图片上传到媒体库时，自动调用 TinyPNG（Tinify）API 对图片进行压缩优化，显著降低体积、提升加载速度；并支持可选的 JPEG/PNG 转 WebP。

• 插件说明地址：https://www.itbulu.com/letinypng.html
• 插件开发者主页（老蒋）：https://www.laojiang.me/
• 公众号：老蒋朋友圈

功能特性

• 上传后自动压缩：对新上传到媒体库的图片进行压缩优化
  • 支持格式：JPEG / PNG / WebP
• 开关控制：只有在后台勾选「开启压缩」后才会压缩；你也可以先保存 API Key，需要时再开启
• 可选转换为 WebP：上传 JPEG/PNG 时，压缩后再转换成 WebP 保存
  • 注意：转换为 WebP 会额外消耗 1 次 TinyPNG 额度/张
  • 最终文件以 .webp 保存，原格式文件会被替换删除（以实际上传结果为准）
• 错误提示：压缩失败会记录最近一次失败原因，并在设置页提示（便于排查 Key/额度/网络）
• 卸载清理：从后台“删除插件”会自动清除本插件保存的设置项（不会删除媒体库图片）

使用前准备（TinyPNG API Key）

LeTinypng 需要 TinyPNG API Key 才能压缩图片。

• 申请地址：https://tinypng.com/developers
• 免费额度：通常 每月 500 张（以 TinyPNG 官方策略为准）

安装与启用

1. 将插件目录 letinypng 上传到 wp-content/plugins/
2. 进入 WordPress 后台 → 插件 → 启用 LeTinypng
3. 进入后台 → 设置 → LeTinypng
4. 填写 TinyPNG API Key 并保存
5. 勾选 开启压缩 并保存（不开启则不压缩）
6. （可选）勾选 转换为 WebP 并保存

设置说明

后台位置：设置 → LeTinypng

• 开启压缩

  • 开启后：新上传图片会通过 TinyPNG 压缩
  • 关闭后：按 WordPress 默认上传逻辑处理，不调用 TinyPNG

• TinyPNG API Key

  • 用于调用 TinyPNG API
  • 你可以点击“验证 API Key”检查可用性
  • 注意：验证 API Key 会发起一次 API 请求，通常会计入本月额度

• 转换为 WebP（可选）

  • 开启后：上传 JPEG/PNG → 压缩后再转 WebP，最终保存为 .webp
  • 每张图片会多消耗 1 次额度（压缩 1 次 + 转 WebP 1 次）

常见问题（FAQ）

1）不填 API Key 会怎样？

不会调用 TinyPNG，也不会压缩；上传按 WordPress 默认行为处理。

2）插件会批量压缩历史图片吗？

不会。该插件在上传完成后处理，仅对新上传图片生效。

3）为什么开启后没压缩？

请依次检查：

• 是否已勾选「开启压缩」并保存
• API Key 是否有效（可用“验证 API Key”）
• 本月额度是否用完（常见返回为 429）
• 服务器到 api.tinify.com 的网络是否正常（防火墙/主机限制）
• 上传文件是否为支持格式：JPEG/PNG/WebP

4）为什么“转换为 WebP”会额外消耗次数？

TinyPNG 的“压缩”和“转换”是两个 API 操作，通常会分别计费/计次数；因此启用 WebP 会比仅压缩多消耗一次。

5）删除插件后会怎样？

在后台「插件」页面点击“删除”时，会执行卸载清理，移除本插件保存的选项（如 API Key、开关、最近错误等）。不会删除媒体库图片文件。

运行环境

• WordPress：建议 5.0+
• PHP：7.4+

更新日志

1.1.0

• 新增：设置项「转换为 WebP」
• 新增：卸载清理（uninstall.php）
• 新增：插件列表“设置”快捷入口

1.0.0

• 首次发布：上传时自动压缩 JPEG/PNG/WebP，设置页配置 API Key