YS WebP Tools
上傳自動轉 WebP、智慧縮圖治理,讓網站圖片又小又快。
圖片通常佔了網頁重量的一半以上。YS WebP Tools 把圖片優化變成「裝了就好」的事:新上傳的圖片自動轉成 WebP、自動依你設定的最大寬高縮圖,舊圖片也有批次工具可以一次整理,網站速度與磁碟空間立刻有感。
上傳即優化,不改變工作流程
啟用後照常上傳圖片即可——外掛會在媒體庫背景完成 WebP 轉換與縮圖,可以選擇取代原檔或保留原檔並存。編輯內容時完全不需要改變任何習慣。
縮圖尺寸治理,砍掉看不見的浪費
WordPress 與主題、外掛會註冊一大堆縮圖尺寸,每張上傳的圖都被複製好幾份。「縮圖尺寸管理」把所有註冊中的尺寸攤開,逐項或一鍵停用不需要的尺寸,從源頭省下磁碟空間。
既有圖片也能一次整理
「既有圖片工具」提供兩種批次重生模式:清理停用尺寸(只刪停用尺寸的舊縮圖,最安全、不影響既有網址)與完整重建;另有「內容圖片網址修復」掃描文章中指向已不存在檔案的圖片網址並替換成有效網址,預設先 dry-run 預覽再執行。所有具破壞性的功能預設關閉。
功能特色
上傳自動轉 WebP
新上傳圖片自動轉換為 WebP,可取代原檔或保留並存。
自動依最大寬高縮圖
超過設定尺寸的大圖自動縮小,避免 6000px 原圖直接進媒體庫。
縮圖尺寸管理
攤開所有註冊中的縮圖尺寸,逐項或一鍵停用多餘尺寸。
批次重生(兩種模式)
「清理停用尺寸」安全不動網址;「完整重建」依設定重建全部縮圖。
內容圖片網址修復
掃描文章內失效圖片網址並替換成有效網址,先預覽再執行。
安全預設
具破壞性的功能預設關閉,執行前提示備份,分批處理不逾時。
螢幕截圖
更新日誌(最新版)
新增
- filter `ys_webp_tools_convert_upload`:參數 `( bool $convert, array $file )`,回傳 `false` 就保留原檔、不轉 WebP;只在設定本來就會轉時呼叫,不影響自動縮圖。所有上傳入口都會經過:媒體庫視窗、媒體新增頁、區塊編輯器(REST)、`media_handle_sideload()`/`media_sideload_image()`、WP-CLI 匯入,以及 WordPress 7.1 瀏覽器端處理時補傳的縮圖(預設跟著主檔格式,同一個附件不會一半 WebP 一半原格式)。主檔沒有轉成 WebP 時,例如 PDF 的預覽圖、沒勾轉換的 GIF 封面,補傳的縮圖也維持原格式,和伺服器產生縮圖時一致(1.2.3 會把它們轉成 WebP)。README 附「通知信用的 Logo 維持原圖」範例。
變更
- 一般設定改顯示目前狀態:拿掉寫死的「安全提醒:WebP 轉換與自動縮圖預設為關閉」,改成照已儲存的設定顯示「上傳時轉 WebP」(已開啟與品質,或未開啟)與「自動縮小」(已開啟與寬高上限,或未開啟);總開關關閉、沒勾格式、沒設上限、主機的圖片處理元件不能輸出 WebP,或其他外掛會把 WebP 轉成別的格式時,標成未生效並寫出原因。每項附連結到對應頁籤,儲存後立即更新。
- 外掛只刪 uploads 資料夾底下的檔:轉檔與「既有圖片工具」的批次重生縮圖刪檔前,都先確認檔案在 uploads 資料夾裡,不在就不刪。
修正
- 主機不能輸出 WebP 時,上傳的原圖會被刪掉(1.0.0 起就有):主機的圖片編輯器不支援 WebP 時(例如 Imagick 沒有 WebP、GD 沒編 WebP),核心會改存成 JPEG,舊版把這個檔當成轉檔失敗的檔刪掉,結果刪到上傳的原圖;上傳的是 PNG 時,還會覆寫並刪掉同名的 JPG,那可能是別的附件的主檔。現在取編輯器時要求能輸出 WebP(Imagick 不支援但 GD 支援時改用 GD),都不支援就不轉,原圖保留;存檔後只清掉自己指定、存檔前不存在的那個 WebP 檔。
- 別的外掛把 WebP 改成別的格式時,不再覆寫原圖或別的圖片的同名檔:其他外掛(或自訂程式)用 `image_editor_output_format` 把 WebP 對應成別的格式時,WordPress 產生縮圖時會把轉好的 WebP 再轉一次、存成同名檔,不檢查同名,結果覆寫使用者上傳的原圖,或別的圖片的同名主檔與縮圖。現在這種情況不轉,原圖照留,設定頁「目前狀態」顯示「未生效(其他外掛會把 WebP 轉成別的格式)」。
- 「WebP 品質」設定現在才真的生效(1.0.0 起一律用 WordPress 的品質設定,預設 86):WordPress 轉存格式時,會把外掛設的品質換成 WordPress 的品質設定。現在外掛轉出的 WebP(上傳的那張圖,以及 WordPress 7.1 瀏覽器端處理補傳的縮圖與 `-scaled` 大圖)照設定的品質存,品質維持預設 82 的站,升級後這些檔會比以前小一點。由伺服器處理時,WordPress 自己從主檔產生的縮圖,以及超過 2560 px 時網站實際用的 `-scaled` 大圖,仍用 WordPress 的品質設定(預設 86,其他外掛可能改過)。
- WordPress 7.1 補傳的 source_original 不再轉檔:核心刻意保留在附件旁的原始格式檔(例如 HEIC 旁邊的原檔)照原格式留著,不轉 WebP、也不刪。
- WordPress 7.1 瀏覽器端處理時「停用縮圖尺寸」不生效:區塊編輯器改由瀏覽器做縮圖時,伺服器用 `wp_get_missing_image_subsizes()` 告訴瀏覽器要做哪些尺寸,這份清單之前沒有拿掉停用的尺寸(例如 medium_large 照樣產生)。現在一併拿掉;上傳中斷後補做縮圖時也不會補出停用的尺寸。
- WordPress 7.1 瀏覽器端處理+「保留原始檔」會留下孤兒檔:瀏覽器做好、補傳到附件的縮圖與 scaled 轉成 WebP 後,原格式那一份(例如 photo-150x150.jpg)也被留下;附件只記 WebP,這些檔沒有人引用,刪附件也不會刪。現在轉好就刪掉。「保留原始檔」的意思不變:保留的是使用者上傳的那張原圖(附件主檔的原檔),WordPress 或瀏覽器從它做出來的縮圖只留 WebP,和伺服器產生縮圖時一樣。1.2.3 已經留下的原格式孤兒縮圖,1.2.4 不會自動清除。
常見問題
會影響既有圖片網址嗎?
「清理停用尺寸」模式只刪除停用尺寸的縮圖檔,啟用中的尺寸與主檔完全不動,既有網址不受影響;「完整重建」才會重建全部縮圖,建議先備份再執行。
需要什麼環境?
WordPress 6.0 以上、PHP 8.0 以上,主機需有 GD 或 Imagick 影像庫(絕大多數主機皆內建)。
轉成 WebP 後原始檔還在嗎?
由你決定:可設定「取代原檔」節省最多空間,或「保留原檔」並存以便日後需要。
為什麼建議停用多餘縮圖尺寸?
每個註冊中的尺寸都會讓每張上傳圖片多複製一份。一般網站實際用到的尺寸通常只有三到四種,停用其餘尺寸可以省下可觀的磁碟空間。
