帶有主題應用程式和 CSS 的品牌 ownCloud Classic 10

對於 ownCloud Server Classic 10,請將您的品牌識別建置為主題應用,並將其放置在自訂應用程式目錄中,這樣升級時就不太可能將其覆蓋。使用該主題來替換徽標並定義 CSS 顏色;沒有通用的內建顏色選擇器可以將任何品牌顏色應用到整個 Web 介面。以下步驟適用於 Classic Server Web UI,不適用於 ownCloud Infinite Scale。

首先,將三種品牌推廣路徑分開。

已驗證: ownCloud Classic 10 支援將主題作為應用程式使用。主題可以覆蓋 CSS、圖像、模板和翻譯。官方開發者手冊也指出,舊theme設定config.php在 Classic 10 中已被棄用。操作:在變更檔案之前,請確認您的產品和版本:此步驟適用於 ownCloud Server Classic 10。

取決於您的版本: ownCloud 的 ownBrander 服務是企業客戶的圖形化品牌客製化選項。它可以創建網站主題和品牌化客戶端;存取權限取決於企業版訂閱和帳戶資格。操作:如果您擁有企業版存取權限,請諮詢您的 ownCloud 管理員或帳戶聯絡人,確認 ownBrander 是否已啟用。否則,請使用主題應用並在測試實例上進行驗證。

常見誤解: Infinite Scale (oCIS) 使用不同的 Web 自訂模型,包括自己的設定檔和主題檔。 oCIS 的說明theme.json不適用於 Classic Server 主題。操作:請勿將 oCIS 指南中的檔案或設定複製到 Classic Server 安裝中。

另一個常見的誤解是,在設定介面更改徽標會自動更改所有徽標、顏色和用戶端。經典伺服器開發人員手冊描述了基於檔案系統的主題覆蓋;功能可用性和客戶端品牌取決於版本和方法。建議:將登入頁面、登入標題、網站圖示以及任何桌面或行動用戶端作為單獨的檢查項目進行規劃。

安全地準備主題應用程式

請先備份您的實例,並在測試環境中進行測試。記錄 ownCloud 版本、PHP/執行時間包名、應用程式目錄、Web 伺服器使用者以及目前主題相關的配置。官方手冊建議將自訂主題儲存在自訂應用程式目錄中,以降低升級過程中遺失主題的風險。操作:找到您配置的自訂應用程式目錄,或使用文件apps-external中提供的目錄(如有);不要假設每個套件都使用相同的路徑。

主題應用程式需要一個appinfo/info.xml文件,該文件包含與其資料夾匹配的應用程式 ID、<theme/>類型以及 ownCloud 依賴項範圍。開發者手冊的範例使用 Classic 10 作為最低和最高版本。請根據您實際支援的版本進行調整,而不是盲目複製一個範圍。操作:從 ownCloud 的官方主題範例開始,並在進行修改之前檢查其現有文件。

例如,主題目錄可以命名為 ` theme-acme<theme_name>` appinfo/info.xml、core/css/styles.css`<image_override>` 和 `<image_override>`,其路徑與對應的​​ ownCloud 路徑一致。目錄名稱和<id>值必須一致。建議:對主題進行版本控制,並使用唯一 ID 以避免與已安裝的應用程式發生衝突。

變更徽標和主題顏色

若要覆蓋圖片,請保留其在主題中的相對路徑。例如,登入標誌的預設路徑是 `<logo_default_path>` core/img/logo-icon.svg,因此主題覆寫路徑theme-acme/core/img/logo-icon.svg應位於 `<logo_default_path>`。手冊中列出了其他圖片路徑,並指出網站圖示 (favicon) 的處理應同時包含 SVG 和 PNG 格式的覆蓋範圍。操作方法:檢查目前安裝的資源,並在主題中重新建立相關路徑,而不是取代核心檔案。

若要覆蓋顏色,請core/css/styles.css在主體中建立樣式。官方手冊中提供#body-login了登入背景和#body-public #header登入標題等樣式選擇器。以下是一個最小範例:

#body-login {
  background: #17324d;
}

#body-public #header {
  background-color: #17324d;
}

這會更改已記錄的區域;它並非適用於所有應用程式、對話方塊或第三方介面的完整品牌調色板。操作方法:在您自己的實例上使用瀏覽器開發者工具來識別目標元件,然後將作用範圍較窄的 CSS 規則新增至主題樣式表。避免使用可能導致文字、按鈕或焦點狀態難以辨認的寬泛選擇器。

使用適合現有空間的標誌變體,並檢查普通文字、連結、控制和鍵盤焦點的對比。特定的樣式選擇器和資源尺寸可能會因已安裝的版本、主題和應用程式而異。操作:將您的樣式覆蓋與測試環境中的目前 DOM 和資源進行比較,而不是假設舊的樣式選擇器仍然匹配。

啟用主題和帳戶以進行完整性檢查

