外掛¶

外掛清單¶

您可以在 外掛目錄 中找到 Redmine 外掛的完整清單。

更多外掛（有些處於非常早期的開發階段），這些外掛未列在 外掛目錄 中，但可在 GitHub 上公開取得，可以使用 像這樣的搜尋 找到。

安裝外掛¶

1. 將您的外掛目錄複製到 #{RAILS_ROOT}/plugins 中。如果您直接從 GitHub 下載外掛，您可以透過切換到您的外掛目錄並發出類似 git clone git://github.com/user_name/name_of_the_plugin.git 的指令來完成。

2. 如果外掛需要遷移，請在 #{RAILS_ROOT} 中執行以下指令來升級您的資料庫（請先備份資料庫）。

bundle exec rake redmine:plugins:migrate RAILS_ENV=production

3. 重新啟動 Redmine

您現在應該可以在「管理 -> 外掛」中看到外掛清單，並設定新安裝的外掛（如果外掛需要設定）。

解除安裝外掛¶

1. 如果外掛需要遷移，請執行以下指令來降級您的資料庫（請先備份資料庫）

bundle exec rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production

2. 從外掛資料夾中移除您的外掛：#{RAILS_ROOT}/plugins。

3. 重新啟動 Redmine

撰寫外掛¶

有一個關於撰寫外掛的逐步 教學。更多（詳細）資訊已收集並儲存在「外掛內部」頁面中。
更多（一般）開發者資訊可以在 Redmine 開發者指南 中找到。

遷移外掛¶

如果您想使用先前版本 Redmine 的外掛，則需要考慮外掛 API 的變更或新的 Rails 需求。
無論如何，建議先更新和遷移 Redmine 核心系統，不含外掛，然後在穩定的情況下，嘗試逐一放入外掛，以便在出現問題時知道問題的根源。

請務必考慮由於編碼風格不佳或沒有可用的「掛鉤」而**完全覆蓋檢視**的外掛。也許您可以收集並寫下屬於此類型的外掛參考。

讓我們從...開始

• Redmine_blocks

Redmine 1.3 > 1.4¶

• 必須在 <plugin>/config/routes.rb 中建立 routes.rb，它定義了控制器（參數、動作）映射的網址。
• ARCondition 已移除，沒有替代方案。
• TabularFormBuilder 現在是 Redmine::Views::LabelledFormBuilder。
• 定義您自己的上下文選單現在需要在相應的控制器中使用 helper :context_menus。
• 當然，returning 已被棄用，建議使用 tap。
• 如果您正在對倉庫進行任何操作，請仔細檢查兩次，因為現在每個專案可以有多個倉庫。
• Project#visible_by 已被棄用，並由 Project#visible_condition 取代。

Redmine 1.4 > 2.x¶

• 撰寫與 Redmine 1.x 和 2.x 相容的外掛 - 一些技巧

撰寫 Redmine 2.x 外掛¶

• 教學