EWWW Image Optimizer插件的Override选项

EWWW Image Optimizer 插件（简称 EWWW IO）提供了多种方式来覆盖其默认行为。除了通过插件界面进行配置外，您还可以通过在 WordPress 的 wp-config.php 文件中定义常量（constant）来覆盖任意设置——即使某些选项已从设置界面中移除（通常是因为使用率较低），依然可以通过此方法启用或调整。

一、如何使用覆盖选项

要覆盖 EWWW IO 的任何设置，请在 WordPress 根目录下的 wp-config.php 文件中添加如下格式的代码：

define( 'EWWW_IMAGE_OPTIMIZER_DELAY', 5 );

• 常量名称需全部大写，并以 EWWW_IMAGE_OPTIMIZER_ 开头。
• 此文件通常位于 public_html/ 或网站根目录下，包含数据库连接等全局配置。
• 重要提示：
  • 所有自定义常量必须添加在 /* That's all, stop editing! Happy publishing. */ 这一行之前，否则无效。
  • 对于布尔值（true / false）和数字（如 5、0），不要加引号。例如，错误写法：define('EWWW_IMAGE_OPTIMIZER_NOAUTO', 'true'); ——这会变成字符串而非布尔值。

二、隐藏设置（不在插件界面中显示）

以下设置无法在插件后台直接配置，但可通过 wp-config.php 启用：

• 关闭自动优化
  设置 EWWW_IMAGE_OPTIMIZER_NOAUTO 为 true，可禁用上传时的自动压缩，但仍支持手动或计划优化。
• 启用图像编辑器集成
  默认情况下，WordPress 内置裁剪、旋转等操作生成的新图不会被自动优化。将 EWWW_IMAGE_OPTIMIZER_ENABLE_EDITOR 设为 true 可开启此功能（仅影响动态生成图像，不影响普通上传）。
• 禁用自动旋转
  图像若包含 EXIF 方向信息，插件会自动旋转以正确显示。设 EWWW_IMAGE_OPTIMIZER_DISABLE_AUTOROTATE 为 true 可关闭此行为。
• 禁用 PNG 自动转 JPG
  插件会检测大体积 PNG 是否更适合保存为 JPG。如需保留所有 PNG，设 EWWW_IMAGE_OPTIMIZER_DISABLE_AUTOCONVERT 为 true。
• 延迟 S3 上传
  与 WP Offload S3 插件配合时，设 EWWW_IMAGE_OPTIMIZER_DEFER_S3 为 true 可确保图像先本地优化再上传至 S3（可能造成短暂“图片缺失”，慎用）。
• 调整 OptiPNG 压缩强度
  EWWW_IMAGE_OPTIMIZER_OPTIPNG_LEVEL 可设为 1–4：
  • 1：1 次尝试（最快）
  • 2：8 次（默认）
  • 3：16 次
  • 4：24 次（最慢但压缩率最高）
• 调整 PNGOUT 压缩级别
  EWWW_IMAGE_OPTIMIZER_PNGOUT_LEVEL 使用反向尺度（3 最弱，0 最强）。建议至少使用 2 级。注意：PNGOUT 需单独安装，不能随插件分发。
• 启用 PNGOUT 工具
  默认不启用 PNGOUT。设 EWWW_IMAGE_OPTIMIZER_DISABLE_PNGOUT 为 false 即可激活（需先安装该工具）。
• 跳过小图像优化
  EWWW_IMAGE_OPTIMIZER_SKIP_SIZE 设定字节数阈值，小于该值的图像不优化；设为 0 则禁用。
• 跳过大 PNG 优化
  EWWW_IMAGE_OPTIMIZER_SKIP_PNG_SIZE 设定上限，大于该值的 PNG 不优化；设为 0 则禁用。
• 排除原始图使用有损压缩
  设 EWWW_IMAGE_OPTIMIZER_LOSSY_SKIP_FULL 为 true，可确保原始全尺寸图仅使用无损压缩，并禁止 PNG 转 JPG。
• 保留原始图元数据
  EWWW_IMAGE_OPTIMIZER_METADATA_SKIP_FULL 设为 true 后，原始图的 EXIF、GPS 等信息不会被清除。
• 使用系统级优化工具
  插件自带 jpegtran、optipng 等工具。若已在服务器安装这些工具，可设 EWWW_IMAGE_OPTIMIZER_SKIP_BUNDLE 为 true 改用系统版本（官方不推荐）。
