新上傳
媒體庫上傳 (含 REST/XML-RPC 程序化上傳) 在生成附件元數據的同時進桶:主文件、原圖、各尺寸一個不落。第三方直接放進 uploads 目錄的文件不會自動進桶——用鏡像回源,或讓開發者調用 wpsss_file_upload() 。
存量補傳隊列
工具 → 日常 → 開始補傳。頂部有進度條:百分比按首輪 「已處理 + 剩餘」 為基線即時推進,文字行同步顯示本輪成功 / 失敗 / 剩餘。
- 一次一個附件:每個請求只上傳一個附件,不會因網關超時中斷整批。
- 可暫停:點 「暫停」 立即停;網絡中斷自動暫停,再點繼續。
- 關頁繼續:關掉頁面後,後台任務每分鐘最多補 2 個附件直到清完 (需要站點 cron 正常工作),隊列清空後自動停止。
- 斷點續傳:按附件編號從新到舊處理,中斷後從上次位置繼續。點 「從最新開始」 可清掉續傳位置重新掃 (已進桶的自動跳過) 。
失敗退避
同一個附件連續失敗 3 次後,自動退出補傳隊列 (避免一個壞文件卡住整隊) 。隊列清空後如果只剩失敗項,工具頁會明確提示剩多少個、到哪裏查原因:到 「工具 → 排障 → 體檢」,修好後點 「重試失敗項」,或命令行:
wp sss offload --source=failed
縮略圖與主文件標記
設置裏可以關掉 「同時上傳縮略圖」 。此時插件給附件打上 「主文件」 標記:主文件地址照常指向桶,各尺寸地址保持本地——前台不會因為尺寸文件不在桶裏而裂圖。 PDF 附件同理:PDF 本體進桶,預覽縮略圖留在本地。 0 字節的損壞文件也能如實上傳 (對象按 0 字節保存) 。
keep_local:本地備份
默認開啓 (推薦):桶與本地各一份,源站掛了也能從本地恢復。關閉後本地文件在上傳成功後刪除——此時插件會接管 get_attached_file(編輯圖片等場景退回桶地址),上傳重名文件也會先查桶避免覆蓋。關閉本地備份需要管理員在高級設置操作。
媒體庫裏也能直接操作
- 狀態列 「對象存儲」:每個附件標出已進桶 / 未進桶 / 失敗 (附原因),列表頁還有 「全部 / 已進桶 / 未進桶 / 失敗」 篩選。
- 行內動作:未進桶的附件在列表行內點 「補傳到桶」;已進桶的可 「拉回本地」 。
- 批量操作:列表勾選後批量 「補傳到桶」 或 「拉回本地」 。
- 附件編輯頁側欄:顯示對象鍵與對外地址,可直接打開,也可單附件補傳 / 拉回。
高級設置裏的上傳開關
- 遠端已有則跳過:桶裏已有同名對象時不再重複上傳 (默認關;適合重建桶後避免覆蓋) 。
- 自動重命名:同名衝突時的處理——關閉 (默認,按原名加 -1 、-2 遞增)/ md5 / 時間戳。
- 不進桶的擴展名:填了就不上傳的擴展名清單;
php、htaccess無論如何都不進桶。
