點擊LOGO返回首頁-尼爾網站設計工坊

支援 Google Drive 自動下載，一鍵建立大量相簿

尼爾網站設計工坊於 2026 年 4 月完成「桃園市防災教育輔導團」委託之相簿模組批次管理功能模組開發案，針對客戶面臨大量相片需建立相簿，但操作 FTP 上傳不便的問題，提出以 Google Drive 作為中轉平台的解決方案。
使用者只需將相片資料夾批次上傳至 Google Drive，並透過 Service Account 進行一次性授權設定，即可由系統自動將雲端資料夾下載至網站並建立為相簿，完成「資料夾上傳 → 自動建立相簿」的全自動流程。
本功能大幅簡化傳統相簿建立流程，無須使用 FTP、無須逐一建立相簿，亦無需頻繁進出後台操作，特別適合需要大量相片管理之學校、機關與活動單位使用。

系統特色：自動化、穩定性與操作便利性兼具

本系統提供 Google Drive 相簿自動匯入與批次建立功能，可將雲端資料夾中的圖片自動下載並建立為網站相簿。支援「自動執行」與「手動觸發」兩種模式，並採用非同步背景處理機制執行，有效避免影響網站前端操作效能。
同時搭配「下載管理」與「分類失敗處理」機制，可即時掌握下載進度與相簿建立狀態，當發生分類錯誤或資料異常時，亦可透過後台進行手動補正，確保整體流程穩定且可控。
整體設計以「大量資料處理」與「自動化管理」為核心，能有效降低人工操作成本，並提升相簿建立效率。

功能重點說明

一、圖文操作教學（快速上手）

提供完整圖文說明，逐步引導使用者完成設定與操作流程，即使沒有技術背景亦可快速上手。

二、下載設定（核心控制）

可設定以下參數：

• Google Drive 資料夾 ID（folderId）
• 自動下載功能開關
• 執行失敗重試次數
• 單次批次匯入最大數量
• 相簿建立顯示發佈者

啟用自動下載後，可設定執行間隔時間，避免重複觸發造成系統負擔。系統採用非同步（fsockopen）背景處理，即使處理大量相簿資料，也不會影響使用者前台操作體驗。
此外，透過單次處理數量限制，可避免因大量圖片處理導致伺服器資源（如 Imagick）負載過高，確保系統穩定運行。

三、批次下載（手動觸發）

可於後台點選「批次下載」，一次將 Google Drive 中所有資料夾下載並建立為相簿，適用於臨時或立即處理需求。

四、下載管理（狀態掌控）

提供完整 LOG 管理介面，可查詢：

• 下載中 / 待建立 / 建立中 / 完成 / 失敗
• 失敗原因（下載不完整、分類錯誤、建立失敗等）

並支援資料篩選與批次刪除，方便管理大量處理紀錄。

五、分類失敗處理（補償機制）

若資料夾未設定分類 ID 或分類錯誤，系統將自動歸類至「分類失敗」，可透過後台手動指定分類並完成修正。

六、系統資訊與開發說明

• 系統平台：XOOPS CMS（延續既有網站架構，無需重建系統）
• 前端技術：jQuery、JavaScript、CSS3、AJAX
• 後端環境：PHP 8.3、MySQL / MariaDB
• 非同步機制：fsockopen 背景觸發（避免阻塞前端操作）
• 套件架構：相容既有 XOOPS 模組系統，採低侵入式整合設計
• 開發工時：10天（不含例假日）
• 項目特色：
  • 建立「Google Drive → 網站相簿」全自動化處理流程
  • 採非同步背景執行機制，大量資料處理仍維持前端流暢
  • 具備批次下載、分批建立與失敗重試機制，提升系統穩定性
  • 提供完整 LOG 管理與狀態追蹤，具備良好可觀測性
  • 支援分類失敗補償機制，可於後台快速修正資料
  • 採用低耦合設計，可直接整合於既有網站環境，無需重構

七、使用注意事項

• 資料夾名稱需包含分類 ID，並採「相簿名稱_分類ID」格式命名
• 僅支援常見圖片格式（jpg、png），其他格式將自動略過
• 未設定或錯誤分類將歸類至「分類失敗」
• 大量資料處理時可能有延遲，屬正常現象
• 建議單一資料夾圖片數量控制於 300 張以內
• 系統執行期間請避免修改 Google Drive 資料夾內容
• 已完成資料夾會標註「_Finish」，建議定期清理

八、部署成果

本功能已正式部署於【桃園市防災教育輔導團】 網站，並通過實際壓力測試與驗收，各項功能運作穩定，已投入正式使用。