專案

一般

個人檔案

動作
歷史記錄

外掛 » 外掛清單 »

Redmine Collapse 外掛

Collapse 是一個 Redmine 外掛，它將預設的靜態側邊欄轉換為左側的可摺疊側邊欄，並提供一些包含專案和選單連結的其他標籤。

作者

  • Mischa The Evil

歷史記錄

Redmine Collapse 外掛是 Sebastian Kurfürst 為 Typo3-Forge 建立的可摺疊側邊欄實作的 Redmine 外掛移植版。他已在他們使用的 Redmine 分支中的以下修訂版中實作了此功能

此實作依賴於核心修改和一些自訂的 Typo3 Redmine 外掛。它對 預設、替代 和 經典 佈景主題也沒有任何好處）。這讓作者決定在一個獨立的 Redmine 外掛中實作此功能。

更新日誌

如需完整的更新日誌，請參閱 Redmine Collapse 外掛目錄中的 CHANGELOG 檔案。

最新穩定版本

目前可用的最新穩定版本外掛是 0.2.2 版。

功能

此插件提供以下功能
  • 取代 Redmine 核心的側邊欄
    • 提供的側邊欄可以使用 JavaScript 輔助工具摺疊
    • 預設的側邊欄內容在預設的「動作」標籤上提供
  • 第一個名為「專案」的選用標籤提供（巢狀）專案連結，指向目前使用者具有角色的專案
    • 在 Redmine 0.8.0 上，專案連結指向專案總覽
    • 在 Redmine 0.8.1 和更新版本上，專案連結指向所選專案中目前正在觀看的選單項目（如果有的話）
  • （選用）可以隱藏核心的專案選擇器下拉式選單
  • 第二個名為「選單」的選用標籤提供所有全域（跨專案）檢視和報表的連結（尊重目前使用者的角色和權限）
    • （選用）可以將預設的專案選單（預設放置在標題下方水平方向）「移動」到選單標籤
  • 已使用的字串可以被集中翻譯成各種語言（目前只有捷克語、荷蘭語、英語、德語和斯洛伐克語已被翻譯，其他語言則提供英語預留位置）
  • 100% 兼容所有核心主題（Default、Alternate 和 Classic）以及目前支援和註冊的社群主題（Basecamp 和 Squeejee）

請注意：目前外掛會覆蓋 Redmine 的基本佈局，以實現上述功能。

螢幕截圖

注意：以下螢幕截圖取自外掛版本 0.1.0。它們並未反映最新可用版本 (0.2.2) 的完整功能集。

全域檢視；已收合的側邊欄 全域檢視；已展開的側邊欄，「專案」標籤
Global view; Collapsed sidebar Global view; Un-collapsed sidebar, Projects-tab
專案檢視；已展開的側邊欄，「專案」標籤 專案檢視；已展開的側邊欄，「動作」標籤
Project view; Un-collapsed sidebar, Projects-tab Project view; Un-collapsed sidebar, Actions-tab
設定檢視；顯示專案選擇器 設定檢視；隱藏專案選擇器
Settings view; Project-selector shown Settings view; Project-selector hidden

相容性

以下相容性資訊僅適用於 Redmine Collapse 外掛的 0.2.x 版本。

0.2.x Redmine 相容性

外掛的 0.2.x 版本至少需要 Redmine 0.8.0，並且與 Redmine 主線和 0.8 穩定分支相容，如下表所示

Redmine 分支 修訂/版本 已測試 相容 備註 支援
主線 目前 是 是 是
0.8 穩定版 目前 是 是 是
0.8 穩定版 0.8.4 是 是 是
0.8 穩定版 0.8.3 是 是 是
0.8 穩定版 0.8.2 是 是 是
0.8 穩定版 0.8.1 是 是 是
0.8 穩定版 0.8.0 是 是 是
0.7 穩定版 0.7.x 否 否 否

0.2.x 瀏覽器相容性

外掛的 0.2.x 版本與主要瀏覽器引擎（約 99%）相容。不過，不同瀏覽器之間可能會出現一些細微差異。下表列出了一些已知問題