• 绕过 open_basedir 限制
  在受 PHP open_basedir 限制的环境中，可通过 EWWWIO_OPEN_BASEDIR 指定允许调用二进制文件的路径（如 /usr/bin/:/opt/bin/）。设为空字符串可跳过文件检查。
• 启用白标模式
  EWWWIO_WHITELABEL 设为 true 后，插件将隐藏所有外部链接、支持入口和营销内容，适合代理或客户托管场景。
• 强制 PNG 转 WebP 使用有损压缩
  默认 PNG 转 WebP 为无损。设 EWWW_IMAGE_OPTIMIZER_LOSSY_PNG2WEBP 为 true 可强制使用有损模式（需已启用 Premium 功能）。
• 启用更锐利的 WebP 转换
  EIO_WEBP_SHARP_YUV 设为 true 后，WebP 生成将使用更精确的 RGB→YUV 算法，提升文字和边缘清晰度，但速度更慢、文件略大。

三、可视设置（可在界面中配置，也可通过 wp-config.php 覆盖）

以下选项虽在插件界面中可见，但也可通过常量强制设定，适用于多站点统一配置或开发/生产环境区分。

• 控制元数据清除
  EWWW_IMAGE_OPTIMIZER_METADATA_REMOVE 设为 true 删除元数据，false 则保留。
• JPEG 压缩等级
  EWWW_IMAGE_OPTIMIZER_JPG_LEVEL 可选：
  • 0：无压缩
  • 10：Pixel Perfect（无损）
  • 20：Pixel Perfect Plus（API 无损）
  • 30：Premium（有损）
  • 40：Premium Plus（极致有损）
• PNG 压缩等级
  EWWW_IMAGE_OPTIMIZER_PNG_LEVEL 可选：
  • 0：无压缩
  • 10：无损
  • 20：API 无损
  • 40：有损
  • 50：极致有损
    （注：30 级已废弃）
• GIF 压缩等级
  EWWW_IMAGE_OPTIMIZER_GIF_LEVEL：0（无压缩）或 10（无损，使用 Gifsicle）。
• PDF 压缩等级
  EWWW_IMAGE_OPTIMIZER_PDF_LEVEL：
  • 0：无压缩
  • 10：无损
  • 20：高质量降采样（非 Premium，含文字图像可能失真）
• 启用压缩备份
  EWWW_IMAGE_OPTIMIZER_BACKUP_FILES 设为 true，通过 API 优化的图像将保留 30 天备份。
• 启用 Easy IO CDN
  EWWW_IMAGE_OPTIMIZER_EXACTDN 设为 true 可激活付费图像 CDN 服务（ExactDN）。
• 启用懒加载
  EWWW_IMAGE_OPTIMIZER_LAZY_LOAD 设为 true 后，视窗外图像将延迟加载。
• 自定义 JPEG 质量
  EWWW_IMAGE_OPTIMIZER_JPG_QUALITY 覆盖 WordPress 默认质量（默认 82），影响缩略图、PNG 转 JPG 及 WebP 输出。建议值 70–90。
• 自定义 WebP 质量
  EWWW_IMAGE_OPTIMIZER_WEBP_QUALITY 覆盖默认 WebP 质量（75），可配合 EIO_WEBP_SHARP_YUV 优化文字图像。
• 启用并行优化
  EWWW_IMAGE_OPTIMIZER_PARALLEL_OPTIMIZATION 设为 true 后，新图的各尺寸缩略图将在后台并行压缩（需后台优化支持）。
• 控制计划优化
  EWWW_IMAGE_OPTIMIZER_AUTO 控制“计划优化”是否运行，适合在开发站设为 false。
• 暂停压缩但保留扫描
  EWWW_IMAGE_OPTIMIZER_PAUSE_IMAGE_QUEUE 设为 true 后，图像会被排队但不压缩（仅适用于 v7.4+ 异步优化）。
• 扩展媒体路径扫描
  EWWW_IMAGE_OPTIMIZER_INCLUDE_MEDIA_PATHS 启用后，批量优化会额外扫描上传目录最近两个月内的图像。
• 优化 WordPress 5.3+ 原始大图
  默认不优化超过 2560px 时生成的未缩放原图。设 EWWW_IMAGE_OPTIMIZER_INCLUDE_ORIGINALS 为 true 可纳入优化。
