Show page source of plugins/DecoratorPlugin #7322

= DecoratorPlugin =
== 説明 ==
今までTrac月では、Tracの本体を直接変更して機能追加を行っていましたが、Tracのバージョンアップに追従するのが面倒なので、trac0.11ベースのTrac月(2.0)以降はプラグインとして機能を切りだして提供します。その第1段として、様々なデコレーションを追加するプラグインを作成しました。

Tracのフィールドにカレンダ機能の追加とレポートのアイコン化を行います。

== カレンダ機能 ==
下記のような感じで、カレンダ機能を追加します。[[BR]]

[[Embed(calendar.png)]][[BR]]

trac.iniに下記のように追加します。

{{{
[decorator]
calendar_fields=due_assign,due_close
}}}
0.11系ではデフォルトで、due_assignとdue_closeフィールドにカレンダ機能を追加するようになっていますので設定は不要です。[[BR]]
0.10系ではデフォルトで設定は有りませんので、カレンダ機能を追加したいフィールドをtrac.iniに設定してください。

== アイコン化レポート ==
下記のような感じで、レポートをアイコン化します。[[BR]]
[[Embed(iconized_report.png)]][[BR]]
この機能は!JavaScriptを利用してレポートをアイコン化するため、スペックが低いマシンでは重くなるかも知れません。[[BR]]
その場合は、次のようにするとアイコン化機能をoffにすることができます。

{{{
[decorator]
iconized_report=False
}}}

== インストール方法 ==
下記のようにしてインストールします。 
=== easy_install利用時 ===
For Trac 0.11[[BR]]  easy_install !http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/decoratorplugin/trunk

For Trac 0.10[[BR]]  easy_install !http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/decoratorplugin/branches/0.10

=== 手動導入時 ===
For Trac 0.11[[BR]]
{{{
$ svn co http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/decoratorplugin/trunk
$ cd trunk
$ python setup.py bdist_egg
$ cp dist/TracDecoratorPlugin-x.x.egg <プラグインディレクトリ>
}}}

For Trac 0.10[[BR]]
{{{
$ svn co http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/decoratorplugin/branches/0.10
$ cd trunk
$ python setup.py bdist_egg
$ cp dist/TracDecoratorPlugin-x.x.egg <プラグインディレクトリ>
}}}

== ソース ==
[http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/decoratorplugin/ sf.jpのSVNリポジトリ]から取得できます。

== 注意事項 ==
0.10系の !DecoratorPlugin は'''非Trac月環境'''をターゲットとしています。

0.10系Trac月で利用する場合、このプラグインを利用するには以下の作業が必要です。
 * 各プロジェクトのtemplateにある ticket.cs および newticket.cs を削除もしくはリネーム
この作業の結果、Trac月の持つユーザ名の補完機能は利用できなくなります。