Google 日曆外掛¶

• 目錄
• Google 日曆外掛
  • 打包者與維護者
  • 作者
  • 更新日誌
  • 最新穩定版本
  • 說明
  • 相容性
  • 先決條件
  • 取得方式
    • 打包版本
    • GitHub 原始碼
  • 安裝
  • 全域設定
  • 專案層級設定
    • 從 Google 取得嵌入程式碼
    • 為每個專案設定外掛
  • 常見問題
  • 升級
  • 解除安裝
  • 授權
  • 支援

一個 Redmine 外掛，提供專案經理一種方法，可以在 Redmine 專案中包含 Google 日曆 iframe 作為一個分頁。

打包者與維護者¶

• Mischa The Evil

作者¶

• Jim Mulholland

更新日誌¶

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

最新穩定版本¶

目前可用的最新穩定版本外掛為 0.1.2 版。

說明¶

Google 日曆外掛是一個簡單的 Redmine 外掛，提供專案經理一種方法，可以在 Redmine 專案中包含 Google 日曆 iframe 作為一個分頁。日曆時區將根據您 Redmine 使用者帳戶中的時區，以使用者為依據，如果使用者未選取時區，則預設為 <iframe> 中設定的時區。

相容性¶

此外掛與 Redmine 0.8.x 版以及目前的 Redmine 主幹版本相容。

先決條件¶

此插件需要安裝 tzinfo gem。如果您的伺服器上還沒有安裝，可以使用以下命令安裝：

$ sudo gem install tzinfo

取得方式¶

打包版本¶

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

• 此 GitHub 網站：http://github.com/MischaTheEvil/redmine_google_calendar/downloads
• 此 MediaFire 帳戶：http://www.mediafire.com/evildev

GitHub 原始碼¶

GitHub 儲存庫網址：http://github.com/MischaTheEvil/redmine_google_calendar/tree/master

可以使用兩種不同的方法從 GitHub 儲存庫「複製」此外掛的原始碼

• 使用 git clone（Git 版本 < 1.5.3）

  $ cd {RAILS_ROOT}/vendor/plugins
  $ git clone git://github.com/MischaTheEvil/redmine_google_calendar.git
  

• 使用 git-rails（Git 版本 >= 1.5.3 -- 因為 git-rails gem 使用在 v. 1.5.3 中引入的 Git 子模組）

  $ sudo gem install git-rails
  $ git-rails install git://github.com/MischaTheEvil/redmine_google_calendar.git
  

安裝¶

1. 從可用的來源下載外掛（請參閱 取得)
2. 根據您取得外掛的方式，按照 https://redmine.dev.org.tw/wiki/redmine/Plugins 的說明安裝外掛（此插件不需要外掛資料庫遷移）
3. 重新啟動 Redmine

全域設定¶

在您開始於偏好的專案中實際使用外掛之前，必須先完成一些設定。

1. 前往「管理 -> 自訂欄位」，並建立一個類型為「長文字」的專案自訂欄位，例如命名為「Google 日曆 IFrame」。
2. 前往「管理 -> 外掛 -> Google 日曆外掛 > 設定」以設定 Google 日曆外掛
• 選擇包含 Google 日曆 iframe 的專案自訂欄位；在此範例中，選擇新建立的專案自訂欄位「Google 日曆 IFrame」

專案層級設定¶

完成外掛的全域設定後，您可以選擇哪些專案實際上可以使用外掛提供的功能。由於外掛實作此功能的方式，也可以設定在專案層級上實際顯示哪個 Google 日曆。
專案層級設定包含以下兩個任務

從 Google 取得嵌入程式碼¶

您應該取得實際的 Google 日曆嵌入程式碼 (<iframe>)。因此，請前往您要嵌入的 Google 日曆，然後

1. 點選左上角的「設定」
2. 點選「日曆」標籤
3. 選擇您要使用的日曆
4. 在「嵌入此日曆」區段中，從文字方塊複製整個 <iframe> 程式碼

（如果這是私人日曆，您必須將 <iframe> 中的「src」替換為點選同一頁面上「私人地址」區段中的藍色「HTML」區塊後找到的 HTML。）

如需如何取得日曆資訊的詳細說明，請參閱 http://www.google.com/calendar/embed/EmbedHelper_en.html。

為每個專案設定外掛¶

現在應該將複製的 <iframe> 程式碼新增至 Redmine 專案。首先，我們需要確保已為專案啟用外掛。
在偏好的 Redmine 專案中，前往「專案設定」

1. 在「模組」標籤上：勾選「Google 日曆」以啟用外掛模組。
2. 在「資訊」標籤上：將您從要嵌入的 Google 日曆複製到剪貼簿的 <iframe> 程式碼貼到您在步驟 1 的全域設定下建立的「Google 日曆 IFrame」專案自訂欄位中。

之後，專案選單中會出現一個名為「日曆」的新項目。點選此項目即可查看您的 Google 日曆。

常見問題¶

1. 在專案概觀標籤上，我看到了 iframe 程式碼。可以將其移除嗎？
   • 可以，請參閱 Redmine 修補程式 #1746，該修補程式提供了一個選項，可以隱藏專案自訂欄位，使其不出現在專案概觀中，專為此目的而設計。

升級¶

1. 使用套裝發行版時：從可用的來源下載外掛的最新原始碼（請參閱 取得)
2. 備份目前部署的 Google 日曆外掛 (cp -r /vendor/plugins/redmine_google_calendar /vendor/plugins/redmine_google_calendar-backup)
3. 重新安裝更新的外掛
   • 使用包裝好的發行版本時：將下載的檔案解壓縮到您的 Redmine 中的插件目錄 *"../vendor/plugins"* 並讓它覆蓋您過時的插件版本（您之前已備份）。
   • 使用 GitHub 源碼時：使用 git pull 或 git-rails update。
4. 重新啟動您的 Redmine。

解除安裝¶

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

授權¶

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

• ©2009, Mischa The Evil (http://www.evil-dev.net)
• ©2008, Jim Mulholland (http://www.squeejee.com)

支援¶

如果您想回報錯誤或請求新功能，您可以在插件 GitHub 網站的問題追蹤區開啟一個新問題：http://github.com/MischaTheEvil/redmine_google_calendar/issues。
您也可以在 Redmine 論壇 的專用插件區發布您對插件的意見回饋。

或者，您也可以加入 freenode IRC 網work 上的 #redmine 頻道，看看活躍的維護者是否已連線（暱稱為 Mischa_The_Evil）。