tracker.inc.php - しうえいの脳空間

tracker.inc.php

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

なんぞや

PukiWiki1.4のプラグイン。

なにするものぞ

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

• :config/plugin/tracker/以下の設定ファイルを編集することで、項目の数や配置等を自由に設定できます。

  このサイトには以下の設定を置いてあります。

  • 全部入り :)
    • :config/plugin/tracker/sample (ソース)
    • :config/plugin/tracker/sample/form (ソース)
    • :config/plugin/tracker/sample/list (ソース)
    • :config/plugin/tracker/sample/page (ソース)
  • 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] : 最終更新日時からの経過

メモ

Bug Track

#tracker #tracker_list

---

:PukiWiki