tracker.inc.php

tracker.inc.php §

プラグイン作るの久しぶりかも。

tracker.inc.php

なんぞや §

PukiWiki1.4のプラグイン。

なにするものぞ §

bugtrack.inc.phpに、以下の機能拡張を施したものです。

:config/plugin/tracker/以下の設定ファイルを編集することで、項目の数や配置等を自由に設定できます。
このサイトには以下の設定を置いてあります。
- 全部入り
- bugtrack.inc.php風
- 質問箱用 article.inc.php風form
- ToDo?用

時間があったら、一覧表示で絞り込みや並べ替えなどができるようにする予定です。
- しました。

いかにして §

このサイトの設定を参考に :config/plugin/tracker の下に項目定義のページを作成します。基本的に設置するtracker毎に１組（4ページ）作成します。

:config/plugin/tracker/hoge

hogeテンプレートの項目の内容を記述します

:config/plugin/tracker/hoge/form

入力フォームの項目とレイアウトを記述します

:config/plugin/tracker/hoge/page

入力した内容をページ化する際のテンプレートを記述します

:config/plugin/tracker/hoge/list

tracker_listで表示するリストのレイアウトを記述します
テーブル(|～|)の書式指定(c)/ヘッダ(h)/フッタ(f)行は特別扱いします
目的のページに tracker プラグインを設置します。引数のテンプレート名を省略すると、:config/plugin/tracker/default の項目定義を使用します。
```
#tracker(hoge)
#tracker_list(hoge)
```
テンプレート名に続けてフォーム名/リスト名を指定することができます。
ひとつのテンプレートに複数のフォーム形式/リストフォーマットを用意したいときに便利です。
- :config/plugin/tracker/hoge/form_alternativeページの内容をフォーム表示に使用します。
```
#tracker(hoge/form_alternative)
```
- :config/plugin/tracker/hoge/list_alternativeページの内容をリストフォーマットに使用します。
```
#tracker_list(hoge/list_alternative)
```
第2引数 : 投稿されたトラッキング項目を記録する基準ページの指定
```
#tracker(hoge,記録ページ)
```
のように指定すると、trackerによって作成されるページ名は記録ページ/1,記録ページ/2...のようになります。リストも同様に
```
#tracker_list(hoge,記録ページ)
```
と指定することで、記録ページ配下の項目をリストアップするようになります。
tracker_listの第3引数で、リストのソート順序を指定することができます。
例
```
#tracker_list(,,state:SORT_ASC;priority:SORT_ASC;_real:SORT_DESC)
```
項目ごとに(1)[state]を昇順->(2)[priority]を昇順->(3)[_real](実際のページ名)を降順、の優先順位でソートします。

予約項目 §

formで使用できる予約項目 §

[_name] : 記事を記録するページ名を入力するフィールドを表示。省略可。
[_submit] : [追加]ボタンを表示。

page/listで使用できる予約項目 §

[_date] : 投稿日時
[_page] : 実際に生成したページ名。ブラケットが付く。
[_refer] : #trackerを置いたページ
[_base] : ページのプレフィクス。 tracker()/tracker_list()の第2引数が省略された場合は[_refer]と同じ内容。
[_name] : formの[_name]の内容そのもの。記事を記録するページ名の一部として使用する。
[_real] : 実際に生成したページ名から、[_refer] + '/'を除いた名前。デフォルトは[_name]と同じ内容。
以下のいずれかの条件に該当するときは、trackerプラグインが[_real]に連番を付与し、記事を記録するページ名を決定する。
1. formに[_name]フィールドがない
2. [_name]が空か、ページ名として無効な文字を含む
3. [_refer]/[_name]という名前のページがすでに存在する

listで使用できる予約項目 §

[_update] : ページの最終更新日時
[_past] : 最終更新日時からの経過

trackerで使用できる項目形式のまとめ §

形式	フォームに出力されるタグ	オプション	リスト出力時の整形
text	<input type="text" ...>	size属性の値
page	<input type="text" ...>	size属性の値	有効なページ名のときはリンクを張る
title	<input type="text" ...>	size属性の値	固定アンカーを外し、htmlタグを取り除く
format	<input type="text" ...>	size属性の値	configのIS NOT NULLあるいはIS NULLで指定された書式を適用
textarea	<textarea ...>	cols属性の値,rows属性の値
select	<select ...>	size属性の値[,multiple]	configの項目リストで置換
radio	<input type="radio" ...>	-	configの項目リストで置換
checkbox	<input type="checkbox" ...>	-	configの項目リストで置換
hidden	<input type="hidden" ...>	-	-
file	<input type="file" ...>	size属性の値	-
submit	<input type="submit" ...>	-	-

メモ §

最新の5件を表示しています。コメントページを参照

バグを見つけたのですが、バグトラックの入力フォームが見当たりません。何処にあるのでしょうか? -- DW? 2007-09-16 (日) 22:45:27
- PukiWiki に付属のものに関するバグならpukiwiki.dev:BugTrack2 へ -- 2007-09-17 (月) 18:31:04
Trackerの一覧表示で [[[summary]>[_page]]] のようにページ名に別名をつけて表示するときに、他のカラムのセルの色をつける（たとえば,state)にはどう指定すればいいのですか？ご教示ください。 -- 初心者? 2007-11-10 (土) 14:08:11
- 上の補足です。やりたいことは、tracker.inc.phpのbugtrackのように、サマリー項目のセルの色を状態の色を同じにするということです。いろいろ試したが分かりません。よろしくお願いします。 -- 初心者? 2007-11-11 (日) 16:29:35
  - 私も同じことで悩んでいろいろ試したのですが、[,state][[[summary]>[_page]]]で出来ましたよ。 -- よしお? 2007-12-06 (木) 12:50:22
ページ生成時にブラケットなしでページ名（[_page]）を埋め込む方法はありますでしょうか？（&fpageを一時的に無効化するとかでなく） -- Greg? 2008-03-10 (月) 02:59:30
- [_refer]/[_real]でできるんじゃ？ -- 2008-09-02 (火) 22:33:49
[,status][[[_real]>[_page]]]にてできますね。 -- nono? 2008-10-20 (月) 10:22:32
tracker_listから[_page]をクリックした際に、[_page]へ飛ぶのではなくformを表示させたいのですが、どうやったらいいのでしょうか? -- 初心者パート2? 2009-06-09 (火) 11:40:41