&inserttemplate (ToraToraWikiManual/ja/Wiki/Function/inserttemplate)
概要
&inserttemplate(before, after, once, url, japanese, label=ラベル){テンプレート}
テンプレートを定義し，そのテンプレートをページに挿入するフォームを作成します． このファンクションを利用してお好みの形式の掲示板を作成することもできます．
パラメータ
- before
- フォームの前にテンプレートを挿入します．デフォルトで指定されています．aboveと書いても同様です．
- after
- フォームの後にテンプレートを挿入します．belowと書いても同様です．
- once
- フォームの位置にテンプレートを挿入し，フォームは削除されます．replaceと書いても同様です．
- url
- URLの入力を許可します．デフォルトで指定されています． 無効にする場合は!urlと指定します．
- japanese
- 日本語を含む入力のみ許可します．
- label=ラベル
- ボタンに表示される文字を指定します．
対象
対象にはテンプレートを書きます． テンプレートにはフォームによって挿入したい内容をそのままWiki記法で書きます． テンプレートの中で
@項目名@
という形式で書くと，フォームの入力項目になり，テンプレートを挿入する際に入力された文字に置き換わります．
@項目名=初期値@
という形式も使用でき，この場合はフォームに指定された初期値が埋め込まれます．
@項目名#@
のように項目名の最後に#記号をつけるとその項目は複数行の内容を入力することができるようになります．
@項目名*@
のように項目名の最後に*記号をつけると必須項目になります．
@項目名'@
のように項目名の最後に'記号をつけるとその項目に入力されたWiki記法は無視されるようになります．
@項目名/選択肢1/選択肢2/...@
のように項目名の最後に/記号をつけ， 続けて選択肢を列挙するとその項目はプルダウンメニューなり指定した選択肢から選ぶようになります．
@-項目名@
のように項目名の前に行頭記法の記号を書くとフォームに入力された内容の行頭に指定した記号が追加されます．
@-項目名#'*=初期値@
のように組み合わせて使用することもできます．
また，テンプレート内で$user$と書いた場合はフォームで投稿したユーザ名， $time$と書いた場合はフォームで投稿を行った日時に置き換わります．
テンプレートに$LAST$と指定すると直前に使用したテンプレートを使用することができます．
例
//掲示板風テンプレート
//(実際にSandBox等のどこかのページにコピペして使用してみると楽に理解できるはずです)
&inserttemplate() {
*@タイトル@
:投稿日時|&time(new){$time$}
:投稿者|@名前=$user$@
@ 本文#=ここに本文@
}