渲染引擎 瀏覽器 版本 已測試 相容 備註 支援
WebKit Google Chrome 2.0.172.30 是 是 是
Gecko Mozilla Firefox 3.0.10 是 是 是
Trident Microsoft Internet Explorer 7.x 是 否 IE7 缺少對 inherit 值（由 CSS 2.1 定義）的完整支援 是，但需要解決方法
Trident Microsoft Internet Explorer 8.0.6001.18702 是 是 是
WebKit Apple Safari (Win32) 3.2.3 是 是 是
Presto Opera 9.64 是 是 是

取得

可以從以下網址下載外掛的打包版本：

安裝

  1. 從可用來源下載外掛（請參閱取得）
  2. 按照以下說明安裝外掛：https://redmine.dev.org.tw/wiki/redmine/Plugins（此插件不需要外掛資料庫遷移）
  3. 以管理員身分登入 Redmine
  4. 初始設定外掛設定

設定

可以在「管理」->「外掛」->「Redmine Collapse 外掛」->「設定」下設定此外掛。它提供以下設定
  • 顯示「專案」標籤（預設值：勾選）
  • 隱藏核心專案選擇器（預設值：未勾選）
  • 顯示「選單」標籤（預設值：未勾選）
    • 在「選單」標籤中顯示專案選單（預設值：未勾選，僅在勾選「顯示『選單』標籤」時可設定）
  • 側邊欄位置（預設值：左側，但功能尚未實作）

升級

  1. 從可用來源下載最新的壓縮檔（請參閱取得）
  2. 備份目前部署的 Collapse 外掛 (mv /vendor/plugins/redmine_collapse /vendor/plugins/redmine_collapse-backup)
  3. 將下載的檔案解壓縮到 Redmine 的外掛目錄 "../vendor/plugins" 中
  4. 重新啟動 Redmine

解除安裝

  1. 從插件目錄 "../vendor/plugins" 中移除 "redmine_collapse" 目錄
  2. 重新啟動 Redmine

確保 "../public/plugin_assets/redmine_collapse" 中沒有任何插件資源。

Internet Explorer 7 的解決方法

由於 Microsoft Internet Explorer 7 不完全支援 inherit 值（由 CSS 2.1 定義），因此在使用 Default 或 Classic 主題（或任何其他在 #main 上設定不正確 background-color 的主題）時，需要手動修改 CSS 聲明。您需要透過變更 "../assets/stylesheets/collapse.css" 中的以下程式碼片段，將 inherit 值的所需列舉寫死；

從

/***** Overloading Redmine Core layout-selectors *****/
#main {
    background-color: inherit; /* not in IE7 */
    padding: 2px 0px 0px 14px;
}

到

/***** Overloading Redmine Core layout-selectors *****/
#main {
    background-color: #FFFFFF; /* hard-code white (#FFFFFF) for IE7 with either the Default- or the Classic-theme */
    padding: 2px 0px 0px 14px;
}

待辦事項

請注意，這些可能會有所變動
  • 使可摺疊側邊欄的位置可配置（左和右）
  • 重構插件以移除覆蓋基本佈局的需求

致謝

感謝以下人士

程式碼貢獻

  • Eric Davis，Little Stream Software (http://www.littlestreamsoftware.com)
    • 提供 Redmine 核心修補程式的框架（請參閱 "../lib/collapse_application_helper_patch.rb"）
    • 在使整體插件程式碼更加 Ruby 風格方面提供了很大幫助
  • Sebastian Kurfürst，Typo3 開發團隊 (http://www.typo3.org)
    • Redmine 核心黑客的作者，為 Typo3-Forge 實現此功能，作為此插件的基礎
  • Lalit Patel，(http://www.lalit.org)
    • 提供 Javascript 程式碼以 JSON 字串形式將資料儲存在 Cookie 中（最初由 Sebastian 使用）

翻譯貢獻

授權

此插件是開源的，並根據 GNU 通用公共授權條款第 2 版 (GPL) 授權。有關詳細資訊，請參閱 COPYRIGHT.txt 和 GPL.txt 檔案。

支援

如果您需要幫助、想回報錯誤或請求新功能，您可以透過以下方式聯繫
作者的電子郵件地址 (mischa_the_evil [AT] hotmail [DOT] com) 或他的（即將推出的）網站：http://www.evil-dev.net。

或者，您也可以加入 freenode IRC 網路上的 #redmine 頻道，查看作者是否已連線（暱稱為 Mischa_The_Evil）。

附加的螢幕截圖

由 Mischa The Evil 於 將近 14 年前 更新 · 14 個版本