*plugin memo [#k7e18c20]
-ちょっとPlus!に書き込まれていた記事をコピペ (^Q^
|プラグイン|既定される関数名|型|戻り値|h
|プラグイン初期化|function plugin_XXX_init()|void||
|ブロック型|function plugin_XXX_convert()|string|本文|
|インライン型|function plugin_XXX_inline()|string|本文|
|アクション|function plugin_XXX_action()|array|'msg'=>'タイトル','body'=>'本文'|
----
>PukiWiki公式より
#lsx
#contentsx
*** Plugin開発者向け、主な内部関数 [#dfc0bf7e]
|関数|内容|h
|func_get_args()|引数で定義したオプションを配列へ格納できます([0]～[n])|
|func_num_args()|渡された引数の数を求めることができます|
|get_source($page)|ページの内容をソース状態で取得|
|is_editable($page)|ページが編集可能かどうか|
|is_page($page,$reload=FALSE)|ページが存在するかどうか。$page がページ名かどうかのチェックはなさげ。|
|is_pagename($str)|文字列がページ名かどうか|
|make_pagelink($page,$alias='',$anchor='',$refer='')|ページへのリンクを作成|
|strip_bracket($str)|[[ や ]] で囲まれたページ名から、Bracket部分を取り除く|
*** 値をglobal（グローバル変数）で定義して取得できる変数 [#e04e9870]
|$script|スクリプト名、ここなら（http://taru.s223.com/index.php）|
|$get|GETメソッドによるHTTPからの引数 ※$varsの使用を推奨します|
|$post|POSTメソッドによるHTTPからの引数 ※$varsの使用を推奨します|
|$vars|GET・POST両方のメソッドによるHTTPからの引数|
|$vars["page"]|開いているページ名|
***plugin実行関数 [#u29f985e]
&include_in(PukiWiki/function,notitle,plugin.php);
***アクセス制御用の関数仕様 [#d1f02f47]
-check_readable($page, $auth_flag=true, $exit_flag=true)
>
--閲覧することができるかチェックする。
--今のところread_authと全く同じ。内部でread_authのみを呼び出している。
-check_editable($page, $auth_flag=true, $exit_flag=true)
>
--編集することができるかチェックする。
--edit_auth＋凍結などのチェックをする場合。
-read_auth($page, $auth_flag=true, $exit_flag=true)
>
--閲覧権限があるかチェックする。
-edit_auth($page, $auth_flag=true, $exit_flag=true)
>
--編集権限があるかチェックする。
~
|引数 |説明|h
|$page |ページ名文字列|
|$auth_flag |true: 現在のログイン状態で認証NGであれば、BASIC認証発動(デフォルト)|
|~ |false:現在のログイン状態で判断するだけ|
|~|false:現在のログイン状態で判断するだけ|
|$exit_flag |true: 認証NGの場合、check_xxxable関数側でNG画面に遷移する(デフォルト)|
|~ |false:認証NGの場合でも、戻り値falseで戻ってくるだけ|
|~|false:認証NGの場合でも、戻り値falseで戻ってくるだけ|
~
|戻り値 |true: 認証OK|
|~ |false:認証NG|
|~|false:認証NG|
-get_source, file関数を使用している全てのプラグインで、
以下の関数による事前チェックを行うように改造しなければ、
そこが''セキュリティホール''になるので注意！！
-使わないプラグインはpukiwiki/plugin/disableディレクトリを作って
そこに入れておくなどして、無効化すると良い。
-check_xxxxable系とxxx_auth系の使い分けは、特に問題がなければ、総合的な
観点で読めるか書けるかを判断しているcheck_xxxx系の方を利用する方がよいと思う。
-第2、第3引数のデフォルト値は既存プラグインとの互換性のために用意している。
今後プラグインを実装する場合は明示的に指定した方がよいと思う。
***関数名・グローバル変数名(案) [#f770bee3]
プラグインは、PukiWiki 配下で稼動するため、本体に影響を及ぼさないために、
関数名およびグローバル変数名の命名には、注意が必要となる。
プラグイン内で利用するプライベート関数であっても、プラグインを開発する
際には、無用な混乱や、今後の本体開発・プラグイン開発の負荷を軽減する上でも、
これら命名には、プラグイン名をプレフィックスとして付加することを推奨する。
１つの PHP のシステムとしては、命名規則を明確に定めないと、これら名前においては、
コンフリクトし、稼動しないこととなる。
-非互換ついでに、PukiWiki/1.4でプラグインをクラス化してしまおうかと考えています。
class Plugin_xxx {
var $... /* define()していた定数やその他の変数など */
function Plugin_xxx() { /* plugin_xxx_init() */ }
function action() { /* plugin_xxx_action() */ }
function convert() { /* plugin_xxx_convert() */ }
function inline() { /* plugin_xxx_inline() */ }
こうしておけば名前空間が独立するので、本体とのしがらみを多少軽減できるかな、と。 -- [[ぱんだ]] SIZE(10){2003-02-24 (月) 18:39:59}
![[PukiWiki]](wiki/image/dog3.png "[PukiWiki]")