將主題檔案放置到正確的應用程式目錄並設定所有權以便 Web 伺服器可以讀取後,使用安裝程式的occ命令啟用它。官方手冊提供docker compose exec owncloud occ app:enable theme-acme了一個 Docker 範例;非 Docker 安裝應使用其自身支援的命令上下文。也可以在「管理應用程式」畫面中啟用主題,主題會顯示在已停用應用程式清單中。操作:依照部署環境的命令格式操作,並確認應用程式 ID 與目錄和元資料相符。

私有主題可能沒有 Marketplace 簽名。 ownCloud 文件中說明,在integrity.ignore.missing.app.signature需要時新增其應用程式 ID 可以避免出現缺少簽署的警告。此例外情況僅適用於未簽署的私有主題;並不意味著應該全域禁用完整性檢查。操作:如果您的安裝報告了該警告,請僅將主題 ID 新增至文件中指定的允許清單中,並保留所有其他完整性保護措施。

主題應用的檔案權限必須允許 Web 伺服器讀取這些檔案。特定的使用者和群組名稱因軟體包和主機而異;文件中的www-data範例並非通用。操作:檢查正在運行的服務的實際帳戶,並嚴格限制主題目錄的所有權。

驗證結果並保存。

在隱私瀏覽視窗中開啟登入頁面,然後登入並檢查頁首、導覽列、文件清單、設定頁面以及較小的視窗尺寸。確認標誌清晰、文字可讀、焦點指示器可見,且所有控制項均未消失在背景中。手冊建議在實際開發環境中進行測試,並使用瀏覽器檢查器工具嘗試 CSS 變更。操作:先在測試環境中測試這些路徑,然後在部署後清除瀏覽器快取並重複此操作。

如果問題依舊,請檢查主題應用程式是否已啟用、目錄是否位於已掃描的應用程式路徑內、相對檔案名稱是否與預設值匹配,以及 CSS 選擇器是否仍與頁面相符。檢查 ownCloud 和 Web 伺服器日誌,查看是否有載入或權限錯誤。快取的 CSS 或瀏覽器資源可能會延遲可見的更新。操作:確認檔案和應用程式狀態後,清除瀏覽器快取或使用隱私視窗;切勿為了快速排查問題而刪除生產資料或停用完整性檢查。

最後,每次 ownCloud 更新後都要重新測試主題。核心標記和資源路徑可能會發生變化,因此自訂 CSS 可能會失效或與新介面衝突。手冊中介紹了主題應用的方法,但並不保證所有覆蓋設定在不同版本之間都保持相容。建議:保留一個回滾副本,將您的主題與要升級到的版本進行比較,並在測試後移除過時的覆蓋設定。

官方參考資料

留下評論

帶有主題應用程式和 CSS 的品牌 ownCloud Classic 10

使用主題應用程式取代 ownCloud Classic 10 標誌並調整 Web UI 顏色,同時避免升級和完整性檢查陷阱。

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

按角色為新的 ownCloud Infinite Scale 使用者指派基於位元組的儲存限制,並提供 proxy.yaml 範例和安全性驗證清單。

修正 TLS 來源端的 ownCloud 同步憑證錯誤

修正 TLS 來源端的 ownCloud 同步憑證錯誤

透過檢查伺服器主機名稱、憑證鏈、私有 CA 信任和強制入口網站問題,恢復 ownCloud 桌面同步,而無需停用 TLS 驗證。

升級後清除 ownCloud 完整性警告

使用無效文件報告來識別不匹配的核心文件或應用程式簽名,恢復正確的發布文件,並安全地驗證完整性檢查。

使用 Docker Compose 安裝 ownCloud Infinite Scale

從官方 Compose 範例部署 ownCloud Infinite Scale,配置網域和持久存儲,然後驗證 TLS、容器和首次登入。

為 ownCloud Infinite Scale 配置 S3 Blob 存儲

為 ownCloud Infinite Scale 配置 S3 Blob 存儲

設定 S3NG 驅動程式、儲存桶權限、持久性元資料儲存和上傳大小,以便 ownCloud Infinite Scale 可以可靠地儲存檔案內容。

當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

檢查檔案狀態、配額、臨時磁碟空間、PHP 限制和代理逾時,找出 ownCloud 伺服器上傳接近完成時停止的原因。

安全地清除 ownCloud Apache .htaccess 警告

安全地清除 ownCloud Apache .htaccess 警告

僅對 ownCloud 的 Web 根目錄設定 AllowOverride All,驗證活動的 Apache 虛擬主機,然後安全地重新載入以恢復 .htaccess 規則。

設定 ownCloud 企業審計並驗證日誌

啟用 ownCloud 的企業審計應用程序,將 admin_audit 事件路由到受保護的日誌文件,並確認正在記錄真實使用者的操作。

使用 OIDC 將 ownCloud Infinite Scale 連接到 Keycloak

使用 OIDC 將 ownCloud Infinite Scale 連接到 Keycloak

讓 Keycloak 的 realm 頒發者、Web 用戶端和使用者聲明保持一致,以便 ownCloud Infinite Scale 能夠可靠地在 Web 和行動用戶端上登入使用者。