OSDN Git Service

applied 3.2 modification
[nucleus-jp/nucleus-jp-ancient.git] / utf8 / nucleus / documentation / devdocs / plugins.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
2 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja-JP" xml:lang="ja-JP">\r
3 <head>\r
4         <!-- $Id: plugins.html,v 1.6 2005-03-19 08:39:53 kimitake Exp $ -->\r
5         <!-- $NucleusJP: plugins.html,v 1.5 2005/03/19 08:34:53 kimitake Exp $ -->\r
6         <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
7         <title>Nucleus - プラグイン API</title>\r
8         <link rel="stylesheet" type="text/css" href="styles/manual.css" />\r
9         <style type="text/css">\r
10                 /* refence parameters (greenish) */\r
11                 .ref {\r
12                         background-color: #afa; \r
13                         color: #000;\r
14                 }\r
15                 \r
16                 /* object parameters */\r
17                 .obj {\r
18                         color: #00f;\r
19                 }\r
20                 .obj:after {\r
21                         content: " (object)";\r
22                 }\r
23                 \r
24                 /* read-only parameters (non-ref; reddish) */\r
25                 .ro {\r
26                         background-color: #faa;\r
27                         color: #000;\r
28                 }\r
29         </style>\r
30 </head>\r
31 <body>\r
32 \r
33 <p class="heading">&nbsp;</p>\r
34 <div class="heading">\r
35 プラグイン API\r
36 <i>2005年3月5日</i>\r
37 </div>\r
38 \r
39 <div class="note-trans"><strong>訳者注:</strong> \r
40         <ul>\r
41                 <li>このドキュメントの原文は以下のURLにあります。<br />\r
42                  <a href="http://nucleuscms.org/documentation/devdocs/plugins.html">http://nucleuscms.org/documentation/devdocs/plugins.html</a></li>\r
43             <li>誤訳にお気づきの方は<a href="http://japan.nucleuscms.org/bb/viewforum.php?f=7">こちら</a>へご連絡いただけると助かります。</li>\r
44         </ul>\r
45 </div>\r
46 \r
47 <div class="note"><strong>注:</strong> \r
48         <ul>\r
49                 <li>このドキュメントは基本的なプラグインの書き方についての情報を提供しています。さらに質問がある方は <a href="http://forum.nucleuscms.org/viewforum.php?f=10">Plugin\r
50           Development Forum</a> (<a href="http://japan.nucleuscms.org/bb/viewforum.php?f=5">日本語フォーラム</a>)をご覧ください。</li>\r
51                 <li>Nucleusバージョン1.5以降に導入されたメソッドとイベントには、導入時のバージョン情報を付記しています。それらの機能を利用するときは、<code>getMinNucleusVersion</code> を適切に設定するのを忘れないでください。</li>\r
52         </ul>\r
53 </div>\r
54 \r
55 <h1>はじめに</h1>\r
56 \r
57 <p>\r
58 <a href="./index.html">開発者向けドキュメントの目次へ戻る</a>\r
59 </p>\r
60 \r
61 <p>\r
62 このドキュメントはNucleusプラグインの作り方についての解説です。 \r
63 </p>\r
64 \r
65 <h1><a name="toc"></a><a name="top"></a>目次</h1>\r
66 \r
67 <ul>\r
68         <li><a href="#introduction">イントロダクション</a></li>\r
69         <li><a href="#firstplug">はじめてプラグインを書いてみる</a></li>\r
70         <li><a href="#nucleusplugin"><code>NucleusPlugin</code> クラスの概要</a></li>\r
71         <li><a href="#skinvars"><code>&lt;%plugin(...)%&gt;</code> スキン変数</a></li>\r
72         <li><a href="#templatevars"><code>&lt;%plugin(...)%&gt;</code> テンプレート変数</a></li>        \r
73         <li><a href="#actions"><code>action.php</code> を使ったアクション</a></li>\r
74         <li><a href="#events">イベントとイベント登録の仕方</a></li>\r
75         <li><a href="#options">オプションを保存する</a></li>\r
76         <li><a href="#tables">データベース・テーブル</a></li>\r
77         <li><a href="#admin">プラグイン管理エリアの提供</a></li>\r
78         <li><a href="#help">ヘルプページの提供</a></li>\r
79         <li><a href="#dependency">プラグイン依存チェック</a></li>\r
80 <!--    <li><a href="#parser">Using the <code>PARSER</code> class</a></li>\r
81         <li><a href="#"></a></li>\r
82         <li><a href="#"></a></li>\r
83         <li><a href="#"></a></li>\r
84         <li><a href="#"></a></li>-->\r
85 </ul>\r
86 \r
87 <h1>イントロダクション <a name="introduction" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
88 \r
89 <p>\r
90 Nucleusプラグインによって、誰もがNucleusの提供する機能を、Nucleus内部のPHPコードを変更することなく拡張することができます。プラグインはあるメソッドを実装したシンプルなPHPスクリプトで、Nucleusユーザー同士で簡単に交換することができます。インストールは簡単で、プラグインディレクトリにファイルをアップし、Nucleusにそれを認識させるだけです。\r
91 </p>\r
92 \r
93 <p>\r
94 プラグインの利点は以下のとおりです。</p>\r
95 \r
96 <ul>\r
97         <li>実装について詳しくしらなくてもNucleusフレームワークに簡単に機能を追加できる</li>\r
98         <li>必要なプラグインだけをインストールでき、ページ生成にかかる時間を節約できる</li>\r
99 </ul>\r
100 \r
101 <p>\r
102 すべてのプラグインファイルは <code>config.php</code> に記述されたディレクトリに置く必要があります。一般的に、それは <code>/your/path/nucleus/plugins/</code>  になるでしょう。プラグインファイル名は <code>NP<i>_name</i>.php</code> という形式を用いることにより認識されます。プラグインによっては、追加ファイルを格納する同名のサブディレクトリや、管理エリアを必要とします。</p>\r
103 \r
104 <div class="note">\r
105 <b>注:</b> プラグイン名は大文字・小文字を識別しますので、<code>Np_</code> や <code>np_</code> ではなく、<code>NP_</code> で始まることに気をつけてください。またプラグインがサブディレクトリを使用する場合は、サブディレクトリの名称は<em>すべて小文字にします</em>。</div>\r
106 \r
107 \r
108 \r
109 \r
110 <h1>はじめてプラグインを書いてみる<a name="firstplug" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
111 \r
112 <p>\r
113 では、シンプルなプラグインを書いてみましょう。基本的にプラグインは、あらかじめ定義された <code>NucleusPlugin</code> クラスを継承したPHPクラスです。以下は<code>HelloWorld</code>プラグインの例です。</p>\r
114 \r
115 <pre class="example"><code>&lt;?\r
116 \r
117 class NP_HelloWorld extends NucleusPlugin {\r
118 \r
119         // プラグインの名前\r
120         function getName() {\r
121                 return 'Hello World'; \r
122         }\r
123         \r
124         // プラグインの作者\r
125         function getAuthor()  { \r
126                 return 'Wouter Demuynck'; \r
127         }\r
128         \r
129         // プラグインのサイトURL\r
130         // mailto:foo@bar.com の形式も可\r
131         function getURL() \r
132         {\r
133                 return '../../index.html'; \r
134         }\r
135         \r
136         // プラグインのバージョン\r
137         function getVersion() {\r
138                 return '1.0'; \r
139         }\r
140         \r
141         // インストール済みのプラグインリストに表示される説明文\r
142         function getDescription() { \r
143                 return 'Just a sample plugin.';\r
144         }\r
145 \r
146         function doSkinVar($skinType) {\r
147                 echo 'Hello World!';\r
148         }\r
149         \r
150 }\r
151 ?&gt;</pre>\r
152 \r
153 <ol>\r
154         <li>\r
155                 このコードをコピーし、 <code>NP_HelloWorld.php</code> と名づけて保存し、プラグインディレクトリに置きます。<em>最後の <code>?&gt;</code> の後や、最初の <code>&lt;?</code> の前にスペースがないことを確認しましょう</em>。ところでNP は &quot;Nucleus Plugin&quot; って意味ですよ :-)\r
156         </li>\r
157         <li>Nucleusの管理画面を開き、<em>Nucleusの管理>プラグインの管理</em>にいきます。</li>\r
158         <li><em>HelloWorld</em> プラグインがインストール可能な状態になっているはずですので、インストールします。すべてがうまくいけば、インストール済みプラグインリストに追加されます。</li>\r
159         <li>スキンを編集し、実際のページに表示する箇所に次の文を挿入します。\r
160           <pre class="example"><code>&lt;%plugin(HelloWorld)%&gt;</code></pre>\r
161         注意:カッコ内の名称 (HelloWorld) は大文字小文字を識別します!</li>\r
162         <li>さて、編集したスキンから生成されるページを見てみましょう。プラグイン変数を追加した場所に &quot;Hello\r
163   World&quot; と見えますね?</li>\r
164 </ol>\r
165 \r
166 <p>ここまではそれほど難しくなかったと思います。さらに読み進めて理解してください。</p>\r
167 \r
168 \r
169 <h1>NucleusPlugin クラスの概要 <a name="nucleusplugin" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
170 \r
171 <p>すべてのプラグインは、<code>NucleusPlugin</code> というPHPクラスを継承しなければなりません。難しそうに聞こえても心配ご無用、大丈夫です。このPHPクラスの継承によって、プラグインに必要なメソッドだけを実装でき、いくつかの補助ファンクションにアクセスでき、つまりはあなたの人生はよりラクになります。</p>\r
172 \r
173 <p>下記は <code>NucleusPlugin</code> が提供する、再実装可能なメソッドの概要です。このクラス自身のソースコードを見たければ、<code>nucleus/libs/PLUGIN.php</code>にあります。</p>\r
174 \r
175 <table summary="An overview of the redefinable methods in the class NucleusPlugin">\r
176         <caption>\r
177         <code>NucleusPlugin</code> クラスの概要(再定義可能なメソッド)\r
178         </caption>\r
179         <tr>\r
180                 <th>メソッド名</th><th>説明</th>\r
181         </tr>\r
182         <tr>\r
183                 <td><code>getName()</code></td>\r
184                 <td>プラグイン名を返します。インストール済みプラグインリストに表示されます。デフォルトの実装では <code>Undefined</code> を返すため、必ず再定義されないといけません。</td>           \r
185         </tr>\r
186         <tr>\r
187                 <td><code>getAuthor()</code></td>\r
188                 <td>プラグインの作者名を返します。インストール済みプラグインリストに表示されます。デフォルトの実装では <code>Undefined</code> を返すため、必ず再定義されないといけません。</td>          \r
189         </tr>\r
190         <tr>\r
191                 <td><code>getURL()</code></td>\r
192                 <td>プラグインをダウンロード可能な、またはプラグインの追加情報のあるサイトのURLを返します。そのようなサイトがない場合は作者のメールアドレスへの mailto:リンクが適切です。デフォルトの実装では <code>Undefined</code> を返すため、必ず再定義されないといけません。</td>             \r
193         </tr>\r
194         <tr>\r
195                 <td><code>getDescription()</code></td>\r
196                 <td>プラグインに関する説明文(長文)を返します。インストール済みプラグインリストに表示されます。デフォルトの実装では <code>Undefined</code> を返します。</td>             \r
197         </tr>\r
198         <tr>\r
199                 <td><code>getVersion()</code></td>\r
200                 <td>プラグインの現在のバージョンを返します。デフォルトは <code>0.0</code> を返します。</td>             \r
201         </tr>\r
202         <tr>\r
203                 <td><code>getMinNucleusVersion()</code></td>\r
204                 <td>(v2.0b) 最低限必要なNucleusのバージョンを返します。デフォルトは <code>155</code> (v1.55)を返します。後に導入されたプラグイン関連機能を利用している場合は、このファンクションを実装するようお願いします(例: v2.0 => 200)。ただし、Nucleus v1.55 はこのファンクションを使用しないため、新機能を利用したプラグインが(対応する前のシステムに)インストールされる可能性が残っています。</td>\r
205         </tr>\r
206         <tr>\r
207                 <td><code>getMinNucleusPatchLevel()</code></td>\r
208                 <td>(v3.1) 最低限必要なNucleusのバージョン(<code>getMinNucleusVersion</code>)での、最低限必要なパッチレベルを返します。デフォルトは <code>0</code> を返します。このファンクションは主に新しいプラグインの機能がNucleusの最新版のパッチによって可能になる場合に用いられます。</td>\r
209         </tr>\r
210         <tr>\r
211                 <td><code>init()</code></td>\r
212                 <td>プラグインを初期化します。このメソッドはプラグインオブジェクトが生成された直後に呼び出され、<code>plugid</code>属性がセットされます。デフォルトではこのメソッドは何もしません。</td>\r
213         </tr>\r
214         <tr>\r
215                 <td><code>doSkinVar($skinType)</code></td>\r
216                 <td><code>&lt;%plugin(...)%&gt;</code> スキン変数によってプラグインが呼び出されたときにこのメソッドが呼ばれます。<code>$skinType</code> パラメータはプラグインが呼ばれた場所のスキンタイプに該当します(<code>item</code>,\r
217       <code>archive</code>, ...)。パラメータが一つしかないことに混乱しないでください。複数パラメータを渡すことも<strong>可能</strong>です。<a href="#skinvars"><code>doSkinVar</code> メソッドの実装に関する詳細情報はこちら</a>。デフォルトではこのメソッドはなにも出力しません。</td>              \r
218         </tr>\r
219         <tr>\r
220                 <td><code>doTemplateVar(&amp;$item)</code></td>\r
221                 <td>基本的に <code>doSkinVar</code> と同じですが、今度は<em>テンプレート</em>内(<code>item\r
222                     header/body/footer</code> と <code>dateheader/footer</code>)での<code>&lt;%plugin(...)%&gt;</code> 変数からの呼び出しになります。デフォルトではこのメソッドはテンプレートをスキンタイプとみなして\r
223       <code>doSkinVar</code> メソッドに処理を渡します。<a href="#templatevars"><code>doTemplateVar</code> メソッドの実装に関する詳細情報はこちら</a></td>               \r
224         </tr>\r
225         <tr>\r
226                 <td><code>doTemplateCommentsVar(&amp;$item, &amp;$comment)</code></td>\r
227                 <td>(v2.0b) 基本的に <code>doSkinVar</code> と同じですが、今度は<em>テンプレート</em>内(コメント部分)での<code>&lt;%plugin(...)%&gt;</code> 変数からの呼び出しになります。デフォルトではこのメソッドはテンプレートをスキンタイプとみなして\r
228       <code>doSkinVar</code> メソッドに処理を渡します。<a href="#templatevars"><code>doTemplateCommentsVar</code> \r
229       メソッドの実装に関する詳細情報はこちら</a></td>                \r
230         </tr>   \r
231         <tr>\r
232                 <td><code>doAction($type)</code></td>\r
233                 <td>プラグインがユーザーインタラクションを求めたとき、 <code>action.php</code>を介してこのメソッドがそれを与えます。.\r
234                   これはNucleus自身が新しいコメントや投票を処理するのに使用するスクリプトです。正しいパラメータを用いることで、プラグインからの\r
235                   <code>doAction</code> メソッドを呼び出せます。<code>$type</code> はオプションのメッセージタイプに該当します。<code>doAction</code> メソッド内で、リクエストからの追加の変数にアクセスできます。デフォルトではこのメソッドがエラーメッセージをトリガーすると<code>'No\r
236           Such Action'</code>という文字列を返します。<a href="#actions"><code>doAction</code> に関する詳細情報はこちら</a></td>         \r
237         </tr>\r
238         <tr>\r
239                 <td><code>install()</code></td>\r
240                 <td>このメソッドはプラグインがインストールされた際に呼ばれます。データベース・テーブルの生成やプラグインオプションの生成などの初期化作業を行うことができます。デフォルトではこのメソッドは何もしません。</td>\r
241         </tr>\r
242         <tr>\r
243                 <td><code>unInstall()</code></td>\r
244                 <td>プラグインがアンインストールされた際に呼ばれます。この時点でデータベースに作られたプラグイン情報を消去すると良いです。デフォルトではこのメソッドは何もしません。</td>\r
245         </tr>\r
246         <tr>\r
247                 <td><code>getEventList()</code></td>\r
248                 <td>プラグインはイベント登録が可能です。イベントはNucleusが何かアクションを起こすたびに生成されます。たとえば、<code>AddItem</code> イベントは、このイベントを登録しているすべてのプラグインを呼び出します。呼び出されるメソッドは <code>event_AddItem($params)</code>になります。 <code>$params</code> パラメータは、例えば <code>AddItem</code>        の <code>itemid</code> のような、情報フィールドを複数持つ連想配列です。デフォルトではどのイベントにも登録されていないことを示す空の配列を返します。<a href="#events">イベントに関する詳細情報\r
249           はこちら</a></td>         \r
250         </tr>\r
251         <tr>\r
252                 <td><code>getTableList()</code></td>\r
253                 <td>このメソッドはプラグインが生成したデータベース・テーブルの配列を返します。これはNucleusが提供するバックアップ機能で利用されるので、プラグインテーブルをバックアップに含めることができます。デフォルトでは空の配列を返します。</td>\r
254         </tr>\r
255         <tr>\r
256                 <td><code>hasAdminArea()</code></td>\r
257                 <td>プラグインが独自の管理エリアをもつ場合 1 を、そうでない場合 0 を返します。デフォルトでは <code>0</code> を返します。</td>\r
258         </tr>\r
259         <tr>\r
260                 <td><code>getPluginDep()</code></td>\r
261                 <td>(v3.2) プラグイン名の配列を返します。Nucleusはこれらのプラグインが前もってインストールされてない場合、プラグインのインストールを拒否します。デフォルトでは空の配列が返されます。<a href="#dependency">プラグイン依存に関する詳細情報はこちら</a></td>\r
262         </tr>\r
263 </table>\r
264 \r
265 <p>実装可能なメソッドの次は、<code>NucleusPlugin</code> クラスが提供する、再実装<strong>すべきでない</strong>幾つかの特殊メソッドです。これらはプラグイン内で、<code>$this-&gt;functionName()</code>シンタックスを利用して呼び出します。</p>\r
266 \r
267 <table summary="An overview of the auxiliary methods in the class NucleusPlugin. You should NOT redefine these">\r
268         <caption>\r
269         <code>NucleusPlugin</code> クラスの概要(再定義不可能なメソッド)\r
270         </caption>\r
271         <tr>\r
272                 <th>メソッド名</th>\r
273                 <th>説明</th>\r
274         </tr>\r
275         <tr>\r
276                 <td>\r
277                         <code>createOption(...)</code>\r
278                         <br /><code>createBlogOption(...)</code>(v2.2)\r
279                         <br /><code>createCategoryOption(...)</code>(v2.2)\r
280                         <br /><code>createMemberOption(...)</code>(v2.2)\r
281                         <br /><code>createItemOption(...)</code>(v3.2)\r
282                 </td>\r
283                 <td><a href="#options" title="More info on options">新しいオプションを生成します。</a></td>              \r
284         </tr>\r
285         <tr>\r
286                 <td>\r
287                         <code>deleteOption(...)</code>\r
288                         <br /><code>deleteBlogOption(...)</code>(v2.2)\r
289                         <br /><code>deleteCategoryOption(...)</code>(v2.2)\r
290                         <br /><code>deleteMemberOption(...)</code>(v2.2)\r
291                         <br /><code>deleteItemOption(...)</code>(v3.2)\r
292                 </td>\r
293                 <td><a href="#options" title="More info on options">オプションを削除します。</a></td>               \r
294         </tr>\r
295         <tr>\r
296                 <td>\r
297                         <code>setOption(...)</code>\r
298                         <br /><code>setBlogOption(...)</code>(v2.2)\r
299                         <br /><code>setCategoryOption(...)</code>(v2.2)\r
300                         <br /><code>setMemberOption(...)</code>(v2.2)                         \r
301                         <br /><code>setItemOption(...)</code>(v3.2)\r
302                 </td>\r
303                 <td><a href="#options" title="More info on options">オプションに値をセットします。</a></td>              \r
304         </tr>\r
305         <tr>\r
306                 <td>\r
307                         <code>getOption(...)</code>\r
308                         <br /><code>getBlogOption(...)</code>(v2.2)\r
309                         <br /><code>getCategoryOption(...)</code>(v2.2)\r
310                         <br /><code>getMemberOption(...)</code>(v2.2)                          \r
311                         <br /><code>getItemOption(...)</code>(v3.2)\r
312                 </td>\r
313                 <td><a href="#options" title="More info on options">オプションの値を取得します。</a></td>         \r
314         </tr>\r
315         <tr>\r
316                 <td>\r
317                         <code>getAllBlogOptions(...)</code>(v2.2)\r
318                         <br /><code>getAllCategoryOptions(...)</code>(v2.2)\r
319                         <br /><code>getAllMemberOptions(...)</code>(v2.2)                              \r
320                         <br /><code>getAllItemOptions(...)</code>(v3.2)\r
321                 </td>\r
322                 <td><a href="#options" title="More info on options">与えられたオプションにより、すべての値(コンテクストごとの一つの値)の連想配列を返します。</a></td>            \r
323         </tr>   \r
324         <tr>\r
325                 <td>\r
326                         <code>getBlogOptionTop(...)</code>(v3.2)\r
327                         <br /><code>getMemberOptionTop(...)</code>(v3.2)\r
328                         <br /><code>getCategoryOptionTop(...)</code>(v3.2)\r
329           <br /><code>getItemOptionTop(...)</code>(v3.2)\r
330                 </td>\r
331                 <td><a href="#options" title="More info on options">与えられたオプションにより、すべての値のうちの最初の値を返します。</a></td>\r
332         </tr>\r
333         <tr>\r
334                 <td><code>getID()</code></td>\r
335                 <td>このプラグインのIDを返します(このIDはNucleus内部で利用されるものです)。</td>               \r
336         </tr>\r
337         <tr>\r
338                 <td><code>getAdminURL()</code></td>\r
339                 <td>プラグインの管理エリアが置かれたURLを返します(そのような管理エリアがない場合は、この情報は無効です)。</td>              \r
340         </tr>\r
341         <tr>\r
342                 <td><code>getDirectory()</code></td>\r
343                 <td>プラグインの追加ファイルが格納されたサーバーのファイルシステムのパスを返します(そのようなファイルがない場合は、この情報は無効です)。結果は&quot;<code>.../nucleus/plugins/<em>plugname</em>/</code>&quot;のようになります。</td>           \r
344         </tr>\r
345         <tr>\r
346                 <td><code>getShortName()</code></td>\r
347                 <td>"NP_"部分を省き、全てを小文字にしたプラグインのクラス名を返します。この情報は <code>getAdminURL</code> と <code>getDirectory</code> で使用されます。</td>              \r
348         </tr>\r
349 \r
350 </table>\r
351 \r
352 <h1>スキン変数<a name="skinvars" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
353 \r
354 <h2>解説</h2>\r
355 \r
356 <p>\r
357 独自のスキン変数を生成し、<code>&lt;%plugin(<em>PlugName,parameters</em>)%&gt;</code> または <code>&lt;%PlugName(parameters)%&gt;</code>で呼び出すことが出来ます(すでに存在するスキン変数とかぶらない場合)。パラメータはカンマ区切りです。</p>\r
358 \r
359 <p>\r
360 スキン変数を扱うには、<code>doSkinVar</code> メソッドを実装する必要があります。いくつかの例を以下に示します。</p>\r
361 \r
362 <pre class="example"><code>function doSkinVar($skinType)\r
363 function doSkinVar($skinType, $param1, $param2)\r
364 function doSkinVar($skinType, $skinVar, $param1, $param2)\r
365 function doSkinVar($skinType, $skinVar, $param1 = 'default value')</code></pre>\r
366 \r
367 <ul>\r
368         <li><code>$skinType</code> パラメータは、'index', 'item', 'archive', 'archivelist', 'member', 'error',\r
369   'search', 'imagepopup',  <a href="#templatevars" title="Information on templatevars">'template'</a>のうちの一つを取ります</li>\r
370         <li><code>$skinVar</code> は、スキン変数のタイプとして解釈される実質的に最初のパラメータになります(例:<code>&lt;%plugin(PlugName,VarType)%&gt;</code>)。</li>\r
371         <li><code>doSkinVar()</code>(パラメータ無し)を使い、PHPファンクションの<code>func_get_args()</code>を用いてパラメータを取得することができます。引数の数の異なる、タイプの違うスキン変数を扱うときに便利です。</li>\r
372 </ul>\r
373 \r
374 <h2>ノート</h2>\r
375 \r
376 <ul>\r
377         <li>(v2.0b) グローバル変数としてパースされている <code>$currentSkinName</code> を使ってスキンの名前を取得できます。</li>\r
378 </ul>\r
379 \r
380 \r
381 \r
382 \r
383 <h1>テンプレート変数<a name="templatevars" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
384 \r
385 <h2>解説</h2>\r
386 \r
387 <p>\r
388 テンプレートプラグイン変数はスキンプラグイン変数と同様に働きますが以下の2点が異なります。</p>\r
389 \r
390 <ol>\r
391         <li>スキン内ではなくテンプレート内から呼ばれます。</li>\r
392         <li>$skinTypeパラメータを取りません。代わりに現在パースされているアイテムやコメントの情報付きの追加パラメータを取ります。\r
393     <ul>\r
394                         <li><code>doTemplateVar</code> メソッドは <code>&amp;$item</code> パラメータを取ります。</li>\r
395                         <li><code>doTemplateCommentsVar</code> メソッドは <code>&amp;$item</code> と <code>&amp;$comment</code> パラメータを取ります。</li>\r
396           </ul>\r
397                 <strong>&amp;マークに注意!</strong>\r
398         </li>\r
399 </ol>\r
400         \r
401 <p>テンプレート変数はスキン変数と同じ要領で呼ばれます(<code>&lt;%plugin(PlugName,parameters)%&gt;</code> または <code>&lt;%PlugName(parameters)%&gt;</code>)。</p>\r
402 \r
403 <p>\r
404 デフォルトでは、全てのテンプレート変数は'<code>template</code>'を<code>skintype</code>パラメータとして、<code>doSkinVar</code> メソッドに渡ります。</p>\r
405 \r
406 <p>\r
407 独自の実装を提供したい場合は、<code>doTemplateVar</code> メソッドや <code>doTemplateCommentsVar</code> メソッドを再定義する必要があります。<code>skintype</code>パラメータが無くなる以外はdoSkinVarと同様に働きます。</p>\r
408 \r
409 <pre class="example"><code>function doTemplateVar(&amp;$item)\r
410 function doTemplateVar(&amp;$item, $param1, $param2)\r
411 function doTemplateVar(&amp;$item, $type, $param1, $param2)\r
412 function doTemplateVar(&amp;$item, $type, $param1 = 'default value')\r
413 function doTemplateCommentsVar(&amp;$item, &amp;$comment)\r
414 function doTemplateCommentsVar(&amp;$item, &amp;$comment, $param1, $param2)\r
415 function doTemplateCommentsVar(&amp;$item, &amp;$comment, $type, $param1, $param2)\r
416 function doTemplateCommentsVar(&amp;$item, &amp;$comment, $type, $param1 = 'default value')</code></pre>\r
417 \r
418 <h2>ノート</h2>\r
419 \r
420 <ul>\r
421         <li>(v2.0b) グローバル変数として内部で利用される <code>$currentSkinName</code> を使ってテンプレートの名前を取得できます。</li>\r
422 </ul>\r
423 \r
424 \r
425 \r
426 \r
427 <h1>アクション<a name="actions" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
428 \r
429 <p>プラグインは <code>action.php</code> を通してアクションを行うことができ、同様のスクリプトがコメントや投票の受け取りにも使用されてます。GETまたはPOSTのどちらかを通して呼び出せます。必要なパラメータは\r
430 <code>action</code>('plugin'と指定)、<code>name</code>(プラグイン名)、<code>type</code>(リクエストされたアクションの種類)です。</p>\r
431 \r
432 <p>これらのアクションを有効にするために、<code>doAction($actionType)</code> メソッドをプラグイン内で実装する必要があります。リクエストからの追加パラメータは\r
433 <code>requestVar('<em>name</em>')</code> で取得できます(<code>requestVar</code> はPHPが付加する magic_quotes_gpc に配慮しています)。</p>\r
434 \r
435 <p>\r
436 <code>doAction</code> メソッドが文字列を返すとき、エラーとして解釈され、エラーメッセージが表示されます。</p>\r
437 \r
438 \r
439 \r
440 \r
441 \r
442 \r
443 <h1>イベント<a name="events" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
444 \r
445 <p>\r
446 Nucleusプラグインはなにか重要なことが起きたときに発生するイベントに登録可能です。プラグインはイベント発生の際にアクションを実行したり、テキストを出力したりできます。</p>\r
447 \r
448 <h2>例</h2>\r
449 \r
450 <p>\r
451 下記は <code>PreAddComment</code> イベント(blogにコメントが追加される直前に生成されるイベント)にプラグインが登録する例です。</p>\r
452 \r
453 <pre class="example"><code>class NP_Acronyms extends NucleusPlugin {\r
454   ...\r
455   function getEventList() { return array('PreAddComment'); }\r
456   ...\r
457   function event_PreAddComment(&amp;$data) {\r
458     // 頭字語 HTML を置き換え\r
459     $data['comment']['body'] = \r
460         strreplace('HTML',\r
461                    '&lt;acronym title="HyperText Markup Language"&gt;HTML&lt;/acronym&gt;',\r
462                    $data['comment']['body']);\r
463   }\r
464 }\r
465 </code></pre>\r
466 \r
467 <p>このプラグインはコメント中の'HTML'というテキストを'<code>&lt;acronym title=&quot;HyperText\r
468 Markup Language&quot;&gt;HTML&lt;/acronym&gt;</code>'に置き換えます。acronymタグはHTMLタグで、頭字語についての追加情報を提供します。</p>\r
469 \r
470 <h2>イベント登録の仕方</h2>\r
471 \r
472 <p>イベント登録に必要なステップは以下になります。</p>\r
473 \r
474 <ol>\r
475         <li><code>getEventList</code> メソッドから返る配列にイベント名を追加します。</li>\r
476         <li><code>event_EventName($data)</code> という形でメソッドを生成し、この中でイベントを処理します。</li>\r
477 </ol>\r
478 \r
479 <p>複数のプラグインが同じイベントに登録できます。管理エリアのプラグインリストの順序に従ってプラグインに通知が行きます。リストの上にあるプラグインほど早く通知されます。</p>\r
480 \r
481 <h2>パラメータ</h2>\r
482 \r
483 <p><code>event_EventName</code> メソッドはひとつだけ <code>$data</code> パラメータを持ち、それはイベントごとに内容が異なります。これは連想配列です。この連想配列に渡されたオブジェクトや配列は<strong>参照形式</strong>で渡されるため、これらに加えた変更は記憶されます。</p>\r
484 \r
485 <p>以下のイベントリストは、パラメータ変更がNucleusに知られるかどうかを示すために色を使い分けています。</p>\r
486 \r
487 <ul>\r
488         <li><var class="ref">参照渡し(緑)</var>: この種のパラメータに変更を加えるとNucleusに知られます。</li>\r
489         <li><var class="ro">値渡し(赤)</var>: プラグインイベントハンドラに渡される前に値がコピーされます。これらの変数への変更は自動的に破棄されます。.</li>\r
490 </ul>\r
491 \r
492 <p>パラメータとして渡されるオブジェクトは<var class="obj">object</var>.として示されます。ほとんどのオブジェクトは参照渡しで、<var class="obj ref">object\r
493 by ref</var>のように示されます。</p>\r
494 \r
495 <h2>イベントリスト</h2>\r
496 \r
497 <table summary="An overview of events to which a Nucleus Plugin can subscribe, and what parameters are passed along to the method that handles the event">\r
498         <caption>\r
499         プラグインが登録できるイベント</caption>\r
500         <tr>\r
501                 <th>名前</th>\r
502                 <th>いつ</th>\r
503                 <th>パラメータ</th>\r
504         </tr>\r
505         <tr>\r
506                 <td>PreSkinParse</td>\r
507                 <td>スキンのパースの直前</td>\r
508                 <td><dl>\r
509                         <dt class="obj ref">skin</dt>\r
510                         <dd>パースする<code>SKIN</code>オブジェクト</dd>\r
511                         <dt class="ro">type</dt>\r
512                         <dd>スキンタイプ('index', 'item', 'archive', 'archivelist',\r
513                   'member', 'error', 'search', 'imagepopup', 'fileparser'のいずれか)</dd>\r
514                 </dl></td>              \r
515         </tr>\r
516         <tr>\r
517                 <td>PostSkinParse</td>\r
518                 <td>スキンのパースの直後</td>\r
519                 <td><dl>\r
520                         <dt class="obj ref">skin</dt>\r
521                         <dd>パースする<code>SKIN</code>オブジェクト</dd>\r
522                         <dt class="ro">type</dt>\r
523                         <dd>スキンタイプ('index', 'item', 'archive', 'archivelist', 'member', 'error', 'search',\r
524                   'imagepopup', 'fileparser'のいずれか)</dd>\r
525                 </dl></td>              \r
526         </tr>\r
527         <tr>\r
528                 <td>PreItem</td>\r
529                 <td>アイテムのパース前、ただしアイテムヘッダーのパース後</td>\r
530                 <td><dl>\r
531                         <dt class="ref obj">blog</dt>\r
532                         <dd><code>BLOG</code> オブジェクト</dd>\r
533                         <dt class="ref obj">item</dt>\r
534                         <dd>アイテムデータを持つオブジェクト</dd>\r
535                 </dl></td>              \r
536         </tr>\r
537         <tr>\r
538                 <td>PostItem</td>\r
539                 <td>アイテムのパース後、ただしアイテムフッターのパース前</td>\r
540                 <td><dl>\r
541                         <dt class="ref obj">blog</dt>\r
542                         <dd><code>BLOG</code> オブジェクト</dd>\r
543                         <dt class="ref obj">item</dt>\r
544                         <dd>アイテムデータを持つオブジェクト</dd>\r
545                 </dl></td>              \r
546         </tr>\r
547         <tr>\r
548                 <td>PreComment</td>\r
549                 <td>コメントの表示前</td>\r
550                 <td><dl>\r
551                         <dt class="ref">comment</dt>\r
552                         <dd>コメントデータを持つ連想配列</dd>\r
553                 </dl></td>              \r
554         </tr>\r
555         <tr>\r
556                 <td>PostComment</td>\r
557                 <td>コメントの表示後</td>\r
558                 <td><dl>\r
559                         <dt class="ref">comment</dt>\r
560                         <dd>コメントデータを持つ連想配列</dd>\r
561                 </dl></td>              \r
562         </tr>\r
563         <tr>\r
564                 <td>PreDateHead</td>\r
565                 <td>日付ヘッダーのパース前</td>\r
566                 <td><dl>\r
567                         <dt class="obj ref">blog</dt>\r
568                         <dd><code>BLOG</code> オブジェクト</dd>\r
569                         <dt class="ro">timestamp</dt>\r
570                         <dd>日付ヘッダーのタイムスタンプ</dd>\r
571                 </dl></td>              \r
572         </tr>\r
573         <tr>\r
574                 <td>PostDateHead</td>\r
575                 <td>日付ヘッダーのパース後</td>\r
576                 <td><dl>\r
577                         <dt class="obj ref">blog</dt>\r
578                         <dd><code>BLOG</code> オブジェクト</dd>\r
579                         <dt class="ro">timestamp</dt>\r
580                         <dd>日付ヘッダーのタイムスタンプ</dd>\r
581                 </dl></td>              \r
582         </tr>\r
583         <tr>\r
584                 <td>PreDateFoot</td>\r
585                 <td>日付フッターのパース前</td>\r
586                 <td><dl>\r
587                         <dt class="ref obj">blog</dt>\r
588                         <dd><code>BLOG</code> オブジェクト</dd>\r
589                         <dt class="ro">timestamp</dt>\r
590                         <dd>日付フッターのタイムスタンプ</dd>\r
591                 </dl></td>              \r
592         </tr>\r
593         <tr>\r
594                 <td>PostDateFoot</td>\r
595                 <td>日付フッターのパース後</td>\r
596                 <td><dl>\r
597                         <dt class="ref obj">blog</dt>\r
598                         <dd><code>BLOG</code> オブジェクト</dd>\r
599                         <dt class="ro">timestamp</dt>\r
600                         <dd>日付フッターのタイムスタンプ</dd>\r
601                 </dl></td>              \r
602         </tr>   \r
603         <tr>\r
604                 <td>LoginSuccess</td>\r
605                 <td>ログイン成功後</td>\r
606                 <td><dl>\r
607                         <dt class="obj ref">member</dt>\r
608                         <dd><code>MEMBER</code> オブジェクト</dd>\r
609                 </dl></td>              \r
610         </tr>\r
611         <tr>\r
612                 <td>LoginFailed</td>\r
613                 <td>ログイン失敗後</td>\r
614                 <td><dl>\r
615                         <dt class="ro">username</dt>\r
616                         <dd>ログイン時に使われたユーザー名</dd>\r
617                 </dl></td>              \r
618         </tr>\r
619         <tr>\r
620                 <td>Logout</td>\r
621                 <td>ログアウト後</td>\r
622                 <td><dl>\r
623                         <dt class="ro">username</dt>\r
624                         <dd>ログアウト時のユーザー名</dd>\r
625                 </dl></td>              \r
626         </tr>\r
627         <tr>\r
628                 <td>PreBlogContent</td>\r
629                 <td>blogの内容がスキン変数を通して挿入される前</td>\r
630                 <td><dl>\r
631                         <dt class="obj ref">blog</dt>\r
632                         <dd><code>BLOG</code> オブジェクト</dd>\r
633                         <dt class="ro">type</dt>\r
634                         <dd>呼び出されたスキン変数 ('blog', 'otherblog', 'archive', 'archivelist', 'item', 'searchresults',\r
635                           'othersearchresults', 'categorylist', 'otherarchive', 'otherarchivelist')</dd>\r
636                 </dl></td>              \r
637         </tr>\r
638         <tr>\r
639                 <td>PostBlogContent</td>\r
640                 <td>blogの内容がスキン変数を通して挿入された後</td>\r
641                 <td><dl>\r
642                         <dt class="obj ref">blog</dt>\r
643                         <dd><code>BLOG</code> オブジェクト</dd>\r
644                         <dt class="ro">type</dt>\r
645                         <dd>呼び出されたスキン変数 ('blog', 'otherblog', 'archive', 'archivelist', 'item', 'searchresults',\r
646                   'othersearchresults', 'categorylist', 'otherarchive', 'otherarchivelist')</dd>\r
647                 </dl></td>              \r
648         </tr>\r
649         <tr>\r
650                 <td>PreAddComment</td>\r
651                 <td>コメントがデータベースに追加される前</td>\r
652                 <td><dl>\r
653                         <dt class="ref">comment</dt>\r
654                         <dd>コメントデータ(連想配列)</dd>\r
655                 </dl></td>              \r
656         </tr>\r
657         <tr>\r
658                 <td>PostAddComment</td>\r
659                 <td>コメントがデータベースに追加された後</td>\r
660                 <td><dl>\r
661                         <dt class="ref">comment</dt>\r
662                         <dd>コメントデータ(連想配列)</dd>\r
663                         <dt class="ref">commentid</dt>\r
664                         <dd>コメントのID</dd>\r
665                 </dl></td>              \r
666         </tr>\r
667         <tr>\r
668                 <td>PostRegister</td>\r
669                 <td>新規ユーザーの登録後</td>\r
670                 <td><dl>\r
671                         <dt class="obj ref">member</dt>\r
672                         <dd>新しい<code>MEMBER</code> オブジェクト</dd>\r
673                 </dl></td>              \r
674         </tr>\r
675         <tr>\r
676                 <td>PostAddItem</td>\r
677                 <td>アイテムがデータベースに追加された後</td>\r
678                 <td><dl>\r
679                         <dt class="ro">itemid</dt>\r
680                         <dd>データベースに出来た新しい itemid</dd>\r
681                 </dl></td>              \r
682         </tr>\r
683         <tr>\r
684                 <td>PreAddItem</td>\r
685                 <td>アイテムがデータベースに追加される直前</td>\r
686                 <td><dl>\r
687                         <dt class="ref">title</dt>\r
688                         <dd>タイトル</dd>\r
689                         <dt class="ref">body</dt>\r
690                         <dd>本文</dd>\r
691                         <dt class="ref">more</dt>\r
692                         <dd>拡張テキスト</dd>\r
693                         <dt class="ref obj">blog</dt>\r
694                         <dd><code>BLOG</code> オブジェクト</dd>\r
695                         <dt class="ref">authorid</dt>\r
696                         <dd>執筆者ID</dd>\r
697                         <dt class="ref">timestamp</dt>\r
698                         <dd>UNIX タイムスタンプ</dd>\r
699                         <dt class="ref">closed</dt>\r
700                         <dd>1 (コメント不可) or 0 (コメント可)</dd>\r
701                         <dt class="ref">draft</dt>\r
702                         <dd>1 (ドラフト) or 0 (非ドラフト)</dd>\r
703                         <dt class="ref">catid</dt>\r
704                         <dd>カテゴリーID</dd>\r
705                 </dl></td>              \r
706         </tr>   \r
707         <tr>\r
708                 <td>PreUpdateItem</td>\r
709                 <td>データベースにあるアイテムが更新される直前</td>\r
710                 <td><dl>\r
711                         <dt class="ro">itemid</dt>\r
712                         <dd>アイテム ID</dd>\r
713                         <dt class="ref">title</dt>\r
714                         <dd>タイトル</dd>\r
715                         <dt class="ref">body</dt>\r
716                         <dd>本文</dd>\r
717                         <dt class="ref">more</dt>\r
718                         <dd>拡張テキスト</dd>\r
719                         <dt class="ref obj">blog</dt>\r
720                         <dd><code>BLOG オブジェクト</code> object</dd>\r
721                         <dt class="ref">closed</dt>\r
722                         <dd>1 (コメント不可) or 0 (コメント可)</dd>\r
723                         <dt class="ref">catid</dt>\r
724                         <dd>カテゴリーID</dd>\r
725                 </dl></td>              \r
726         </tr>\r
727         <tr>\r
728                 <td>PrepareItemForEdit</td>\r
729                 <td>アイテムをデータベースから取得した直後で、編集のためにユーザーに表示される前</td>\r
730                 <td><dl>\r
731                         <dt class="ref">item</dt>\r
732                         <dd>アイテムデータを持つ連想配列</dd>\r
733                 </dl></td>              \r
734         </tr>\r
735         <tr>\r
736                 <td>PreUpdateComment</td>\r
737                 <td>コメントが更新され、データベースに保存される直前</td>\r
738                 <td><dl>\r
739                         <dt class="ref">body</dt>\r
740                         <dd>コメント本文</dd>\r
741                 </dl></td>              \r
742         </tr>\r
743         <tr>\r
744                 <td>PrepareCommentForEdit</td>\r
745                 <td>コメントをデータベースから取得した直後で、編集のためにユーザーに表示される前</td>\r
746                 <td><dl>\r
747                         <dt class="ref">comment</dt>\r
748                         <dd>コメントデータ(連想配列)</dd>\r
749                 </dl></td>              \r
750         </tr>\r
751         <tr>\r
752                 <td>PrePluginOptionsEdit</td>\r
753                 <td>\r
754                         (v2.0b) 'プラグインオプションの編集'フォームが生成される前\r
755                         <br />(v2.2) パラメータ追加\r
756                         <br />(v3.2) 各オプションにパラメータ追加\r
757                 </td>\r
758                 <td><dl>\r
759                         <dt class="ro">context</dt>\r
760                         <dd>(v2.2) <code>global</code>, <code>blog</code>, <code>member</code>, <code>item</code>, <code>category</code>のいずれか</dd>\r
761                         <dt class="ref">options</dt>\r
762                         <dd>次のインデックスをもつ連想配列: <code>name</code>, <code>value</code>, <code>oid</code>, <code>description</code>, <code>type</code>, <code>typeinfo</code>, <code>contextid</code>, <code>extra</code> 。追加オプションをここに加えることも可能(それらで何かの処理をするときはPostPluginOptionsUpdateの記述も必要)<br />\r
763                         <code>extra</code>フィールドを用いて、オプションに追加HTML(たとえばフォームのコントロール)を追加できます。もしそうする場合、 <code>extra</code> に追加する前に <code>pid</code> と <code>getID()</code> を比較し、さらに <code>name</code> をチェックすべきです。</dd>\r
764                         <dt class="ro">plugid</dt>\r
765                         <dd>プラグイン ID (これが気になるなら、<code>GetID()</code>を見ると理解できる)(コンテクストがglobalのときのみ存在)</dd>\r
766                         <dt class="ro">contextid</dt>\r
767                         <dd>コンテクスト ID (blogid, memberid, catid, itemid コンテクストによる)</dd>\r
768                 </dl></td>              \r
769         </tr>   \r
770         <tr>\r
771                 <td>PrePluginOptionsUpdate</td>\r
772                 <td>\r
773                         (v3.2) プラグインオプションが更新される前。(このイベントを使ってオプションの新しい値を評価したり変更したりできます)\r
774                 </td>\r
775                 <td><dl>\r
776                         <dt class="ro">context</dt>\r
777                         <dd>(v2.2) <code>global</code>, <code>member</code>, <code>blog</code>, <code>item</code>, <code>category</code>のいずれか</dd>\r
778                         <dt class="ro">plugid</dt>\r
779                         <dd>プラグイン ID (これが気になるなら、<code>GetID()</code>を見ると理解できる)</dd>\r
780                         <dt class="ro">optionname</dt>\r
781                         <dd>オプション名</dd>\r
782                         <dt class="ro">contextid</dt>\r
783                         <dd>コンテクスト ID (blogid, memberid, catid, itemid コンテクストによる)</dd>\r
784                         <dt class="ref">value</dt>\r
785                         <dd>そのオプションの新しい値</dd>\r
786                 </dl></td>\r
787         </tr>\r
788         <tr>\r
789                 <td>PostPluginOptionsUpdate</td>\r
790                 <td>\r
791                         (v2.0b) プラグインオプションの更新後<br />\r
792                 (v2.2) コンテクストによって異なるパラメータ</td>\r
793                 <td><dl>\r
794                         <dt class="ro">context</dt>\r
795                         <dd>(v2.2) <code>global</code>, <code>member</code>, <code>blog</code>, <code>item</code>, <code>category</code>のいずれか</dd>\r
796                         <dt class="ro">plugid</dt>\r
797                         <dd>プラグイン ID (これが気になるなら、<code>GetID()</code>を見ると理解できる)(globalコンテクスト)</dd>\r
798                         <dt class="ro">blogid</dt>\r
799                         <dd>(v2.2) blog ID (blog コンテクスト)</dd>                       \r
800                         <dt class="ref obj">blog</dt>\r
801                         <dd>(v2.2) BLOG オブジェクト (blog コンテクスト)</dd>                       \r
802                         <dt class="ro">memberid</dt>\r
803                         <dd>(v2.2) member ID (member コンテクスト)</dd>                   \r
804                         <dt class="ref obj">member</dt>\r
805                         <dd>(v2.2) MEMBER オブジェクト (member コンテクスト)</dd>                   \r
806                         <dt class="ro">catid</dt>\r
807                         <dd>(v2.2) category ID (category コンテクスト)</dd>                       \r
808                         <dt class="ro">itemid</dt>\r
809                         <dd>(v2.2) item ID (item コンテクスト)</dd>\r
810                         <dt class="ref obj">member</dt>\r
811                         <dd>(v2.2) ITEM オブジェクト (item コンテクスト)</dd>\r
812                 </dl></td>              \r
813                 \r
814         </tr>   \r
815         <tr>\r
816                 <td>PostAuthentication</td>\r
817                 <td>(v2.0b) ログイン処理の完了後。ページリクエストごとに発生</td>\r
818                 <td><dl>\r
819                         <dt class="ro">loggedIn</dt>\r
820                         <dd><code>$member->isLoggedIn()</code>の戻り値</dd>\r
821                 </dl></td>              \r
822         </tr>           \r
823         <tr>\r
824                 <td>PreAddItemForm</td>\r
825                 <td>(v2.0b) アイテム追加フォーム(ブックマークレットまたは管理エリア)が生成される直前</td>\r
826                 <td><dl>\r
827                         <dt class="ref">contents</dt>\r
828                         <dd>連想配列への参照。そのうちの'title',\r
829                           'body', 'more'にはフォームフィールドへの初期値を与えることができます。複数のプラグイン間でこれらの値の変更を避けるには、処理後に'hasBeenSet'の値を1にセットします(かつ処理前にこの値をチェックするようにします)</dd>\r
830                         <dt class="ref obj">blog</dt>\r
831                         <dd><code>BLOG</code> オブジェクトへの参照</dd>\r
832                 </dl></td>              \r
833         </tr>           \r
834         <tr>\r
835                 <td>AddItemFormExtras</td>\r
836                 <td>(v2.0b) アイテム追加ページまたはブックマークレット内部のどこか。<code>template</code> ファイルの類を別に用意しなくても、ここでプラグインがカスタムフィールドを追加できる。</td>\r
837                 <td><dl>\r
838                         <dt class="ref obj">blog</dt>\r
839                         <dd><code>BLOG</code> オブジェクトへの参照</dd>\r
840                 </dl></td>              \r
841         </tr>                   \r
842         <tr>\r
843                 <td>EditItemFormExtras</td>\r
844                 <td>\r
845                         (v2.0b) アイテム編集ページまたはブックマークレット内部のどこか。<code>template</code> ファイルの類を別に用意しなくても、ここでプラグインがカスタムフィールドを追加できる。<br />\r
846                         <br />                  \r
847                         あまり多くのデータを追加しないこと。また以下のように<strong>正しいXHTML</strong>を生成してください。               <pre class="example"><code>&lt;h3&gt;プラグイン名&lt;/h3&gt;\r
848 &lt;p&gt;追加フォームの内容&lt;/p&gt;</code></pre>\r
849                 このようにして、正しい構造を保ちつつ複数のプラグインがオプションを保持できます。またフィールド名の重複を避けるためにプレフィックスを用いてください(例 <code>plug_tb_url</code>)。</td>\r
850                 <td><dl>\r
851                         <dt class="ref obj">blog</dt>\r
852                         <dd><code>BLOG</code> オブジェクトへの参照</dd>\r
853                         <dt class="ro">variables</dt>\r
854                         <dd>\r
855                                 (read-only) 編集されるアイテムに関する全ての情報を持つ連想配列: 'itemid',\r
856                                   'draft', 'closed', 'title', 'body', 'more', 'author', 'authorid',\r
857                                   'timestamp', 'karmapos', 'karmaneg', 'catid'\r
858                         </dd>                   \r
859                         <dt class="ro">itemid</dt>\r
860                         <dd>アイテム IDへのショートカット</dd>\r
861                 </dl></td>              \r
862         </tr>                           \r
863         <tr>\r
864                 <td>BlogSettingsFormExtras</td>\r
865                 <td>(v2.0) blog設定ページにフォームを追加可能<br /><br />                        \r
866                         あまり多くのデータを追加しないこと。また以下のように<strong>正しいXHTML</strong>を生成してください。               <pre class="example"><code>&lt;h4&gt;プラグイン名&lt;/h4&gt;\r
867 &lt;form method="post" action="..."&gt;&lt;p&gt;\r
868 追加フォームの内容&lt;/p&gt;&lt;/form&gt;</code></pre>\r
869                         このようにして、正しい構造を保ちつつ複数のプラグインがオプションを保持できます。またフィールド名の重複を避けるためにプレフィックスを用いてください(例 <code>plug_tb_url</code>)。</td>\r
870                 <td><dl>\r
871                         <dt class="obj ref">blog</dt>\r
872                         <dd><code>BLOG</code> オブジェクトへの参照</dd>\r
873                 </dl></td>              \r
874         </tr>\r
875         <tr>\r
876                 <td>PreDeleteItem</td>\r
877                 <td>(v2.0) アイテムがデータベースから削除される直前</td>\r
878                 <td><dl>\r
879                         <dt class="ro">itemid</dt>\r
880                         <dd>削除されるアイテムID</dd>\r
881                 </dl></td>              \r
882         </tr>\r
883         <tr>\r
884                 <td>PostDeleteItem</td>\r
885                 <td>(v2.0) アイテムがデータベースから削除された直後</td>\r
886                 <td><dl>\r
887                         <dt class="ro">itemid</dt>\r
888                         <dd>削除されたアイテムID</dd>\r
889                 </dl></td>              \r
890         </tr>\r
891         <tr>\r
892                 <td>PreDeleteCategory</td>\r
893                 <td>(v2.0) カテゴリーがデータベースから削除される直前</td>\r
894                 <td><dl>\r
895                         <dt class="ro">catid</dt>\r
896                         <dd>削除されるカテゴリー ID</dd>\r
897                 </dl></td>              \r
898         </tr>\r
899         <tr>\r
900                 <td>PostDeleteCategory</td>\r
901                 <td>(v2.0) カテゴリーがデータベースから削除された直後</td>\r
902                 <td><dl>\r
903                         <dt class="ro">catid</dt>\r
904                         <dd>削除されたカテゴリー ID</dd>\r
905                 </dl></td>              \r
906         </tr>   \r
907         <tr>\r
908                 <td>PreDeleteBlog</td>\r
909                 <td>(v2.0) blogがデータベースから削除される直前</td>\r
910                 <td><dl>\r
911                         <dt class="ro">blogid</dt>\r
912                         <dd>削除されるblogID</dd>\r
913                 </dl></td>              \r
914         </tr>\r
915         <tr>\r
916                 <td>PostDeleteBlog</td>\r
917                 <td>(v2.0) blogがデータベースから削除された直後</td>\r
918                 <td><dl>\r
919                         <dt class="ro">blogid</dt>\r
920                         <dd>削除されたblogID</dd>\r
921                 </dl></td>              \r
922         </tr>   \r
923         <tr>\r
924                 <td>PreDeleteMember</td>\r
925                 <td>(v2.0) メンバーがデータベースから削除される直前</td>\r
926                 <td><dl>\r
927                         <dt class="ref obj">member</dt>\r
928                         <dd><code>削除されるメンバーに関するMEMBER</code> オブジェクトへの参照</dd>\r
929                 </dl></td>              \r
930         </tr>\r
931         <tr>\r
932                 <td>PostDeleteMember</td>\r
933                 <td>(v2.0) メンバーがデータベースから削除された直後</td>\r
934                 <td><dl>\r
935                         <dt class="ref obj">member</dt>\r
936                         <dd><code>削除されるメンバーに関するMEMBER</code> オブジェクトへの参照</dd>\r
937                 </dl></td>              \r
938         </tr>   \r
939         <tr>\r
940                 <td>PreDeleteTeamMember</td>\r
941                 <td>(v2.0) メンバーがweblogチームから削除される直前</td>\r
942                 <td><dl>\r
943                         <dt class="ref obj">member</dt>\r
944                         <dd><code>MEMBER</code> オブジェクトへの参照</dd>\r
945                         <dt class="ro">blogid</dt>\r
946                         <dd>blogID</dd>\r
947                 </dl></td>              \r
948         </tr>\r
949         <tr>\r
950                 <td>PostDeleteTeamMember</td>\r
951                 <td>(v2.0) メンバーがweblogチームから削除された直後</td>\r
952                 <td><dl>\r
953                         <dt class="ref obj">member</dt>\r
954                         <dd><code>MEMBER</code> オブジェクトへの参照</dd>\r
955                         <dt class="ro">blogid</dt>\r
956                         <dd>blogID</dd>\r
957                 </dl></td>              \r
958         </tr>\r
959         <tr>\r
960                 <td>PreDeleteComment</td>\r
961                 <td>(v2.0) コメントがデータベースから削除される直前</td>\r
962                 <td><dl>\r
963                         <dt class="ro">commentid</dt>\r
964                         <dd>削除されるコメントID</dd>\r
965                 </dl></td>              \r
966         </tr>\r
967         <tr>\r
968                 <td>PostDeleteComment</td>\r
969                 <td>(v2.0) コメントがデータベースから削除された直後</td>\r
970                 <td><dl>\r
971                         <dt class="ro">commentid</dt>\r
972                         <dd>削除されたコメントID</dd>\r
973                 </dl></td>              \r
974         </tr>           \r
975         <tr>\r
976                 <td>ActionLogCleared</td>\r
977                 <td>(v2.0) アクションログが消去された後</td>\r
978                 <td>なし</td>         \r
979         </tr>\r
980         <tr>\r
981                 <td>PreDeleteTemplate</td>\r
982                 <td>(v2.0) テンプレートがデータベースから削除される直前</td>\r
983                 <td><dl>\r
984                         <dt class="ro">templateid</dt>\r
985                         <dd>削除されるテンプレートID</dd>\r
986                 </dl></td>              \r
987         </tr>\r
988         <tr>\r
989                 <td>PostDeleteTemplate</td>\r
990                 <td>(v2.0) テンプレートがデータベースから削除された直後</td>\r
991                 <td><dl>\r
992                         <dt class="ro">templateid</dt>\r
993                         <dd>削除されたテンプレートID</dd>\r
994                 </dl></td>              \r
995         </tr>           \r
996         <tr>\r
997                 <td>PreDeleteSkin</td>\r
998                 <td>(v2.0) スキンがデータベースから削除される直前</td>\r
999                 <td><dl>\r
1000                         <dt class="ro">skinid</dt>\r
1001                         <dd>削除されるスキンID</dd>\r
1002                 </dl></td>              \r
1003         </tr>\r
1004         <tr>\r
1005                 <td>PostDeleteSkin</td>\r
1006                 <td>(v2.0) スキンがデータベースから削除された直後</td>\r
1007                 <td><dl>\r
1008                         <dt class="ro">skinid</dt>\r
1009                         <dd>削除されたスキンID</dd>\r
1010                 </dl></td>              \r
1011         </tr>   \r
1012         <tr>\r
1013                 <td>PreDeletePlugin</td>\r
1014                 <td>(v2.0) プラグインがデータベースから削除される直前</td>\r
1015                 <td><dl>\r
1016                         <dt class="ro">plugid</dt>\r
1017                         <dd>削除されるプラグインID</dd>\r
1018                 </dl></td>              \r
1019         </tr>\r
1020         <tr>\r
1021                 <td>PostDeletePlugin</td>\r
1022                 <td>(v2.0) プラグインがデータベースから削除された直後</td>\r
1023                 <td><dl>\r
1024                         <dt class="ro">plugid</dt>\r
1025                         <dd>削除されたプラグインID</dd>\r
1026                 </dl></td>              \r
1027         </tr>           \r
1028         <tr>\r
1029                 <td>PreDeleteBan</td>\r
1030                 <td>(v2.0) 禁止IPがデータベースから削除される直前</td>\r
1031                 <td><dl>\r
1032                         <dt class="ro">blogid</dt>\r
1033                         <dd>禁止IPが削除されるblogのID</dd>\r
1034                         <dt class="ro">iprange</dt>\r
1035                         <dd>禁止されたIPレンジ</dd>                     \r
1036                 </dl></td>              \r
1037         </tr>\r
1038         <tr>\r
1039                 <td>PostDeleteBan</td>\r
1040                 <td>(v2.0) 禁止IPがデータベースから削除された直後</td>\r
1041                 <td><dl>\r
1042                         <dt class="ro">blogid</dt>\r
1043                         <dd>禁止IPが削除されたblogのID</dd>\r
1044                         <dt class="ro">iprange</dt>\r
1045                         <dd>禁止されたIPレンジ</dd>                     \r
1046                 </dl></td>              \r
1047         </tr>                   \r
1048         <tr>\r
1049                 <td>PreAddCategory</td>\r
1050                 <td>(v2.0) 新しいカテゴリーがデータベースに生成される直前</td>\r
1051                 <td><dl>\r
1052                         <dt class="ref obj">blog</dt>\r
1053                         <dd><code>BLOG</code> オブジェクトの参照</dd>\r
1054                         <dt class="ref">name</dt>\r
1055                         <dd>新しいカテゴリー名</dd>                    \r
1056                         <dt class="ref">description</dt>\r
1057                         <dd>新しいカテゴリーの説明</dd>\r
1058                 </dl></td>              \r
1059         </tr>\r
1060         <tr>\r
1061                 <td>PostAddCategory</td>\r
1062                 <td>(v2.0) 新しいカテゴリーがデータベースに生成された直後</td>\r
1063                 <td><dl>\r
1064                         <dt class="ref obj">blog</dt>\r
1065                         <dd><code>BLOG</code> オブジェクトへの参照</dd>\r
1066                         <dt class="ro">name</dt>\r
1067                         <dd>新しいカテゴリー名</dd>                    \r
1068                         <dt class="ro">description</dt>\r
1069                         <dd>新しいカテゴリーの説明</dd>\r
1070                         <dt class="ro">catid</dt>\r
1071                         <dd>新しいカテゴリー ID</dd>                    \r
1072                 </dl></td>              \r
1073         </tr>\r
1074         <tr>\r
1075                 <td>PreAddBlog</td>\r
1076                 <td>(v2.0) 新しいblogが生成される直前</td>\r
1077                 <td><dl>\r
1078                         <dt class="ref">name</dt>\r
1079                         <dd>新しい blog名</dd>\r
1080                         <dt class="ref">shortname</dt>\r
1081                         <dd>新しい blogの短縮名</dd>\r
1082                         <dt class="ref">timeoffset</dt>\r
1083                         <dd>新しい blogのタイムオフセット</dd>\r
1084                         <dt class="ref">description</dt>\r
1085                         <dd>新しい blogの説明</dd>\r
1086                         <dt class="ref">defaultskin</dt>\r
1087                         <dd>新しいblogのデフォルトスキンのID</dd>\r
1088                 </dl></td>              \r
1089         </tr>\r
1090         <tr>\r
1091                 <td>PostAddBlog</td>\r
1092                 <td>(v2.0) 新しいblogが生成された直後</td>\r
1093                 <td><dl>\r
1094                         <dt class="ref obj">blog</dt>\r
1095                         <dd>新しい<code>BLOG</code> オブジェクト</dd>\r
1096                 </dl></td>              \r
1097         </tr>\r
1098         <tr>\r
1099                 <td>PreAddPlugin</td>\r
1100                 <td>(v2.0) プラグインが追加される直前</td>\r
1101                 <td><dl>\r
1102                         <dt class="ref">file</dt>\r
1103                         <dd>新しいプラグインのファイル名</dd>\r
1104                 </dl></td>              \r
1105         </tr>\r
1106         <tr>\r
1107                 <td>PostAddPlugin</td>\r
1108                 <td>(v2.0) プラグインが追加された直後</td>\r
1109                 <td><dl>\r
1110                         <dt class="ref obj">plugin</dt>\r
1111                         <dd>新しく追加されたプラグインのオブジェクト</dd>\r
1112                 </dl></td>              \r
1113         </tr>\r
1114         <tr>\r
1115                 <td>PreAddTeamMember</td>\r
1116                 <td>(v2.0) メンバーがblogチームに追加される直前</td>\r
1117                 <td><dl>\r
1118                         <dt class="ref obj">blog</dt>\r
1119                         <dd><code>BLOG</code> オブジェクト</dd>\r
1120                         <dt class="ref obj">member</dt>\r
1121                         <dd><code>MEMBER</code> オブジェクト</dd>\r
1122                         <dt class="ref">admin</dt>\r
1123                         <dd>新しく追加されたメンバーが管理権限を持っているかどうかを示すブール値</dd>\r
1124                 </dl></td>              \r
1125         </tr>\r
1126         <tr>\r
1127                 <td>PostAddTeamMember</td>\r
1128                 <td>(v2.0) メンバーがblogチームに追加された直後</td>\r
1129                 <td><dl>\r
1130                         <dt class="ref obj">blog</dt>\r
1131                         <dd><code>BLOG</code> オブジェクト</dd>\r
1132                         <dt class="ref obj">member</dt>\r
1133                         <dd><code>MEMBER</code> オブジェクト</dd>\r
1134                         <dt class="ro">admin</dt>\r
1135                         <dd>新しく追加されたメンバーが管理権限を持っているかどうかを示すブール値</dd>\r
1136                 </dl></td>              \r
1137         </tr>\r
1138         <tr>\r
1139                 <td>PreAddTemplate</td>\r
1140                 <td>(v2.0) 新しいテンプレートが生成される直前(注:テンプレートが複製されたときも呼ばれる)</td>\r
1141                 <td><dl>\r
1142                         <dt class="ref">name</dt>\r
1143                         <dd>新しいテンプレート名</dd>\r
1144                         <dt class="ref">description</dt>\r
1145                         <dd>新しいテンプレートの説明</dd>\r
1146                 </dl></td>              \r
1147         </tr>\r
1148         <tr>\r
1149                 <td>PostAddTemplate</td>\r
1150                 <td>(v2.0) 新しいテンプレートが生成された直後</td>\r
1151                 <td><dl>\r
1152                         <dt class="ro">name</dt>\r
1153                         <dd>新しいテンプレート名</dd>\r
1154                         <dt class="ro">description</dt>\r
1155                         <dd>新しいテンプレートの説明</dd>\r
1156                         <dt class="ro">templateid</dt>\r
1157                         <dd>新しいテンプレートID</dd>\r
1158                 </dl></td>              \r
1159         </tr>   \r
1160         <tr>\r
1161                 <td>PreAddSkin</td>\r
1162                 <td>(v2.0) 新しいスキンが生成される直前(注:スキンが複製されたときも呼ばれる)</td>\r
1163                 <td><dl>\r
1164                         <dt class="ref">name</dt>\r
1165                         <dd>新しいスキン名</dd>\r
1166                         <dt class="ref">description</dt>\r
1167                         <dd>新しいスキン名の説明</dd>\r
1168                         <dt class="ref">type</dt>\r
1169                         <dd>スキンのコンテントタイプ</dd>\r
1170                         <dt class="ref">includeMode</dt>\r
1171                         <dd>新しいスキンのインクルードモード</dd>\r
1172                         <dt class="ref">includePrefix</dt>\r
1173                         <dd>新しいスキンのインクルードプレフィックス</dd>\r
1174                 </dl></td>              \r
1175         </tr>\r
1176         <tr>\r
1177                 <td>PostAddSkin</td>\r
1178                 <td>(v2.0) 新しいスキンが生成された直後</td>\r
1179                 <td><dl>\r
1180                         <dt class="ro">name</dt>\r
1181                         <dd>新しいスキン名</dd>\r
1182                         <dt class="ro">description</dt>\r
1183                         <dd>新しいスキンの説明</dd>\r
1184                         <dt class="ro">type</dt>\r
1185                         <dd>スキンのコンテントタイプ</dd>\r
1186                         <dt class="ro">includeMode</dt>\r
1187                         <dd>新しいスキンのインクルードモード</dd>\r
1188                         <dt class="ro">includePrefix</dt>\r
1189                         <dd>新しいスキンのインクルードプレフィックス</dd>\r
1190                         <dt class="ro">skinid</dt>\r
1191                         <dd>新しいスキンID</dd>\r
1192                 </dl></td>              \r
1193         </tr>           \r
1194         <tr>\r
1195                 <td>PreAddBan</td>\r
1196                 <td>(v2.0) 新しい禁止IPが追加される直前</td>\r
1197                 <td><dl>\r
1198                         <dt class="ref">blogid</dt>\r
1199                         <dd>blogID</dd>\r
1200                         <dt class="ref">iprange</dt>\r
1201                         <dd>禁止されたIPレンジ</dd>\r
1202                         <dt class="ref">reason</dt>\r
1203                         <dd>禁止された理由を記述したテキストメッセージ</dd>\r
1204                 </dl></td>              \r
1205         </tr>\r
1206         <tr>\r
1207                 <td>PostAddBan</td>\r
1208                 <td>(v2.0) 新しい禁止IPが追加された直後</td>\r
1209                 <td><dl>\r
1210                         <dt class="ro">blogid</dt>\r
1211                         <dd>blogID</dd>\r
1212                         <dt class="ro">iprange</dt>\r
1213                         <dd>禁止されたIPレンジ</dd>\r
1214                         <dt class="ro">reason</dt>\r
1215                         <dd>禁止された理由を記述したテキストメッセージ</dd>\r
1216                 </dl></td>              \r
1217         </tr>           \r
1218 \r
1219         <tr>\r
1220                 <td>PreMoveItem</td>\r
1221                 <td>(v2.0) アイテムが他のblog/カテゴリーに移される直前</td>\r
1222                 <td><dl>\r
1223                         <dt class="ref">itemid</dt>\r
1224                         <dd>アイテムID</dd>\r
1225                         <dt class="ref">destblogid</dt>\r
1226                         <dd>移動先のblogID</dd>\r
1227                         <dt class="ref">destcatid</dt>\r
1228                         <dd>移動先のカテゴリーID</dd>                  \r
1229                 </dl></td>              \r
1230         </tr>\r
1231         <tr>\r
1232                 <td>PostMoveItem</td>\r
1233                 <td>(v2.0) アイテムが他のblog/カテゴリーに移された直後</td>\r
1234                 <td><dl>\r
1235                         <dt class="ro">itemid</dt>\r
1236                         <dd>アイテムID</dd>\r
1237                         <dt class="ro">destblogid</dt>\r
1238                         <dd>新しいblogID</dd>\r
1239                         <dt class="ro">destcatid</dt>\r
1240                         <dd>新しいカテゴリーID</dd>     \r
1241                 </dl></td>              \r
1242         </tr>\r
1243         <tr>\r
1244                 <td>PreMoveCategory</td>\r
1245                 <td>(v2.0) カテゴリーが他のblogに移される直前</td>\r
1246                 <td><dl>\r
1247                         <dt class="ref">catid</dt>\r
1248                         <dd>カテゴリーID</dd>\r
1249                         <dt class="ref obj">sourceblog</dt>\r
1250                         <dd>移動元の<code>BLOG</code> オブジェクト</dd>\r
1251                         <dt class="ref obj">destblog</dt>\r
1252                         <dd>移動先の<code>BLOG</code> オブジェクト</dd>                       \r
1253                 </dl></td>              \r
1254         </tr>\r
1255         <tr>\r
1256                 <td>PostMoveCategory</td>\r
1257                 <td>(v2.0) カテゴリーが他のblogに移された直後</td>\r
1258                 <td><dl>\r
1259                         <dt class="ro">catid</dt>\r
1260                         <dd>カテゴリーID</dd>\r
1261                         <dt class="ref obj">sourceblog</dt>\r
1262                         <dd>移動元の<code>BLOG</code> オブジェクト</dd>\r
1263                         <dt class="ref obj">destblog</dt>\r
1264                         <dd>移動先の<code>BLOG</code> オブジェクト</dd>                       \r
1265                 </dl></td>              \r
1266         </tr>   \r
1267         <tr>\r
1268                 <td>MemberSettingsFormExtras</td>\r
1269                 <td>(v2.0) メンバー設定ページにフォームを追加可能<br /><br />                        \r
1270                         あまり多くのデータを追加しないこと。また以下のように<strong>正しいXHTML</strong>を生成してください。\r
1271             <pre class="example"><code>&lt;h4&gt;プラグイン名&lt;/h4&gt;\r
1272 &lt;form method="post" action="..."&gt;&lt;p&gt;\r
1273 追加フォームの内容&lt;/p&gt;&lt;/form&gt;</code></pre>\r
1274 このようにして、正しい構造を保ちつつ複数のプラグインがオプションを保持できます。またフィールド名の重複を避けるためにプレフィックスを用いてください(例 <code>plug_tb_url</code>)。</td>\r
1275                 <td><dl>\r
1276                         <dt class="ref obj">member</dt>\r
1277                         <dd><code>MEMBER</code> オブジェクトへの参照</dd>\r
1278                 </dl></td>              \r
1279         </tr>\r
1280         <tr>\r
1281                 <td>GeneralSettingsFormExtras</td>\r
1282                 <td>(v2.0) 一般設定ページにフォームを追加可能<br />\r
1283                   <br />\r
1284 あまり多くのデータを追加しないこと。また以下のように<strong>正しいXHTML</strong>を生成してください。\r
1285 <pre class="example"><code>&lt;h4&gt;プラグイン名&lt;/h4&gt;\r
1286 &lt;form method="post" action="..."&gt;&lt;p&gt;\r
1287 追加フォームの内容&lt;/p&gt;&lt;/form&gt;</code></pre>\r
1288 このようにして、正しい構造を保ちつつ複数のプラグインがオプションを保持できます。またフィールド名の重複を避けるためにプレフィックスを用いてください(例 <code>plug_tb_url</code>)。</td>\r
1289                 <td>なし</td>         \r
1290         </tr>\r
1291         <tr>\r
1292                 <td>AdminPrePageHead</td>\r
1293                 <td>(v2.5) 管理画面で、ページヘッドを出力する直前。このイベントはヘッド領域にスクリプトやCSSを追加するのに用いられます。</td>\r
1294                 <td><dl>\r
1295                         <dt class="ref">extrahead</dt>\r
1296                         <dd>HTMLページのヘッド領域に埋め込まれる追加情報。ここに追加したいものを入れてください。</dd>\r
1297                         <dt class="ro">action</dt>\r
1298                         <dd>現在実行されているアクション、またはページタイプ</dd>\r
1299                 </dl></td>\r
1300         </tr>\r
1301         <tr>\r
1302                 <td>AdminPrePageFoot</td>\r
1303                 <td>(v2.5) 管理画面で、ページフッターを出力する直前。</td>\r
1304           <td><dl>\r
1305                         <dt class="ro">action</dt>\r
1306                         <dd></dd>\r
1307                 </dl>\r
1308             現在実行されているアクション、またはページタイプ</td>\r
1309         </tr>\r
1310         <tr>\r
1311                 <td>PreSendContentType</td>\r
1312                 <td>(v2.5) HTTPヘッダーにコンテントタイプがセットされる直前</td>\r
1313                 <td><dl>\r
1314                         <dt class="ref">contentType</dt>\r
1315                         <dd>コンテントタイプ(<code>application/xhtml+xml</code>など)</dd>\r
1316                         <dt class="ref">charset</dt>\r
1317                         <dd>キャラクターセット</dd>\r
1318                         <dt class="ro">pageType</dt>\r
1319                         <dd>表示するページの種類を示す文字列:<code>skin</code> (スキンタイプ), <code>media</code> (メディアライブラリ), <code>admin-<em>action</em></code> (管理エリア), <code>bookmarklet-<em>action</em></code> (ブックマークレット)</dd>\r
1320                 </dl></td>\r
1321         </tr>\r
1322         <tr>\r
1323                 <td>QuickMenu</td>\r
1324                 <td>(v2.5) 管理エリアのクイックメニューの一番下。そこへのプラグイン登録に利用されます。登録するにはoptionsに連想配列を入れます。実装例が<a href="#admin">プラグイン管理エリアを作る</a>のセクションにあります。</td>\r
1325                 <td><dl>\r
1326                         <dt class="ref">options</dt>\r
1327                         <dd>配列</dd>\r
1328                 </dl></td>\r
1329         </tr>\r
1330         <tr>\r
1331                 <td>BookmarkletExtraHead</td>\r
1332                 <td>(v2.5) ブックマークレット\r
1333           XHTMLコードのヘッド領域内。</td>\r
1334                 <td><dl>\r
1335                         <dt class="ref">extrahead</dt>\r
1336                         <dd>XHTMLコードのヘッド領域に埋め込まれる追加情報。ここに追加したいものを入れてください。</dd>\r
1337                 </dl></td>\r
1338         </tr>\r
1339         <tr>\r
1340                 <td>FormExtra</td>\r
1341                 <td>(v3.2) このイベントは、プラグインがコメント、メンバー間メール、認証フォームのいずれかのフォーム内に追加フィールドを挿入するときに使います。フォーム処理の際に発生する <code>ValidateForm</code> イベントに対応します。</td>\r
1342                 <td><dl>\r
1343                         <dt class="ro">type</dt>\r
1344                         <dd>イベントを発生させるフォームタイプ\r
1345                                 <ul>\r
1346                                         <li><code>activation</code></li>\r
1347                                         <li><code>additemform</code> (注:これは管理画面のアイテム追加フォームではない)</li>\r
1348                                         <li><code>commentform-loggedin</code></li>\r
1349                                         <li><code>commentform-notloggedin</code></li>\r
1350                                         <li><code>membermailform-loggedin</code></li>\r
1351                                         <li><code>membermailform-notloggedin</code></li>\r
1352                                 </ul>\r
1353                         </dd>\r
1354                         <dt class="ro obj">member</dt>\r
1355                         <dd><code>type</code> が <code>activation</code>のとき、このフィールドは認証メンバーの詳細情報を含みます</dd>\r
1356                 </dl></td>\r
1357         </tr>\r
1358         <tr>\r
1359                 <td>ValidateForm</td>\r
1360                 <td>(v3.2) コメント、メンバー間メール、アカウント認証のいずれかが処理されるときに呼ばれます。プラグインはこれで各データの評価を実行でき、もし不具合があれば処理を中断できます。<code>FormExtra</code> と共に使うとフォームにフィールドを追加できます。</td>\r
1361                 <td><dl>\r
1362                         <dt class="ro">type</dt>\r
1363                         <dd>処理されるフォームタイプ\r
1364                                 <ul>\r
1365                                         <li><code>membermail</code></li>\r
1366                                         <li><code>comment</code></li>\r
1367                                         <li><code>activation</code></li>\r
1368                                 </ul>\r
1369                         </dd>\r
1370                         <dt class="ref">error</dt>\r
1371                         <dd>フォーム処理をストップするときに、<code>error</code> フィールドに空でないエラーメッセージを記入します。このエラーメッセージはユーザー側に表示されます。</dd>\r
1372                         <dt class="ref">comment</dt>\r
1373                         <dd>コメントフォームのとき、コメントデータに関する連想配列を含みます。</dd>\r
1374                         <dt class="ro obj">member</dt>\r
1375                         <dd>認証フォームのとき、認証中のメンバー情報を含みます。</dd>\r
1376                 </dl></td>\r
1377         </tr>\r
1378 <!--\r
1379         <tr>\r
1380                 <td></td>\r
1381                 <td></td>\r
1382                 <td><dl>\r
1383                         <dt></dt>\r
1384                         <dd></dd>\r
1385                 </dl></td>\r
1386         </tr>\r
1387         <tr>\r
1388                 <td></td>\r
1389                 <td></td>\r
1390                 <td><dl>\r
1391                         <dt></dt>\r
1392                         <dd></dd>\r
1393                 </dl></td>\r
1394         </tr>\r
1395         <tr>\r
1396                 <td></td>\r
1397                 <td></td>\r
1398                 <td><dl>\r
1399                         <dt></dt>\r
1400                         <dd></dd>\r
1401                 </dl></td>\r
1402         </tr>\r
1403         <tr>\r
1404                 <td></td>\r
1405                 <td></td>\r
1406                 <td><dl>\r
1407                         <dt></dt>\r
1408                         <dd></dd>\r
1409                 </dl></td>\r
1410         </tr>\r
1411         <tr>\r
1412                 <td></td>\r
1413                 <td></td>\r
1414                 <td><dl>\r
1415                         <dt></dt>\r
1416                         <dd></dd>\r
1417                 </dl></td>\r
1418         </tr>\r
1419         <tr>\r
1420                 <td></td>\r
1421                 <td></td>\r
1422                 <td><dl>\r
1423                         <dt></dt>\r
1424                         <dd></dd>\r
1425                 </dl></td>\r
1426         </tr>\r
1427         <tr>\r
1428                 <td></td>\r
1429                 <td></td>\r
1430                 <td><dl>\r
1431                         <dt></dt>\r
1432                         <dd></dd>\r
1433                 </dl></td>\r
1434         </tr>\r
1435         <tr>\r
1436                 <td></td>\r
1437                 <td></td>\r
1438                 <td><dl>\r
1439                         <dt></dt>\r
1440                         <dd></dd>\r
1441                 </dl></td>\r
1442         </tr> -->\r
1443 </table>\r
1444 \r
1445 \r
1446 \r
1447 <h1>オプションを保存する<a name="options" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
1448 \r
1449 <p>プラグインに簡単にオプションを登録・取得できるように一連のメソッドが用意されています。これらのオプションは直接Nucleusの管理エリアで編集でき、プラグイン自身の管理エリアを用意する必要もなく、PHPファイルそのものの中にオプションの値を書き込まずにすみます。</p>\r
1450 \r
1451 <p>オプションは異なったコンテクストで利用可能です。</p>\r
1452 \r
1453 <ol>\r
1454         <li><strong>グローバルオプション</strong>:管理エリアのプラグインセクションで編集可能</li>\r
1455         <li><strong>blogオプション</strong>:blog設定ページで編集可能</li>\r
1456         <li><strong>カテゴリーオプション</strong>:blog設定ページ(のカテゴリー編集ページ)で編集可能</li>    \r
1457         <li><strong>メンバーオプション</strong>:メンバー編集ページで編集可能</li>\r
1458         <li><strong>アイテムオプション</strong>:アイテムの追加、およびアイテムの編集ページで編集可能</li>\r
1459 </ol>\r
1460 \r
1461 <h2>オプションの種類</h2>\r
1462 \r
1463 <p>オプションにはいくつかのタイプが提供されています。</p>\r
1464 \r
1465 <dl>\r
1466         <dt>text</dt>\r
1467         <dd>シンプルなテキスト</dd>\r
1468         <dt>yesno</dt>\r
1469         <dd>'yes'か'no'どちらか(編集画面ではラジオボタンとして表示されます)</dd>\r
1470         <dt>password</dt>\r
1471         <dd>テキストフィールド (編集画面では伏字で表示されます)</dd>\r
1472         <dt>textarea (v2.2)</dt>\r
1473         <dd>複数行のテキストフィールド</dd>\r
1474         <dt>select (v2.2)</dt>\r
1475         <dd>ドロップダウンメニュー。次のような形式の追加情報が必要です: Option 1|value1|Option 2|value2|Option 3|value3 </dd>\r
1476 </dl>\r
1477 \r
1478 <h2>オプション・メタ</h2>\r
1479 \r
1480 <p>Nucleus v3.2よりオプション・メタデータを用いて、オプションタイプを正しい値を受け取れるように制限できるようになりました。このメタデータは <code>$typeExtras</code>フィールドにセミコロン区切りのリストで保存されます。注:selectオプションでは、selectリストは<code>$typeExtras</code>のなかで一番最初でなければいけません。</p>\r
1481 \r
1482 <table><tr>\r
1483         <th>キー</th>\r
1484         <th>説明</th>\r
1485 </tr><tr>\r
1486         <td><code>datatype</code></td>\r
1487         <td>Nucleus本体に、どのデータ型を使いたいかという追加情報を与えます。現在は '<code>numerical</code>' のみ利用できます。 '<code>numerical</code>' を指定することでNucleusは数値情報のみを受け付けます(クライアントサイド・サーバサイド両方でチェック) ('<code>select</code>' と '<code>text</code>'のオプションタイプで利用できます)</td>\r
1488 </tr><tr>\r
1489         <td><code>access</code></td>\r
1490         <td>'<code>readonly</code>'にセットすることで、オプションを編集不可能にします('<code>text</code>' と '<code>textarea</code>'のオプションタイプで利用できます)<br />\r
1491         '<code>hidden</code>'を使うと、利用者側にそのオプションの存在を完全に隠蔽します('<code>text</code>'のオプションタイプで利用できます)</td>\r
1492 </tr></table>\r
1493 \r
1494 <p>設定例</p>\r
1495 <pre class="example"><code>// 数値のみを受け付けるテキストオプションを作成\r
1496 $this->createBlogOption('FooBar', 'foobar', 'text', '0', 'datatype=numerical');\r
1497 // 数値のみを受け付けるセレクトオプションを作成\r
1498 $this->createItemOption('FooBar', 'foobar', 'select', '0', '0|0|1|1|2|2;datatype=numerical');\r
1499 // 編集不可能なテキストエリアオプションを作成\r
1500 $this->createOption('FooBar', 'foobar', 'textarea', 'This textarea is readonly', 'access=readonly');\r
1501 </code></pre>\r
1502 \r
1503 <h2>制限</h2>\r
1504 \r
1505 <ol>\r
1506         <li>オプション名は最大20文字です。</li>\r
1507         <li>オプションの説明文は最大255文字です。</li>\r
1508         <li>オプションの値は制限ありません(v2.2より前のバージョンでは128文字の制限がありました)</li>\r
1509         <li>'=', '|', ';' のキャラクターはセレクトオプション用のセレクトリストやオプション・メタデータ中で使用することはできません。</li>\r
1510 </ol>\r
1511 \r
1512 <h2>メソッド</h2>\r
1513 \r
1514 <h3>createOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>\r
1515 \r
1516 <p><strong>グローバル</strong>なコンテクストで新しいオプションを生成します。</p>\r
1517 \r
1518 <table><tr>\r
1519         <th>パラメータ</th>\r
1520         <th>値</th>\r
1521 </tr><tr>\r
1522         <td>$name</td>\r
1523         <td>オプション名</td>\r
1524 </tr><tr>\r
1525         <td>$desc</td>\r
1526         <td>オプション編集画面で表示される説明文</td>\r
1527 </tr><tr>\r
1528         <td>$type</td>\r
1529         <td>オプションタイプ(前出)</td>\r
1530 </tr><tr>\r
1531         <td>$defValue</td>\r
1532         <td>初期値</td>\r
1533 </tr><tr>\r
1534         <td>$typeExtras</td>\r
1535         <td>オプションタイプの追加情報(前出)</td>\r
1536 </tr></table>\r
1537 \r
1538 <h3>[v2.2] createBlogOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>\r
1539 \r
1540 <p><strong>blog</strong>のコンテクストで新しいオプションを生成します(<code>createOption</code>を参照)。</p>\r
1541 \r
1542 <h3>[v2.2] createCategoryOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>\r
1543 \r
1544 <p><strong>カテゴリー</strong>のコンテクストで新しいオプションを生成します(<code>createOption</code>を参照)。</p>\r
1545 \r
1546 <h3>[v2.2] createMemberOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>\r
1547 \r
1548 <p><strong>メンバー</strong>のコンテクストで新しいオプションを生成します(<code>createOption</code>を参照)。</p>\r
1549 \r
1550 <h3>[v3.2] createItemOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>\r
1551 \r
1552 <p><strong>アイテム</strong>のコンテクストで新しいオプションを生成します(<code>createOption</code>を参照)。</p>\r
1553 \r
1554 <h3>setOption($name, $value)</h3>\r
1555 \r
1556 <p>すでにデータベースに存在するオプションの値を変更します。</p>\r
1557 \r
1558 <table><tr>\r
1559         <th>パラメータ</th>\r
1560         <th>値</th>\r
1561 </tr><tr>               \r
1562         <td>$name</td>\r
1563         <td>オプション名</td>\r
1564 </tr><tr>\r
1565         <td>$value</td>\r
1566         <td>新しい値</td>\r
1567 </tr></table>\r
1568 \r
1569 <h3>[v2.2] setBlogOption($blogid, $name, $value)</h3>\r
1570 \r
1571 <p>blogオプションの値を変更します。<code>blogid</code>属性はどのblogでそのオプションが有効かを示します(その他のオプション:<code>setOption</code>を参照)。</p>\r
1572 \r
1573 <h3>[v2.2] setCategoryOption($catid, $name, $value)</h3>\r
1574 \r
1575 <p>カテゴリーオプションの値を変更します。<code>catid</code>属性はどのカテゴリーでそのオプションが有効かを示します(その他のオプション:<code>setOption</code>を参照)。</p>\r
1576 \r
1577 <h3>[v2.2] setMemberOption($memberid, $name, $value)</h3>\r
1578 \r
1579 <p>メンバーオプションの値を変更します。<code>memberid</code>属性はどのメンバーでそのオプションが有効かを示します(その他のオプション:<code>setOption</code>を参照)。</p>\r
1580 \r
1581 <h3>[v3.2] setItemOption($itemid, $name, $value)</h3>\r
1582 \r
1583 <p>アイテムオプションの値を変更します。<code>itemid</code>属性はどのアイテムでそのオプションが有効かを示します(その他のオプション:<code>setOption</code>を参照)。</p>\r
1584 \r
1585 <h3>getOption($name)</h3>\r
1586 \r
1587 <p>データベース内のオプションの値を返します。</p>\r
1588 \r
1589 <table><tr>\r
1590         <th>パラメータ</th>\r
1591         <th>値</th>\r
1592 </tr><tr>               \r
1593         <td>$name</td>\r
1594         <td>オプション名</td>\r
1595 </tr></table>\r
1596 \r
1597 <h3>[v2.2] getBlogOption($blogid, $name)</h3>\r
1598 \r
1599 <p>blogオプションの値を返します。<code>blogid</code>属性は値がリスエストされたblogを示します(その他のオプション:<code>getOption</code>を参照)。</p>\r
1600 \r
1601 <h3>[v2.2] getCategoryOption($catid, $name)</h3>\r
1602 \r
1603 <p>カテゴリーオプションの値を返します。<code>catid</code>属性は値がリスエストされたカテゴリーを示します(その他のオプション:<code>getOption</code>を参照)。<br />\r
1604 </p>\r
1605 \r
1606 <h3>[v2.2] getMemberOption($memberid, $name)</h3>\r
1607 \r
1608 <p>メンバーオプションの値を返します。<code>memberid</code>属性は値がリスエストされたメンバーを示します(その他のオプション:<code>getOption</code>を参照)。</p>\r
1609 \r
1610 <h3>[v3.2] getItemOption($itemid, $name)</h3>\r
1611 \r
1612 <p>アイテムオプションの値を返します。<code>itemid</code>属性は値がリスエストされたアイテムを示します(その他のオプション:<code>getOption</code>を参照)。</p>\r
1613 \r
1614 <h3>deleteOption($name)</h3>\r
1615 \r
1616 <p>データベースからオプションを削除します。</p>\r
1617 \r
1618 <table><tr>\r
1619         <th>パラメータ</th>\r
1620         <th>値</th>\r
1621 </tr><tr>               \r
1622         <td>$name</td>\r
1623         <td>オプション名</td>\r
1624 </tr></table>\r
1625 \r
1626 <h3>[v2.2] deleteBlogOption($name)</h3>\r
1627 \r
1628 <p>blogオプションを削除します(<code>deleteOption</code>を参照)。</p>\r
1629 \r
1630 <h3>[v2.2] deleteCategoryOption($name)</h3>\r
1631 \r
1632 <p>カテゴリーオプションを削除します(<code>deleteOption</code>を参照)。</p>\r
1633 \r
1634 <h3>[v2.2] deleteMemberOption($name)</h3>\r
1635 \r
1636 <p>メンバーオプションを削除します(<code>deleteOption</code>を参照)。</p>\r
1637 \r
1638 <h3>[v3.2] deleteItemOption($name)</h3>\r
1639 \r
1640 <p>アイテムオプションを削除します(<code>deleteOption</code>を参照)。</p>\r
1641 \r
1642 <h3>[v2.2] getAllBlogOptions($name)</h3>\r
1643 \r
1644 <p>与えられたblogオプションの全ての値を返します。結果は存在するblogidごとの連想配列です。</p>\r
1645 \r
1646 <h3>[v2.2] getAllCategoryOptions($name)</h3>\r
1647 \r
1648 <p>与えられたカテゴリーオプションの全ての値を返します。結果は存在するcatidごとの連想配列です。</p>\r
1649 \r
1650 <h3>[v2.2] getAllMemberOptions($name)</h3>\r
1651 \r
1652 <p>与えられたメンバーオプションの全ての値を返します。結果は存在するmemberidごとの連想配列です。</p>\r
1653 \r
1654 <h3>[v3.2] getAllItemOptions($name)</h3>\r
1655 \r
1656 <p>与えられたアイテムオプションの全ての値を返します。結果は存在するitemidごとの連想配列です。</p>\r
1657 \r
1658 <h3>[v3.2] getBlogOptionTop($name, $amount = 10, $sort = 'desc')</h3>\r
1659 \r
1660 <p>与えられたオプションの最初の値を返します。結果は配列で、各要素がそれぞれのblogid ('id') の値 ('value') を持つ配列になっています。</p>\r
1661 \r
1662 <table><tr>\r
1663         <th>パラメータ</th>\r
1664         <th>値</th>\r
1665 </tr><tr>\r
1666         <td>$name</td>\r
1667         <td>オプション名</td>\r
1668 </tr><tr>\r
1669         <td>$amount</td>\r
1670         <td>必要なオプション数</td>\r
1671 </tr><tr>\r
1672         <td>$sort</td>\r
1673         <td>昇順 ('asc') か降順 ('desc') で並べ替え</td>\r
1674 </tr></table>\r
1675 \r
1676 <h3>[v3.2] getMemberOptionTop($name, $amount = 10, $sort = 'desc')</h3>\r
1677 \r
1678 <p>与えられたオプションの最初の値を返します。結果は配列で、各要素がそれぞれのメンバーID ('id') の値 ('value') を持つ配列になっています(パラメータは<code>getBlogOptionTop</code>を参照)。</p>\r
1679 \r
1680 <h3>[v3.2] getCategoryOptionTop($name, $amount = 10, $sort = 'desc')</h3>\r
1681 \r
1682 <p>与えられたオプションの最初の値を返します。結果は配列で、各要素がそれぞれのカテゴリーID ('id') の値 ('value') を持つ配列になっています(パラメータは<code>getBlogOptionTop</code>を参照)。</p>\r
1683 \r
1684 \r
1685 <h3>[v3.2] getItemOptionTop($name, $amount = 10, $sort = 'desc')</h3>\r
1686 \r
1687 <p>与えられたオプションの最初の値を返します。結果は配列で、各要素がそれぞれのアイテムID ('id') の値 ('value') を持つ配列になっています(パラメータは<code>getBlogOptionTop</code>を参照)。</p>\r
1688 \r
1689 \r
1690 <div class="note">\r
1691 <b>注:</b> プラグインクラス内のコンストラクタから、これらのファンクションを呼ぶことはできません。プラグインがロードされた後にこれらを実行したいときは、かわりに<code>init()</code>メソッド内に置きます。</div>\r
1692 \r
1693 <h1>データベース・テーブル<a name="tables" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
1694 \r
1695 <h2>Nucleusテーブルへのアクセス</h2>\r
1696 \r
1697 <p>v2.0まで、Nucleusテーブルへのアクセスは単に<code>nucleus_</code>と名づけられたテーブルに対してSQL命令を実行するだけのものでした。Nucleusのバージョン2.2以降はカスタム・テーブル名を利用できるようになったため、プラグイン開発に若干注意する必要があります。</p>\r
1698 \r
1699 <ol>\r
1700         <li><code>nucleus_item</code> などの固定されたテーブル名の代わりに、テーブル名のプレフィックスを生成するために <code>sql_table('item') </code>というグローバルファンクションを利用します。</li>\r
1701         <li><code>supportsFeature('SqlTablePrefix')</code> が呼ばれたときにプラグインが1(真)を返すようにします。これがないと、カスタムプレフィックスがセットされている場合でバージョンが2.0より大きいNucleusではプラグインをロードできません(用心のため)。</li>\r
1702 </ol>\r
1703 \r
1704 <p class="note">v2.0までのNucleusではグローバルファンクション <code>sql_table</code> は利用できないことに注意してください。もしこのメソッドを用いつつ、プラグインをv2.0以下のNucleusで動作させたい場合は、以下のコードをプラグインクラスの前に追加してください。</p>\r
1705 \r
1706 <pre class="example"><code>&lt;?\r
1707 \r
1708 // プラグインがNucleusバージョン2.0以下と互換性を持つために必要\r
1709 if (!function_exists('sql_table'))\r
1710 {\r
1711         function sql_table($name) {\r
1712                 return 'nucleus_' . $name;\r
1713         }\r
1714 }\r
1715 \r
1716 class NP_HelloWorld extends NucleusPlugin {\r
1717 ...\r
1718 }\r
1719 \r
1720 ?&gt;</code></pre>\r
1721 \r
1722 <h2>独自テーブル</h2>\r
1723 \r
1724 <p>もしプラグイン独自のテーブルが必要なら、<code>install</code>メソッドの中で独自テーブルを生成し、<code>unInstall</code>メソッドの中でそれを削除するようにします。</p>\r
1725 \r
1726 <p>いくつかの注意点</p>\r
1727 <ul>\r
1728         <li><code>nucleus_plug_<em>plugname</em></code> のように、他のプラグインと競合しないテーブル名を考えてください。カスタムプレフィックスに対応するため、テーブル名を\r
1729         <code>sql_table('plug_plugname')</code> で生成してください。\r
1730         </li>\r
1731         <li>自分自身でデータベース接続をする必要はありません。PHPコマンド <code>mysql_query()</code> を使ってSQL命令を実行できます。</li>\r
1732         <li>自分でデータベース接続をする場合、後でNucleusデータベースへの接続を復元するようにしてください。自前処理の後で <code>sql_connect()</code>  を呼ぶことで可能です。頻繁な再接続を避けるために、コンストラクタでそれを行うのも良いです。<code>$this- &gt;db</code>のリンクIDを保持でき、各クエリにそれを渡すことができます。</li>\r
1733         <li>バックアップ機能を使う時は、独自テーブルもバックアップに含めるよう、<code>getTableList()</code> を再定義してください。</li>\r
1734 </ul>\r
1735 \r
1736 <h1>プラグイン管理エリア<a name="admin" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
1737 \r
1738 <p>Ver2.5から、Nucleusの管理エリアに統合されたプラグイン管理エリアを作成できます。これらのページは従来のプラグイン管理ページや左側のクイックメニューからアクセスできます。</p>\r
1739 \r
1740 <h2>基本</h2>\r
1741 \r
1742 <p>管理エリアを提供するには、次のステップが必要です。</p>\r
1743 \r
1744 <ol>\r
1745   <li>プラグインディレクトリに<strong>プラグイン名</strong>のサブディレクトリを作ります。たとえばプラグイン名が<code>NP_PluginName</code>なら、'pluginname'です。ディレクトリ名はすべて小文字で!</li>\r
1746   <li>\r
1747         そのディレクトリで、次のような<strong>index.php</strong>を用意します。\r
1748         <pre><code>&lt;?php\r
1749 \r
1750         // if your 'plugin' directory is not in the default location,\r
1751         // edit this variable to point to your site directory\r
1752         // (where config.php is)\r
1753         $strRel = '../../../';\r
1754 \r
1755         include($strRel . 'config.php');\r
1756         if (!$member->isLoggedIn())\r
1757                 doError('You¥'re not logged in.');\r
1758 \r
1759         include($DIR_LIBS . 'PLUGINADMIN.php');\r
1760 \r
1761         // create the admin area page\r
1762         $oPluginAdmin = new PluginAdmin('<strong>PluginName</strong>');\r
1763         $oPluginAdmin->start();\r
1764 \r
1765         echo '&lt;h2&gt;プラグイン名&lt;/h2&gt;';\r
1766 \r
1767         echo '&lt;p&gt;<strong>ページ内容</strong>&lt;p&gt;';\r
1768 \r
1769         $oPluginAdmin->end();\r
1770 \r
1771 ?&gt;</code></pre>\r
1772   </li>\r
1773   <li>\r
1774         プラグイン側に次のコードを挿入し、クイックメニューイベントに登録します。\r
1775     <pre><code>function event_QuickMenu(&amp;$data) {\r
1776                 array_push(\r
1777                         $data['options'],\r
1778                         array(\r
1779                                 'title' => '<strong>プラグイン名</strong>',\r
1780                                 'url' => $this->getAdminURL(),\r
1781                                 'tooltip' => '<strong>ツールチップテキスト</strong>'\r
1782                         )\r
1783                 );\r
1784         }</code></pre>\r
1785   </li>\r
1786   <li>\r
1787         プラグイン側に次の関数を記述します。\r
1788     <pre><code>function hasAdminArea()\r
1789 {\r
1790         return 1;\r
1791 }</code></pre>\r
1792   </li>\r
1793 </ol>\r
1794 \r
1795 <h2>考慮すること</h2>\r
1796 \r
1797 <ul>\r
1798  <li>登録できるからといって安易にクイックメニューへ登録しないこと。クイックメニューにプラグインが100個並んだりしたらかなりウンザリするでしょう。ですので、クイックメニューに登録する場合でも、クイックメニュー登録を有効・無効化するプラグインオプションを(グローバルまたはメンバーオプションで)用意することを考えてください。</li>\r
1799  <li><code>プラグインディレクトリが nucleus/plugins/ ではない場合は、index.php内の $strRel</code> 変数は手動で書き換える必要があります。</li>\r
1800  <li>管理エリアのアウトプットが<strong>正しいXHTML</strong>になっているか確認してください。正しくないと、MozillaなどのGeckoベースのブラウザでページ表示が崩れます。</li>\r
1801 </ul>\r
1802 \r
1803 <h2>PluginAdmin クラス</h2>\r
1804 \r
1805 <p><code>PluginAdmin</code> クラスは助けになります。これを一度生成すれば、<code>$oPluginAdmin->plugin</code> でプラグインのインスタンスにアクセスできます。</p>\r
1806 \r
1807 <h1>プラグイン用ヘルプページ <a name="help" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
1808 \r
1809 <p>Nucleus v3.2から、プラグインの機能の概要、利用できるスキン・テンプレート変数、さらに詳細な情報のありかなどを示すヘルプページを提供可能になりました。</p>\r
1810 \r
1811 <p>ヘルプページは管理画面のプラグイン一覧からアクセス可能になります。</p>\r
1812 \r
1813 <h2>基本</h2>\r
1814 <p>ヘルプページを提供するために、次のステップが必要です。</p>\r
1815 <ol>\r
1816 <li>プラグインディレクトリに、プラグイン名をつけたサブディレクトリを作成します。ディレクトリ名は小文字であることに注意します。<a href="#admin">管理エリア</a>を作るときと同様です。</li>\r
1817 <li>そのディレクトリの中に help.html を作り、プラグインについての文章を記述します。次の雛型からはじめると良いでしょう。\r
1818 <pre><code>&lt;h3&gt;プラグインの概要&lt;/h3&gt;\r
1819 \r
1820 &lt;p&gt;このプラグインはヘルプページがいかに機能するかを示すためだけのものです&lt;/p&gt;\r
1821 \r
1822 &lt;h3&gt;インストール&lt;/h3&gt;\r
1823 \r
1824 &lt;p&gt;これを読めてるならインストールは正しく出来てます :-)&lt;/p&gt;\r
1825 \r
1826 &lt;h3&gt;スキン変数&lt;/h3&gt;\r
1827 \r
1828 &lt;p&gt;このプラグインはただのテストケースなのでスキン・テンプレート変数はありませんが、書くとすれば。\r
1829 \r
1830 &lt;ul&gt;&lt;li&gt;&lt;b&gt;&lt;%HelpPageTestCase1%&gt;&lt;/b&gt;: なにかをする&lt;/li&gt;\r
1831 &lt;li&gt;&lt;b&gt;&lt;%HelpPageTestCase1(foobar)%&gt;&lt;/b&gt;: 別のなにかをする&lt;/li&gt;&lt;/ul&gt;&lt;/p&gt;\r
1832 \r
1833 &lt;h3&gt;サポートとバグ報告&lt;/h3&gt;\r
1834 \r
1835 &lt;p&gt;さらなるサポートやバグ報告のために、次のフォーラムのスレッドを利用してください。\r
1836 &lt;a href="http://forum.nucleuscms.org/viewtopic.php?t=&lt;トピックID&gt;"&gt;\r
1837 http://forum.nucleuscms.org/viewtopic.php?t=&lt;トピックID&gt;&lt;/a&gt;&lt;/p&gt;\r
1838 \r
1839 &lt;h3&gt;バージョン履歴&lt;/h3&gt;\r
1840 \r
1841 &lt;ul&gt;&lt;li&gt;Version 0.1: 最初のテストケースバージョン&lt;/li&gt;\r
1842 &lt;li&gt;Version 0.0: その前のバージョン ;-)&lt;/li&gt;&lt;/ul&gt;</code></pre>\r
1843 </li>\r
1844 <li>supportsFeature('HelpPage') で0より大きい数字を返すように設定します。\r
1845 <pre><code>function supportsFeature($what) {\r
1846         switch($what) {\r
1847         case 'HelpPage':\r
1848                 return 1;\r
1849           default:\r
1850                 return 0;\r
1851         }\r
1852   }</code></pre>\r
1853 </li>\r
1854 </ol>\r
1855 \r
1856 <h1>プラグイン依存チェック <a name="dependency" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>\r
1857 \r
1858 <p>v3.2から、他のプラグインとの依存関係を宣言する新しいプラグインインターフェイスが追加されました。他のプラグインの機能を必要とするプラグインに利用できます。特に依存関係が成立しなくて正しく機能しない状態を検知するときに便利です。</p>\r
1859 \r
1860 <h2>この機能を利用するプラグインの書き方</h2>\r
1861 \r
1862 <p>現実世界での例からはじめましょう。</p>\r
1863 \r
1864 <p>NP_PageLinkList は NP_BlogWithOffset の機能を利用するため、利用者には NP_BlogWithOffset のインストール後に NP_PageLinkList をインストールさせたいとします。NucleusはこのAPIによって、インストール前に依存関係を検知させる方法をプラグインに提供します。</p>\r
1865 \r
1866 <p>このケースでは、NP_PageLinkList 側に NP_BlogWithOffset が必要だということを認識させるコードを埋め込みます。プラグインがインストールされる際に、Nucleusコアは <code>getPluginDep()</code> というファンクションを呼び出します。このファンクションは必要なプラグインのリストを返し、コアはインストール済みのプラグインをチェックして、もし依存関係に欠如があればインストールを拒否します。</p>\r
1867 \r
1868 <p>必要なことは NP_PageLinkList にこのファンクションを追加する、ただそれだけです。</p>\r
1869 \r
1870 <pre><code>function getPluginDep() {\r
1871          return array('NP_BlogWithOffset');\r
1872 }</code></pre>\r
1873 \r
1874 <p>このプラグイン依存チェックは、他のプラグインが依存しているプラグインがアンインストールされることも防ぎます。</p>\r
1875 \r
1876 </body>\r
1877 </html>\r
1878 \r
1879 \r