cardformプラグイン

CardForm用のformを挿入します。

このプラグインについて
CardFormプラグイン全般について

内容
使用方法１：簡単な例

form*プラグインによるフォームの記述
cardformプラグインによるフォームの表示
データの入力

使用方法２：保存用レイアウトを別にする

入力用フォーム配置ページ
データレイアウトページ
フォームの使用

使用方法３：入力データを利用する

入力データの一覧表示
入力件数の表示

サンプル
ライセンス
更新履歴

var.3からvar.4alpha1までの主な変更点
var.4alpha1からvar.4alpha2までの主な変更点
var.4alpha2からvar.4alpha3までの主な変更点
var.4alpha3からvar.4alpha4までの主な変更点
var.4alpha4からvar.4alpha5までの主な変更点
var.4alpha5からvar.4alpha6までの主な変更点

このプラグインについて

引数として指定したページformpageの内容に従いフォームを出力します。このフォームにより入力された値は引数として渡したbasenameを元に、 bugtrackプラグインの様にbasename/数字というページに保存されます。ただし、savepageが指定されていればsavepageに保存されます。

第1引数にformpageを指定します。
第2引数にbasenameを指定します。
第3引数にsavepageが指定できます。
basenameが省略された場合はformpageが使われます。

{{cardform formpage,basename,savepage}}

formpageではformtext、formsubmit等のプラグインを使って実際のフォーム要素を配置します。 formstart,formendなどはcardformプラグインにより追加されるため、これらのプラグインは置かないでください。

このフォームを使って送られたデータはbasename/数字というページに保存されます。ただし、CGIパラメータpageがある場合はその値が保存ページ名となります。 savepageがあればこの値をCGIパラメータpageに設定し、保存ページ名とします。

savepageを指定した場合、すでにそのページがあればその内容をフォームの初期値とします。savepageがない、または指定されていない場合、basename/0というページがあればそのページ内容を初期値とします。

このフォームにより作られるページはbasename、もしくはformpageの内容を元に作られます。新しく作られるページは元のページの、%パラメータ名%またはパラメータ名に対応するフォームプラグインをパラメータ値で置換した内容となります。また、basenameというページがなければ::と:::を使ってCGIパラメータをすべて保存します。

CGIパラメータは、ユーザが使う任意のパラメータのほか、幾つかの機能をもつパラメータが存在します。以下にそれを説明します。

action: cardformプラグインのアクションハンドラを呼び出すために"CARDFORM" である必要があります。本プラグインにより自動的に付けられます。
basename: アクションハンドラに保存に使用すべきbasenameを通知するために必要です。本プラグインにより自動的に付けられます。
page: このパラメータは通常アクションハンドラに渡す必要がありません。アクションハンドラにこのパラメータが渡されていない場合、アクションハンドラはbasenameより保存すべきページ名を求め、このパラメータに設定します。このパラメータがすでに設定されていた場合はそのままそのページ名が使われます。（すでに存在していれば上書きされます）
time: このパラメータは通常アクションハンドラに渡す必要がありません。アクションハンドラにこのパラメータが渡されていない場合、アクションハンドラは現在日時をこのパラメータに設定します。これにより保存ページに保存日時を残す事ができます。
debug: このパラメータは通常アクションハンドラに渡す必要がありません。アクションハンドラにこのパラメータが渡された場合、アクションハンドラはデバッグモードで動作します。アクションハンドラは通常のように動作し、保存すべき内容を生成し、クライアントに送信しますが、実際には保存しません。保存される値やページ内容を確認するために使用できます。なお、パラメータ値は評価されません。

CardFormプラグイン全般について

内容

FreeStyle Wikiでカード型データベースを実現するプラグイン群です。

入力: プラグインにより（wiki書式の範囲で）自由なレイアウトのフォームを作ることができます。
保存: フォームにより入力されたデータは雛型となるページを元に1件毎に、バグトラックのようなbasename/数字というページとして保存されます。
利用: basename/数字形式のページ群をカード型データベースとみなして表を作ったり合計したりできます。

