适用于 WordPress 的图片压缩

1. 插件功能与处理方式

ANK Image Compress 可处理原始 JPEG、PNG、WebP 文件，以及您选定的 WordPress 图片尺寸。替换文件前，插件会检查 API 响应、格式、尺寸及文件是否真正变小。压缩后的文件保留原有文件名和 URL；原始字节会备份到网站公开目录之外的私有文件夹。

您可以自动处理新上传图片、单张图片、所选图片或整个媒体库；按标题或文件名搜索、每页查看 50 项、查看节省的空间，并恢复原图。

2. 安装与 API 密钥

1. 在 WordPress 的“插件 → 安装插件 → 上传插件”中上传 ANK Image Compress 的 ZIP 包，然后启用。
2. 在 ankpicpress.com 注册，并在个人账户中获取 API 密钥。该站与 ank-tinypng.ru 共用账户和余额，但两个域名需要分别登录。
3. 在 WordPress 中打开“设置 → ANK Compress”，输入密钥并保存设置。
4. 在连接信息区域查看 API 状态和余额。保存后的密钥不会再次显示。

在 WordPress 多站点网络中，可以在 wp-config.php 定义 ANKIC_API_KEY，让各站点共用一个密钥。请保护该文件。定义常量后，管理员界面的密钥输入框不可编辑。

3. 自动处理新图片

在“设置 → ANK Compress”中启用通过 WP-Cron 处理新上传图片的选项，并保存设置。图片上传后，WordPress 会稍后将其加入处理队列。无需保持后台页面开启，但 WP-Cron 必须由网站访问或系统定时任务实际触发。

验证时，上传一张较小的静态 JPEG、PNG 或 WebP。cron 执行后，在插件列表中查找该图片。“已完成”表示符合条件的文件已处理；计数显示已处理数和可处理总数。如未启动，请检查 WP-Cron、密钥和余额。

4. 手动与批量压缩

处理单张图片时，可在插件表格或 WordPress 媒体库列表视图中点击“压缩”。也可在媒体库中选中多张图片并使用批量操作。“处理本页所有图片”只处理当前页面最多 50 项。

处理整个媒体库时，启动批量优化。WP-Cron 每次计划任务处理一个文件，并将进度保存在服务器上；可以暂停和继续。完成数与错误数属于当前批次。再次启动时，已处理的版本会跳过，除非您明确要求重新压缩。

5. 图片尺寸、WebP 与 AVIF

选择要发送至 API 的 WordPress 缩略图尺寸。原始图片始终参与处理。选择的尺寸越多，可能产生的 API 请求越多。可为新上传的大型 JPEG 和 WebP 设置最大宽度与高度；填 0 则使用 WordPress 默认行为。此设置不会缩小上传的 PNG。

输出格式设置可让 WordPress 将新生成的尺寸保存为 WebP 或 AVIF，不会改变已有图片或原始文件。WebP 尺寸随后可通过 ANK API 压缩。AVIF 尺寸由 WordPress 在服务器本地生成，不会发送至 ANK API。服务器的图片编辑器必须支持所选格式。

6. 搜索、统计与恢复

可按标题或文件名搜索，每页显示 50 项。表格展示已处理文件数、节省的空间和状态；统计区域汇总已优化图片、文件及节省的字节数。

“恢复原图”会从私有备份中还原原始字节；“重新压缩”会启动新一轮处理。大量重新压缩前请查看余额，因为新的有效结果可能消耗额度。WordPress 需要对安装目录的上级目录有写入权限，以便在公开网站之外保存备份。

7. 额度与当前限制

当前 ANK API 接受不超过 5 MB、2000 万像素的静态 JPEG、PNG 和 WebP。如果 API 返回的文件没有变小，原文件不会被替换，也不会消耗额度。相同请求的重试受到防重复扣费保护。余额显示在连接信息区域。

8. 故障排查与支持

• API 无法访问或密钥无效：在“设置 → ANK Compress”检查连接状态，必要时保存新密钥并刷新页面。
• 自动处理未启动：确认设置已启用，并检查 WP-Cron 是否真正运行。上传一张小型 JPEG 并查看状态。
• 图片被跳过：检查 MIME 类型、5 MB／2000 万像素限制以及是否含动画。AVIF 需要服务器编辑器支持，且不会由 API 压缩。
• 无法写入备份：授予 WordPress 对安装目录上级目录的写权限。备份成功前，插件不会替换文件。
• 浏览器仍显示旧图：清理页面或 CDN 缓存。插件会为 WordPress 标准输出中的图片 URL 添加版本标记。

若问题持续，请发邮件至 modules@ankpicpress.com，说明插件版本、文件类型与大小、错误信息及复现步骤。请勿发送 API 密钥或含有私密信息的原图。