Provide trac portal pages for multiple projects.
Project description
TracPortalPluginは、同一インスタンス上にある複数のTracプロジェクトのポータル機能を提供するプラグインです。
機能
- プロジェクト一覧
全てのプロジェクトのアクティビティを含む情報を一覧で表示します。
- ダッシュボード
所属するプロジェクト全体の直近のタイムラインとマイルストーンおよび自分に関係するチケット情報を表示します。
- プロジェクト横断検索
所属するプロジェクトに対して横断的に検索を行います。
- プロジェクト新規作成
Webインターフェースから新しくTracプロジェクトを作成します。
インストール
まず、以下のいずれかの方法でプラグインのソースを取得します:
$ git clone https://github.com/iij/TracPortalPlugin.git or $ wget https://github.com/iij/TracPortalPlugin/archive/master.zip $ unzip master.zip
環境に合わせた方法でインストールします:
$ python setup.py bdist_egg $ cp dist/*.egg /trac/env/plugins/ or $ python setup.py install
ポータルとなるプロジェクトに対して、Tracの設定ファイル(trac.ini)に以下のように記述し、プラグインを有効にします:
[components] tracportal.* = enabled tracportalopt.* = enabled # (optional)
プラグインをインストール後は、trac-adminコマンドでプロジェクトの環境をアップグレードします:
$ trac-admin /trac/env upgrade
環境に応じてプラグインの設定を行います。
設定情報 をご覧ください。
trac-adminコマンドもしくはWeb上の管理コンソールから必要に応じてポータル機能の権限を設定します。
権限情報 をご覧ください。
依存ライブラリ/プラグイン
Trac >= 0.12
Trac XML-RPC Plugin >= r13194
権限情報
以下は、TracPortalPluginで使用される権限の一覧です。必要に応じて権限を付加してください。
権限 |
概要 |
---|---|
PORTAL_PROJECT_LIST_VIEW |
所属プロジェクト一覧を表示する権限です。 |
PORTAL_PUBLIC_PROJECT_LIST_VIEW |
公開プロジェクト一覧を表示する権限です。 |
PORTAL_DASHBOARD_VIEW |
ダッシュボードを表示する権限です。 |
PORTAL_CROSS_SEARCH_VIEW |
プロジェクト横断検索を表示/実行する権限です。 |
PORTAL_PROJECT_CREATE |
プロジェクト新規作成および実行する権限です。 |
設定情報
以下は、TracPortalPluginの設定一覧です。環境に合わせて設定してください。
Section: [tracportal]
Name |
Description |
---|---|
ignore_projects |
ポータルで無視するTrac環境の名称(ディレクトリ名)をリストで指定します。 |
inherit_file |
継承する設定ファイル(trac.ini)のパスを指定します。 この設定値は、プロジェクト作成時の –inheritオプションの指定に使用されます。 |
notify_email_cc |
プロジェクト作成時の通知メールを送るアドレスを指定します。(Cc) |
notify_email_from |
プロジェクト作成時の通知メールの送信者アドレスを指定します。 |
notify_email_from_name |
プロジェクト作成時の通知メールの送信者名を指定します。 |
parent_base_url |
作成したプロジェクトの元となるURL(base_urlの親階層)を指定します。 例) http://xx.yy.zz/trac とした時に、fooというプロジェクトを作成した場合、このプロジェクトの base_url は http://xx.yy.zz/trac/foo となります。 |
project_activity_assessment_period |
プロジェクト一覧に表示するアクティビティを評価する日数を指定します。 |
project_activity_cache_ttl |
アクティビティ情報のキャッシュの生存期間(sec)を指定します。 |
project_info_cache_ttl |
プロジェクト情報のキャッシュの生存期間(sec)を指定します。 |
project_list_link_url_suffix |
プロジェクト一覧のリンクURLに付加するパス文字列を指定します。 例えば、ログインする必要がある場合は /login を指定します。 |
trac_env_parent_dir |
Tracのプロジェクトを配置しているディレクトリのパスを指定します。 指定がない場合は、Python環境変数のTRAC_ENV_PARENT_DIRが使用されます。 |
サンプル:
[tracportal] ignore_projects = portal inherit_file = /var/www/trac/trac.ini notify_email_cc = xxx@example.com notify_email_from = yyy@example.com notify_email_from_name = TracPortal parent_base_url = http://xxx.yyy.zzz/trac/ trac_env_parent_dir = /var/www/trac/envs
Tracの設定について、更に詳しい情報は wiki:TracIni をご覧ください。
スクリーンショット
プロジェクト一覧
ダッシュボード
プロジェクト横断検索
プロジェクト新規作成
補足情報
ナビゲーションバーの変更
ナビゲーションバーのリンクの並びを変えたい場合は trac.ini の [trac] セクションの mainnav で並びを設定することができます。
例:
[trac] mainnav = wiki, dashboard, cross_search, public_projects, available_projects, new_project
さらに不要なリンクを非表示にしたり、名称を変えたい場合には [mainnav] セクションで設定することができます
例:
[mavinnav] ticket = disabled wiki.label = お知らせ
ポータル以外のプロジェクトにポータルのリンクを追加したい場合
NavAddPlugin というプラグインで簡単にナビゲーションバーにリンクを追加することができます。
例:
[components] navadd.* = enabled [navadd] add_items = tracportal tracportal.title = ポータル tracportal.url = /trac/portal
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.