• 添加自定义扫描目录
  EWWW_IMAGE_OPTIMIZER_AUX_PATHS 可指定额外文件夹（支持字符串或数组），供批量/计划优化扫描。
• 排除特定路径
  EWWW_IMAGE_OPTIMIZER_EXCLUDE_PATHS 可排除文件或目录（支持部分路径匹配，无需通配符）。
• 高亮过大图像
  EWWW_IMAGE_OPTIMIZER_RESIZE_DETECTION 启用后，超限图像将显示黑/蓝虚线边框。
• 设定最大上传尺寸
  EWWW_IMAGE_OPTIMIZER_MAXMEDIAWIDTH 和 EWWW_IMAGE_OPTIMIZER_MAXMEDIAHEIGHT 分别限制图像最大宽高（像素），超限则自动缩放。
• 允许重设已有图像尺寸
  • EWWW_IMAGE_OPTIMIZER_RESIZE_EXISTING：针对媒体库图像
  • EWWW_IMAGE_OPTIMIZER_RESIZE_OTHER_EXISTING：针对非媒体库图像（如主题目录）
• 禁用特定尺寸生成或优化
  • EWWW_IMAGE_OPTIMIZER_DISABLE_RESIZES：阻止 WordPress 生成某尺寸（如 medium_large）
  • EWWW_IMAGE_OPTIMIZER_DISABLE_RESIZES_OPT：允许生成但跳过优化
    两者均需以关联数组形式定义，例如：array( 'thumbnail' => 1 )
• 隐藏格式转换链接
  EWWW_IMAGE_OPTIMIZER_DISABLE_CONVERT_LINKS 设为 true 后，媒体库列表页不再显示“PNG 转 JPG”等操作链接。
• 删除原始文件（格式转换时）
  EWWW_IMAGE_OPTIMIZER_DELETE_ORIGINALS 设为 true 后，PNG 转 JPG 等操作会删除原文件（节省空间，但可能断链）。
• JPG 转 PNG（不推荐）
  EWWW_IMAGE_OPTIMIZER_JPG_TO_PNG 会尝试将 JPG 转为 PNG，但通常得不偿失，仅建议选择性使用。
• PNG 转 JPG（推荐）
  EWWW_IMAGE_OPTIMIZER_PNG_TO_JPG 可全局启用，自动将适合的 PNG 转为更小的 JPG。
• 指定透明 PNG 转 JPG 的背景色
  EWWW_IMAGE_OPTIMIZER_JPG_BACKGROUND 接受十六进制颜色值（如 #abc123 或 abc123），用于填充透明区域。
• GIF 转 PNG
  EWWW_IMAGE_OPTIMIZER_GIF_TO_PNG 可自动将非动画 GIF 转为 PNG（通常体积更小）。
• 启用 WebP 生成
  EWWW_IMAGE_OPTIMIZER_WEBP 设为 true 后，插件会为每个 JPG/PNG 生成更小的 WebP 版本（需配合重写规则或 JS 服务）。
• 为 CDN 启用 JS WebP 重写
  EWWW_IMAGE_OPTIMIZER_WEBP_FOR_CDN 适用于使用 CDN 或反向代理的场景。
• 指定 WebP 重写域名
  EWWW_IMAGE_OPTIMIZER_WEBP_PATHS 可列出应被 JS WebP 重写的域名或路径（支持数组）。
• 强制生成 WebP
  EWWW_IMAGE_OPTIMIZER_WEBP_FORCE 设为 true 后，无论文件大小，所有 JPG/PNG 都会生成 WebP（适用于 CDN 托管场景）。
• 显示帮助链接
  EWWW_IMAGE_OPTIMIZER_ENABLE_HELP 控制是否在后台显示插件帮助和联系表单。
• 启用匿名统计
  EWWW_IMAGE_OPTIMIZER_ALLOW_TRACKING 设为 true 可发送匿名使用数据，帮助改进插件。

四、总结

通过在 wp-config.php 中定义上述常量，可以完全掌控 EWWW Image Optimizer 的行为，无论是微调压缩参数、禁用特定功能，还是为多站点环境统一配置。这种方法特别适合开发者、运维人员或需要精细化控制图像优化流程的高级用户。

 修改 wp-config.php 前请务必备份！错误的语法可能导致网站无法访问。