使用方法１：簡単な例

まず、データ入力用のフォームが必要です。

form*プラグインによるフォームの記述

フォームの記述はformで始まるフォーム記述用のプラグインによって行ないます。

*名前： {{formtext name}}
*年代： {{formselect age,10代,20代,30代,40代,50代}}
*好きな物： {{formtext favor,size=30}}
{{formsubmit 投票}}{{formreset リセット}}

これをFavoriteというページに保存します。え？フォームが表示されない？それで正常です。慌てずに。

cardformプラグインによるフォームの表示

次にフォームを表示したい所に以下のように書きます。

{{cardform Favorite}}

これで、フォームを表示するためのプラグインcardformにより、先ほどのフォームを記述したページをインクルードしフォームとして表示します。

,,
,投稿者,{{formtext user}}
,サマリ,"{{formtext subject,size=60}}"
,カテゴリ,"{{formselect categoly,本体,プラグイン,ドキュメント}}"
,優先度,"{{formselect rate,緊急,重要,普通,低}}"
,状態,"{{formselect stat,提案,着手,完了,リリース済,保留,却下}}"
,内容,"{{formtextarea msg,rows=10,cols=60}}"
{{formsubmit 投票}}{{formreset リセット}}

入力データレイアウトページ

次に、入力データを保存するページをレイアウトします。

!!!%subject%
*投稿者： %user%
*カテゴリ： %categoly%
*優先度： %rate%
*状態： %stat%
*日時： %time%
{{bugstate}}
!!内容
%msg%
!!コメント
{{comment}}

これをBugTrack-testとして保存します。

フォームの使用

それではフォームを使用してみましょう。

{{cardform BugTrackForm,BugTrack-test}}

使用方法３：入力データを利用する

入力されたデータの利用方法です。

入力データの一覧表示

利用方法１のフォームから入力した値を一覧表示するには次のように書きます。

{{cardlist Favorite,名前:*名前： ,年代:*年代： ,好きな物:*好きな物： ,}}

20代のデータのみ、名前順に表示したい場合は次のように書きます。

{{cardlist Favorite,*年代： ==20代,%sortby_alphabet%:*名前： ,名前:*名前： ,年代:*年代： ,好きな物:*好きな物： ,}}

わかりにくいですね。実はこの方法は推奨できません。入力データを扱う場合は利用方法２の保存レイアウトを別にする方法を用いた方がわかりやすくなります。利用方法２の場合、次のようになります。

{{cardlist BugTrack-test,%sortby_alphabet%:stat,ページ:%cardform_pagename%,カテゴリ:categoly,優先度:rate,状態:stat,投稿者:user,サマリ:subject}}

最初の「BugTrack-test」はBugTrack-test/数字ページが対象で、そのフォーマットはページBugTrack-testが元になっている事を示しています。

次の「%sortby_alphabet%:stat」はstatをアルファベット順（正確には文字コード順）にソートするという事です。

次の「ページ:%cardform_pagename%」からは実際の表示内容です。この時、%cardform_pagename%はページ名を表します。

入力件数の表示

利用方法１で「20代の件数/全体の件数」という表示をしてみましょう。

{{cardcount Favorite,*年代： ==20代}}/{{cardcount Favorite}}

利用方法２の場合、次のようになります。

現在全{{cardcount BugTrack-test}}件中
{{cardcount BugTrack-test,stat提案}}件が提案状態で、
そのうち優先度が緊急は{{cardcount BugTrack-test,stat提案,rate==緊急}}件、
重要は{{cardcount BugTrack-test,stat提案,rate==重要}}件、
普通は{{cardcount BugTrack-test,stat提案,rate==普通}}件、
低は{{cardcount BugTrack-test,stat提案,rate==低}}件です。