PukiWiki/1.4/Manual/Plugin/S-U

• ---------------------------

S

search

:種別|
~コマンド
~ブロック型プラグイン
:重要度|
~★★★★★
:書式|
''?cmd=search''{
[&word=検索文字列;]
[&type=OR;]
[&base=抽出条件;]
}
~''#search(''
[抽出条件1;
[[,抽出条件2;]
[,抽出条件n;]]]
'')''
:概要|
~検索文字列の入力フォームを表示し、
指定した文字列を含むページの検索を行います。
:引数|
~'''コマンド:'''
~パラメータには検索条件を指定します。

• word − 検索する文字列を指定します。省略時は検索条件を入力するページを表示します。
• type − 'OR' 指定時、OR検索を行います。省略時はAND検索をおこないます。

:|
'''ブロック型プラグイン:'''
~パラメータには検索条件フォームで表示する検索対象ページの抽出条件を指定します。

• 抽出条件1,2,…n − 入力フォームの抽出条件の選択肢を表示順で指定します。

抽出条件選択時、選択した語句で始まるページ群に対してのみ、検索を実行します。
特定のページ群だけを検索したい場合、検索処理がより早く終了します。
抽出条件を選択しなかった場合は全ページが対象となります。
省略時は選択欄が表示されず、常に全ページが検索対象となります。
:プラグイン内設定|~

• PLUGIN_SEARCH_DISABLE_GET_ACCESS　GETメソッドによる検索を禁止する（DoS攻撃、SPAMbot、ワーム対策）
• PLUGIN_SEARCH_MAX_LENGTH　検索する文字列として指定可能な最大文字数 (同)
• PLUGIN_SEARCH_MAX_BASE　抽出条件として指定可能な件数の最大値

server

:種別|
~ブロック型プラグイン
:重要度|
~★☆☆☆☆
:書式|
''#server''
:概要|
~サーバーの情報(サーバー名、サーバーソフトウエア、サーバー管理者)を表示します。

setlinebreak

:種別|
~ブロック型プラグイン
:重要度|
~★☆☆☆☆
:書式|
''#setlinebreak(''
[on;|off;|default;]
'')''
:概要|
~入力文章中の改行を改行とみなすかどうかの設定を行います。
~PukiWikiが入力文章中の改行をどのように扱うかはpukiwiki.ini内の$line_breakの設定内容によって変わります（下記参照）。

~setlinebreakプラグインは該当ページの以降の行に関して、
$line_breakの設定に因らず改行をどのように扱うかを指定できるようになります。
:引数|
~パラメータには以降の改行の扱いを指定します。
パラメータが省略された場合、改行とみなすかどうかについての設定を逆転させます。

• on − 以降の文章で段落内の改行を改行とみなします($line_break=1と同様)。
• off − 以降の文章で改行を無視します($line_break=0と同様)。

改行を行うためには行末にチルダを記述するか、
行中でbrプラグインを使用する必要があります。

• default − 改行の扱いをそのサイトの$line_break設定に戻します。

showrss

:種別|
~ブロック型プラグイン
:重要度|
~★☆☆☆☆
:書式|
''#showrss(''
RSSへのパス;
[,[default;|menubar;|recent;]
[,[キャッシュ生存時間;]
[,1;
]]]
'')''
:概要|
~指定されたRSSを取得し、一覧表示します。
~ページの解釈毎にRSSの取得を行う為、頻繁に参照されるページでshowrssを使用される場合はキャッシュ機能を使うことをお勧めします。相手サイトの更新頻度に応じてキャッシュの生存時間を適宜設定して下さい。
:引数|
~RSSへのパスにはRSSへのファイルパスやURLを指定します。
~テンプレート名には取得したRSSの表示方法を指定します。省略時はdefault となります。

• default − 単純にページを列挙します。
• menubar − ページ名の前に黒丸をつけます。MenuBarなど、横幅に制限にある場合に便利です。
• recent − recentプラグインの出力のように、ページ名の前に黒丸をつけて更新日付が変わる毎に更新日付を出力します。

