Block type
Inline type
**
#online
&online;
Display the approximate number of the current visitors to the wiki.
The visitors are determined by recording the IP addresses and timestamps, and counting the number of unique accesses within the past 5 minutes (by default).
The visitors are counted throughout the entire wiki, not per page, so it makes more sense to place this plugin in the MenuBar, the skin, etc.
(Command type)
Block type
*
Upload and display the image drawn by the Java applet. This plugin requires BBSPainter.jar distributed at this website. (The site is written in Japanese only. Just look for the link to bbspainter_120.zip and download it. Put the BBSPainter.jar file in the directory where PukiWiki is installed.)
width and height are the default campus size. By default, (80,60) is used.
Put the BBSPainter.jar file in the directory where PukiWiki is installed. Otherwise this plugin does not work.
(Command type)
Block type
***
Record comments on a separate page. It can display only the recent comments on the place the plugin is placed, or it can display a radio button to specify where to display the comment.
CommentPage - the page to record comments. If omitted, the page specified by the PLUGIN_PCOMMENT_PAGE constant is used. The default value is [Comment/(current page name)]. If the specified page does not exist, it will be created when the first comment is posted.
num_items - the number of top-level items to be displayed. If omitted, the default value specified by the PLUGIN_PCOMMENT_NUM_COMMENTS constant is used.
This parameter must be placed after the comment page name. If you don't want to specify CommentPage, just put a camma before num_items (e.g., #pcomment(,15))
noname,nodate,above,below,reply - parameters to specify how to enter/display the comments
When there is a conflict (i.e., multiple comments were posted at the same time), the comment is displayed at the top or at the bottom (according to the setting) even if the radio button is checked. This is to prevent the comment from being inserted to a strange place.
When a comment is posted, the plugin displays the message indicating that the page where the plugin is placed has been updated. However, it is the comment page that has been actually updated.
Since the page containing #pcomment is not updated, it doesn't show up on the "recent changes" page.
Avoid using a relative reference (e.g. [ [../] ]) in comments, as it may not be converted as expected. (Keep in mind that the page in which you are writing comment is different from the page that will display it.)
The logging of the old comments is invoked when the number of comments reached to (PLUGIN_PCOMMENT_AUTO_LOG + PLUGIN_PCOMMENT_NUM_COMMENTS).
Block type
**
The list of frequently visited pages
num_pages - the number of pages to be displayed. The default value is defined as the PLUGIN_POPULAR_DEFAULT constant.
ExcludedPage - the regular expression that definees the pages which should be excluded from the list. The typical examples are FrontPage, MenuBar, etc.
true, false - whether to use the number of today's visitors only. The default is false.
Since this plugin depends on the information recorded by the counter plugin, the page without the counter plugin is excluded from the list. A simple way to ensure that all pages are counted is to put the plugin in the Menubar or the skin.
(Command type)
Block type
*
Display the link to a randomly selected page.
The pages to be selected from are those under the page where the plugin is placed.
string the message string displayed on the link. The default value is 'press here.'
When the page is reloaded, a different random link is displayed.
Command type
*****
Display the specified page. If the page doesn't exist, it will be opened in the edit mode. If the page name is an InterWiki, the plugin will resolve it.
This plugin is internally used when plugin= and cmd= are not specified. Users usually don't have to use it explicitly.
PageName - the page name to be displayed. This must be URL-encoded.
Block type
*****
最近更新されたページのうち、最新の数件を表示します。
件数には表示件数を指定します。省略時はConstantsで指定した値です。
Block type
Inline type
****
#ref( 添付ファイル名| PageName/添付ファイル名| URL [,PageName] {, [left|center|right], [wrap|nowrap], [around], [noicon], [noimg], [nolink], [zoom], [999x999], [999%] } [,タイトル] )
&ref( 添付ファイル名| PageName/添付ファイル名| URL [,PageName] {, [noicon], [noimg], [nolink], [zoom], [999x999], [999%] } [,タイトル] );
'#attach'でページに添付されたファイルを指定位置に展開します。添付ファイルが画像の場合は画像を表示し、それ以外の場合はダウンロード用のリンクを表示します。
添付ファイル名にはページに添付したファイル名を指定します(省略時はエラーとなります)。別PageName/添付ファイル名とする事で別ページの添付ファイルも指定できます。
PageNameにはファイルを添付したページをWikiNameかBracketNameで指定します。このオプションは最初(添付ファイル名の次)に記述してください。省略時は設置したページです。
パラメータにはファイルの展開方法を指定できます。
aroundで行った回り込み指定を解除するには clearプラグイン、あるいはimgプラグインを使用して下さい。
"ほげ"という別ページの添付ファイル"fuga.jpg"をインラインプラグイン形式で参照する場合、下記2通りの記述方法が存在します。
(1) &ref(ほげ/fuga.jpg); (2) &ref(fuga.jpg,[[ほげ]]);
上記2通りの記述のうち、(2)の記述方式は旧バージョンと互換性を維持するために用意されたもので、推奨される記述方式は(1)です。
いずれの記述方法であっても一般的な動作は同じですが、いわゆるバナー画像のように表示した画像が別ページへのリンクとなるよう以下の指定をした場合、
(1) [[&ref(ほげ/fuga.jpg,nolink,ウェブ名);>ウェブのURL]] (2) [[&ref(fuga.jpg,[[ほげ]],nolink,ウェブ名);>ウェブのURL]](1)の記述方法は期待通りの動作をしますが、(2)の記述方法ではうまくリンクされません。
(3) &ref(./fuga.jpg,50%); (4) &ref(ほげ/fuga.jpg,50%); (5) &ref(fuga.jpg,[[ほげ]],50%); (6) &ref(fuga.jpg,50%);(3)~(5)は期待通りに同じ結果をしますが、(6)はエラーとなります。 これは(6)のSynopsisが(2)の記述方式であるため、 添付ファイル名fuga.jpgの次のParametersにPageNameを期待するためです。
(7) &ref(fuga.jpg);(7)は(6)と似た記述ですが、添付ファイル名の次のParametersが省略されているため、エラーにはなりません。
Command type
***
ページを照会した利用者の参照元URL(Referer)の一覧を表示します。
PageNameにはRefererを表示するPageNameを指定します。PageNameはエンコードされている必要があります。省略時はRefererが記録されているページの一覧を表示します。
sortでReferer一覧のソート順を指定します。
pukiwiki.ini.php で、Refererを使用する設定($referer = 1を指定)が行われている必要があります。
Command type
擬似Block type
***
?plugin=related [&page=PageName]
#related
対象のページを参照しているページの一覧を表示します。
ブロック型で実行時、設置したページが対象となります。
Command typeで実行時、PageNameに対象となるページを指定できます。省略した場合、トップページが指定されたとみなします。
Command type
***
既存ページの名前を変更します。実行には管理者権限が必要です。
ページの本文のほか、指定されたPageNameの差分、バックアップ、添付ファイル、カウンターを一気にリネームします。
PageNameには変更するページの名前を指定します。省略時はPageNameの選択または正規表現置換用文字列入力画面が表示されます。
実行結果は変換結果のページ(PLUGIN_RENAME_LOGPAGE で指定。標準は :RenameLog)に追記されます。
ページ内のリンクの書き換えは行ないません。yetlistなどを駆使して対処してください。
TrackBackやRefererの情報は更新されません。
リネーム対象のページが凍結されているかどうかはチェックしていません。
関連ページにリネーム対象の文字列が複数含まれているとおかしくなります。
Command type
*
?plugin=rss [&ver=0.91| 1.0| 2.0]
RecentChangesをRSSに変換して出力します。
verで出力するRSSを指定します。省略時は0.91を出力します。
RSSはサイトの要約を配信するために使われるXMLフォーマットです。RSS 1.0はRDF(Resource Description Framework)にもとづいたRSS 0.9の後継フォーマットです。RSS 0.91は RDFにもとづかないRSSの実装で、RSS 2.0は RSS 0.91および 0.92の後継フォーマットです。RSSという頭字語が何の略であるかは、それぞれ異なります。
RSS 0.9および1.0: RDF Site Summary
RSS 0.91および0.92: Rich Site Summary
RSS 2.0: Really Simple Syndication
Command type
*
?cmd=rss10
RecentChangesをRSS(RDF Site Summary)1.0に変換して出力します。
rss10プラグインの機能はrssプラグインにマージされたため、 このプラグインは過去との互換性のためにのみ存在しています。 (将来的に削除される可能性があります)
このプラグインにアクセスすると、HTTPステータス・コード 301 (Moved Permanently)とともに、ver=1.0オプションを指定したrssプラグイン のURIへリダイレクトされます。
Inline type
*
文字列にルビをふります。
ルビには表示するルビを指定します。
対象文字列にはルビがふられる文字列を指定します。
XHTML 1.1のルビに対応したブラウザでないと、ルビとして表示されません。IE5.5/6では表示できます。Netscape 7/MozillaではXHTML Ruby Supportを組み込めば表示できます。
ルビに対応していないブラウザではルビをふる文字列の直後にルビが( )に入れられて表示されます。