「WikiPlus」- WEBサイトの管理・運営を簡単にするASP - WEB担当者マニュアル

tracker †

種別

（コマンド）

ブロック型プラグイン

書式

#tracker( [定義名] [,ベースページ名] )

概要

bugtrack プラグインのように、定型的な項目をもったページを作るための入力フォームを表示します。

入力項目が固定されているbugtrack プラグインと機能は似ていますが、入力項目を簡単に変更できる点が違います。FAQ，BBS，書評，TODOリストなど使い道はアイディア次第です。

入力項目の定義は:config/plugin/tracker/ 以下に所定の書式でテンプレートを作成することで設定できます。bugtrack プラグイン互換の入力項目テンプレートが :config/plugin/tracker/default に用意されているので参考にして下さい。

公開画面からの編集を許可していない場合には表示されません。
あらかじめ設置するページに、編集許可の設定をしておく必要があります。

引数

定義名は #tracker(hoge) のようにtrackerのテンプレート名を指定します。省略時は :config/plugin/tracker/default が指定されたとみなします。

テンプレート名に続けてフォーム名 / リスト名を指定することができます。ひとつのテンプレートに複数のフォーム形式 / リストフォーマットを用意したいときに便利です。例えば、#tracker(hoge/form_alternative) とすれば :config/plugin/tracker/hoge/form_alternative の内容をフォーム表示に使用しますし、#tracker_list(hoge/list_alternative) とすれば :config/plugin/tracker/hoge/list_alternative の内容をレイアウトに使用します。

ベースページ名はフォームから作成されるページの親階層となるページ名を指定します。省略時は設置したページとなります。

テンプレート

テンプレートは基本的に設置するtracker毎に１組（4ページ）作成します。

• :config/plugin/tracker/hoge

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

• :config/plugin/tracker/hoge/form

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

• :config/plugin/tracker/default/page

  入力した内容をページ化する際のフォーマットを記述します。

• :config/plugin/tracker/hoge/list

  tracker_listで表示するリストのレイアウトを記述します。テーブル(|〜|)の書式指定(c) / ヘッダ(h) / フッタ(f) 行は特別扱いします。

予約項目

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

記述と表示例 †

あらかじめテンプレートを用意して、任意の入力フォームを作成します。
入力されたデータは、新しいページとして記録されます。

編集画面

1. :config/plugin/tracker/test
   テンプレートの項目を設定します。入力項目に選択肢を指定することも可能です。
   

   * fields
   |項目名  |見出し    |タイプ  |オプション|デフォルト|h
   |Name    |名前      |page    |30        |          |
   |Kana    |ふりがな  |text    |30        |          |
   |Zip     |郵便番号  |text    |10        |          |
   |Address |住所      |text    |30        |          |
   |Sex     |性別      |radio   |2         |          |
   |Age     |年齢      |select  |6         |          |
   |Comment |コメント  |textarea|30,5      |          |
   　
   * Sex
   |男性  |CENTER:男性|
   |女性  |CENTER:女性| 
   　
   * Age
   |-20   |-20|
   |21-30 |21-30 |
   |31-40 |31-40 |
   |41-50 |41-50 |
   |51-60 |51-60 |
   |61-   |61-   |

   
   
2. :config/plugin/tracker/test/form
   入力フォームの項目とレイアウトを作成します。

   |RIGHT:   |LEFT:     |c
   |~名前    |[_name]   |
   |~ふりがな|[Kana]    |
   |~郵便番号|[Zip]     |
   |~住所    |[Address] |
   |~性別    |[Sex]     |
   |~年齢    |[Age]     |
   |~コメント|[Comment] |
   |>|CENTER:[_submit]  |

   
   
3. :config/plugin/tracker/test/list
   入力されたデータを、tracker_list プラグインで一覧表示させるときの書式を設定します。
   

   |~[_page]|~[Name]|~[Kana]|~[Zip]|~[Address]|~[Sex]|~[Age]|~[Comment]|h
   |[_page]|[_name]|[Kana]|[Zip]|[Address]|[Sex]|[Age]|[Comment]|

   
   
4. :config/plugin/tracker/test/page
   入力されたデータを表示するページの書式を設定します。

   * [Summary]
   -名前    :[_name]
   -ふりがな:[Kana]
   -郵便番号:[Zip]
   -住所    :[Address]
   -性別    :[Sex]
   -年齢    :[Age]
   -コメント:[Comment]
    
   ----
    
   #comment

   
   
5. 公開画面では、tracker プラグイン とtracker_list プラグイン で、住所録の入力フォームと一覧表を表示します。
   テンプレート名は test になります。

   #tracker(test)　　　← テンプレート名は、test
   #tracker_list(test)

   
   

公開画面

(画像を表示しています)

ページ名	名前	ふりがな	郵便番号	住所	性別	年齢	コメント
plugin/tracker/佐藤一郎	佐藤一郎	さとういちろう	123-0123	○○市△△一丁目2-3	男性	21-30	コメントを記入します。