:|
~キャッシュ生存時間はキャッシュをクリアする期限（１時間単位）です。省略時、キャッシュ機能は無効となります。
~第４引数はRSSを取得した日付を表示するかどうかを指定します。1を指定した場合は表示します。省略時は表示しません。
:プラグイン内設定|~

• PLUGIN_SHOWRSS_USAGE　エラー時に表示される使用方法

:備考|
~動作させるためにはPHP の xml extension が必要です。

size

:種別|
~インライン型プラグイン
:重要度|
~★★★☆☆
:書式|
''&size(''
ピクセル数値;
''){''
文字列;
''};''
:概要|
~文字の大きさを指定します。
:引数|
~ピクセル数値には文字の大きさを指定します。
~文字列は文字の大きさを変更する文字列を指定します。
:プラグイン内設定|~

• PLUGIN_SIZE_MAX　引数として指定可能な最大文字サイズ
• PLUGIN_SIZE_MIN　引数として指定可能な最小文字サイズ
• PLUGIN_SIZE_USAGE　引数未指定時に表示されるヘルプ

source

:種別|
~コマンド
:重要度|
~★☆☆☆☆
:書式|
''?cmd=source''
&page=ページ名;
:概要|
~指定したページの整形前のソースを表示します。
:引数|
~ページ名にはソースを表示するページ名を指定します。ページ名はエンコードされている必要があります。

stationary

:種別|
~コマンド
~ブロック型プラグイン
~インライン型プラグイン
:重要度|
~★☆☆☆☆
:書式|
~''?plugin=stationary''
~''#stationary''
~''&stationary;''
:概要|
~stationaryプラグインはプラグイン作成を試みる人のための雛形として作成されました。~
stationaryプラグインは単純な文字列を表示する以外は何もしません。
:プラグイン内設定|~

• PLUGIN_STATIONARY_MAX　プラグイン内で定数定義を行うサンプル

• ---------------------------

T

tb

:種別|
~コマンド
:重要度|
~★☆☆☆☆
:書式|
''?plugin=tb''
&tb_id=TrackBackID;
&__mode=;
view;|
rss;
:概要|
~TrackBackの一覧を表示します。
~POSTされた場合は他サイトからのTrackBackに反応します。
:引数|
~&tb_idには表示対象ページのTrackBackIDを指定します。
~&__modeには一覧表示方法を指定します。

• view − 人間が見やすい形式で表示します。
• rss − RSS形式で表示します。

:プラグイン内設定|~

• PLUGIN_TB_LANGUAGE　TrackBackのRSSで出力する言語
• PLUGIN_TB_ERROR　エラー時の返り値
• PLUGIN_TB_NOERROR　エラーなし時の返り値

:備考|
~pukiwiki.ini.php で、TrackBackを使用する設定($trackback = 1を指定)が行われている必要があります。

template

:種別|
~コマンド
:重要度|
~★★★★☆
:書式|
''?plugin=template''
&refer=テンプレートページ;
:概要|
~既存のページをテンプレートとしてページを新規作成します。
~ページの新規作成時の雛形とするページの読込み機能との差異は、テンプレートプラグインが雛形とする範囲(行単位)に選択できるのに対して、ページの新規作成で読み込むテンプレートは全文をテキストエリアにコピーする点にあります。
:引数|
~テンプレートページには雛形とするページを指定します。ページ名はエンコードされている必要があります。
:プラグイン内設定|~

• MAX_LEN　雛形の開始／終了位置を指定する欄で表示される最大文字数

topicpath

:種別|
~インライン型プラグイン
~ブロック型プラグイン
:重要度|
~★☆☆☆☆
:書式|
~''&topicpath''
'';''
~''#topicpath''
:概要|
~パンくずリスト(topicpath)と呼ばれる、現在参照しているウェブページの階層を表現するユーザーインターフェースを提供するプラグインです。
~例えば

[[PukiWiki/ツアー]]

というページに#topicpathと書くと、以下の様な表記に置き換わります。

[[Top>FrontPage]] / [[PukiWiki>PukiWiki]] / [[ツアー>PukiWiki/ツアー]]

~基本的には以下の２通りの使い方を想定しています。

