內容簡介
總結：此 WordPress 外掛可將 JPEG/PNG 圖片轉換為 WebP 格式並將 WebP 設為原始文件，並保留原始檔案的安全備份。
問題與答案：
問題：這個外掛如何進行圖片轉換？
答案：外掛會為每個 JPG/PNG 附件生成 WebP 格式的完整圖片和所有由 WordPress 生成的尺寸。轉換是透過 WordPress 的圖片編輯系統（WP_Image_Editor）進行，使用支援 WebP 的 GD 或 Imagick（取決於伺服器支援）。
問題：原始 JPG/PNG 檔案會怎麼處理？
答案：原始 JPG/PNG 檔案會被移至 wp-content/uploads/_originals/...，並且資料夾結構會和上傳結構保持一致。
問題：如何更新 WordPress 以提供 WebP？
答案：附件的「檔案」和元數據會被更新，使得 WordPress 以 .webp 作為附件檔案。同時，附件的 mime 類型也會被更新為 image/webp。
問題：此外掛是否能替換舊的圖片 URL？
答案：若啟用，外掛能在帖子內容和元數據中替換舊的 .jpg/.png URL。替換是序列化安全的，不會破壞序列化數組。
問題：如何使用此外掛？
答案：前往媒體 → WebP Only。設定包括圖片轉換品質、批次處理數量、替換舊的 .jpg/.png URL 選項等。
外掛標籤
開發者團隊
② 後台搜尋「OrigiSafe — Advanced Image Optimizer (WebP) — Keep Originals Safe」→ 直接安裝（推薦）
原文外掛簡介
Keep Originals Safe, convert JPEG/PNG images to WebP and makes WebP the canonical file. WP returns .webp URLs, Keeping originals safely archived.
How it works (high level)
Convert
For a JPG/PNG attachment, the plugin generates a WebP for the full image and all WordPress-generated sizes.
Conversion is done through WordPress’ image editor system (WP_Image_Editor), meaning it uses GD or Imagick (whichever your server supports) with WebP support enabled.
Move originals
The original JPG/PNG files are moved to:
wp-content/uploads/_originals/...
The folder structure mirrors your uploads structure.
Update WordPress to serve WebP
Attachment “file” + metadata are updated so WordPress serves .webp as the attachment file.
Attachment mime type is updated to image/webp.
Optional: Replace old URLs everywhere
If enabled, the plugin can replace old .jpg/.png URLs across:
post content
postmeta
Replacement is serialized-safe (does not break serialized arrays).
Background jobs (keeps running after page reload)
Conversion/repair/sweep jobs are designed to run in the background. They keep ticking even if you refresh the page or close the tab.
The plugin uses multiple loopback methods (admin-post / REST / public tick fallback) so it can keep working even on restrictive hosting setups.
Log + “it looks frozen” note
A rolling “terminal style” log is written to:
– wp-content/uploads/hsbc-webp-only/logs/webp-only.log
If the log appears to freeze in the admin page:
– click Refresh Log, or
– refresh the page
The job may still be running server-side; refreshing the log/page usually catches up.
Usage
Go to Media → WebP Only.
Settings
Quality
WebP quality for conversion (0–100).
Batch size
How many items to process per tick. Smaller batches reduce server load.
Replace old .jpg/.png URLs across content + postmeta (serialized-safe)
Recommended if your site content contains hard-coded image URLs.
Sweep Include / Exclude
Used by the Sweep tools to control which folders are scanned.
Conversion Jobs (buttons)
Start Bulk Convert
– Converts Media Library attachments (JPG/PNG) in batches.
– Moves originals to uploads/_originals/.
– Updates attachment metadata so WordPress serves .webp.
– Optional URL replacement (content + postmeta).
Start Repair/Cleanup
– Repairs inconsistencies if something was partially converted or moved.
– Useful after restores/migrations or if some attachments have mismatched metadata.
– Optional URL replacement.
Start Folder Sweep
– Scans the filesystem for eligible images (based on your Sweep Include/Exclude rules).
– Designed for sites with additional image folders beyond standard uploads.
– Optional URL replacement.
Stop Job
– Stops the currently running job.
Maintenance / Cleanup (buttons)
Delete duplicate _originals
– Deletes backup files in uploads/_originals/ *only when* an identical file already exists in uploads/.
– This is a cleanup tool for situations where originals were restored back into uploads and you no longer need the archived duplicate.
Delete duplicate _webp
– Removes orphaned WebP cache files in:
– uploads/_webp/
– Only deletes WebP files that no longer match anything in uploads/ or uploads/_originals/.
Delete duplicate sweep _originals
– Maintenance cleanup for non-uploads roots (folders under wp-content/) that contain their own _originals/ folders.
– It uses your Sweep Include list to find those roots.
– Only deletes a file from
Revert Everything
– Restores original JPG/PNG files from uploads/_originals/ back into uploads/.
– Reverts attachment metadata so WordPress serves the originals again.
Log controls
Refresh Log
– Pulls the latest log tail into the admin screen.
Reset Log
– Clears the log file.
Requirements
WordPress’ image editor must support WebP.
GD with WebP support, or
Imagick with WebP support
If WebP conversion is not supported on your server, conversion/repair/sweep will refuse to run (revert tools can still work).
