こんにちは、新しい Trac プラグインをリリースいたしました。
チケットに「開始日」「終了日」を設定すると Google Calendar の月間表示のように機能する TicketCalendarPlugin を開発いたしました。

このプラグインは自分が担当しているチケットを「いつまでに、何を、どのくらい」対応しなければいけないかをビジュアル的に知りたいと思い、開発したプラグインです。

動作しているスクリーンショット(イメージ図)は以下です。

• TicketCalendarPlugin – Trac Hacks – Plugins Macros etc. – Trac

このエントリーではインストールと初期設定について見ていきます。

1. easy_install でインストール

easy_install に http://trac-hacks.org/wiki/TicketCalendarPlugin/0.12 を渡せばさくっとインストールできます。
svn コマンドがない環境では、これではインストールできないと思います。その場合、Trac-hacksから手動でダウンロードを行い、ダウンロードしたディレクトリを easy_install に渡すようにしてください。

C:>easy_install -Z http://trac-hacks.org/svn/TicketCalendarPlugin/0.12
Downloading http://trac-hacks.org/svn/TicketCalendarPlugin/0.12
Doing subversion checkout from http://trac-hacks.org/svn/TicketCalendarPlugin/0.12 to c:\docume~1\admini~1.ope\locals~1\temp\easy_install-x_lmas\0.12
Processing 0.12
Running setup.py -q bdist_egg --dist-dir c:\docume~1\admini~1.ope\locals~1\temp\easy_install-x_lmas\0.12\egg-dist-tmp-ubt6k_
zip_safe flag not set; analyzing archive contents...
TicketCalendarPlugin 0.12.0.1 is already the active version in easy-install.pth

Installed c:\traclight\python\lib\site-packages\TicketCalendarPlugin-0.12.0.1-py2.6.egg
Processing dependencies for TicketCalendarPlugin==0.12.0.1
Finished processing dependencies for TicketCalendarPlugin==0.12.0.1

2. trac.ini でプラグインを有効にする

有効にしたい Trac プロジェクトの conf/trac.ini でこのプラグインを有効にします。(inherit-file で共有している trac.ini でも可能)

# trac.ini
[components]
ticketcalendar.web_ui.* = enabled

[ticketcalendar]
first_week_day = 6
milestone.color = #C2C2C2
milestone.icon = ui-icon-flag
ticket.due_date = due_date
ticket.due_date.format = %Y/%m/%d
ticket.start_date = start_date
ticket.start_date.format = %Y/%m/%d

この後、Trac を動作させている Web サーバを再起動させます。
チケットカレンダーを利用するためにチケットにカスタムフィールドに2項目追加する必要があります。
チケットカレンダーで利用するカスタムフィールドは trac.ini で定義します。

例示した設定の場合

• start_date ・・・作業開始日
• due_date ・・・作業終了日

を設定しています。利用する前にカスタムフィールドを追加してください。
これでインストール作業は終了です。

利用方法の説明についてはこちらのエントリー「Trac プラグイン:TicketCalendarPlugin の使用方法」を参照してください。

3. 設定の説明とカスタマイズ

チケットカレンダーは trac.ini で色やアイコンを利用者の好みにカスタマイズすることができます。
TicketCalendarPlugin の設定項目の説明と利用方法についてまとめています。

first_week_day = 6

milestone.color = #C2C2C2

milestone.icon = ui-icon-flag

ticket.due_date = due_date

ticket.due_date.format = %Y/%m/%d

ticket.start_date = start_date

設定例:
ticket.priority.color = #faa, #ffa, ...
または
ticket.priority.color = blocker:#faa, critical:#ffa, ...

デフォルト:
ticket.priority.color = #fa6653, #ffad46, #7bd148, #4986e7, #cca6ac

設定例
ticket.type.icon = ui-icon-contact, ui-icon-lightbulb, ...
または
ticket.type.icon = task:ui-icon-contact, defect:ui-icon-lightbulb, ...

デフォルト:
ticket.type.icon = ui-icon-contact, ui-icon-lightbulb, ui-icon-check, ui-icon-gear, ui-icon-comment

Tweet