1. 「ほげ/ふが/げほ」など、２〜３階層以上の深いページでページの行き来をしやすくするために表示する
2. スキンに組み込み、ページタイトル下のURLの代わりに全てのページで表示する

:プラグイン内設定|~

• PLUGIN_TOPICPATH_TOP_DISPLAY　defaultpageを一番最初に表示するかどうか。
• PLUGIN_TOPICPATH_TOP_LABEL　$defaultpageに対するラベル
• PLUGIN_TOPICPATH_TOP_SEPARATOR　階層を区切るセパレータ
• PLUGIN_TOPICPATH_THIS_PAGE_DISPLAY　現在表示中のページに対するリンクを表示するかどうか
• PLUGIN_TOPICPATH_THIS_PAGE_LINK　現在表示中のページに対してリンクするかどうか

:備考|
~スキンに組み込む場合は、pukiwiki.skin.php の SKIN_DEFAULT_DISABLE_TOPICPATH に 0を指定して下さい。

touchgraph

:種別|
~コマンド
:重要度|
~★☆☆☆☆
:書式|
''?plugin=touchgraph''
:概要|
~TouchGraphWikiBrowser用のインデックスを作ります。

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_LIST_EXCLUDE_PATTERN　tracker_listで表示しないページ名を正規表現で指定する
• TRACKER_LIST_SHOW_ERROR_PAGE　項目の取り出しに失敗したページを一覧に表示するか

:テンプレート|~
~テンプレートは基本的に設置する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] : 最終更新日時からの経過。

tracker_list

:種別|
~（コマンド）
~ブロック型プラグイン
:重要度|
~★★★★☆
:書式|
''#tracker_list(''
[定義名;]
[,[ベースページ名;]
[,[[ソート項目;]
:[ソート順;]]
[,表示上限;]
]]]
'')''
:概要|
~trackerプラグインで作成したページを一覧表示します。
:引数|
~定義名はtrackerプラグインで指定したテンプレート名と同じものを指定します。省略時は :config/plugin/tracker/default が指定されたとみなします。
~ベースページ名はtrackerプラグインで指定したベースページ名と同じものを指定します。trackerプラグインでベースページ名を指定していない場合はtrackerプラグインを設置したページを指定します。省略時は設置したページとなります。
~第３項目には一覧表示のソートに使う項目およびソート順を指定します。ソート項目は :config/plugin/tracker/テンプレート名 のfield項目内の項目から選択して下さい。省略時はページ名となります。ソート順は、ASC((昇順固定))、DESC((降順固定))、SORT_ASC((昇順(閲覧者が変更可) ))、SORT_DESC((降順(閲覧者が変更可) )) をコロン(:)の後に指定してください。また、セミコロン(;)で区切ることにより、複数のソート項目、ソート順を指定可能です。例えば、#tracker_list(,,state:SORT_ASC;priority:SORT_ASC;_real:SORT_DESC) と指定した場合は、項目ごとに (1) [state]を昇順 -> (2) [priority]を昇順 -> (3) [_real](実際のページ名)を降順、の優先順位でソートします。
~表示上限は一覧表示するページ数の上限を指定します。省略時は全て表示されます。

• ---------------------------

U

unfreeze

:種別|
~コマンド
:重要度|
~★★★☆☆
:書式|
''?plugin=unfreeze''
&page=ページ名;
:概要|
~ページの凍結を解除します。
:引数|
~ページ名には解除するページ名を指定します。ページ名はエンコードされている必要があります。
:プラグイン内設定|~

• PLUGIN_UNFREEZE_EDIT　凍結解除時にページの編集フォームを表示するか

update_entities

:種別|
~コマンド
:重要度|
~★☆☆☆☆
:書式|
''?plugin=update_entities''
:概要|
~CACHE_DIR/entities.dat を生成します。
~entities.datはHTMLの実体参照を判定するために用いられるテーブルを格納したファイルです。普通、利用者や管理者が意識する機会はありません。
:プラグイン内設定|~

• W3C_XHTML_DTD_LOCATION　DTDの場所

:備考|
~配布ファイルに生成済のentities.datが付属するため、通常使用する機会はありません。