1 <?xml version="1.0" encoding="UTF-8"?>
\r
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja-JP" xml:lang="ja-JP">
\r
6 Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)
\r
7 Copyright (C) 2002-2009 The Nucleus Group
\r
9 This program is free software; you can redistribute it and/or
\r
10 modify it under the terms of the GNU General Public License
\r
11 as published by the Free Software Foundation; either version 2
\r
12 of the License, or (at your option) any later version.
\r
13 (see nucleus/documentation/index.html#license for more info)
\r
15 @license http://nucleuscms.org/license.txt GNU General Public License
\r
16 @copyright Copyright (C) 2002-2009 The Nucleus Group
\r
19 <!-- $NucleusJP: plugins.html,v 1.9 2007/02/04 06:28:45 kimitake Exp $ -->
\r
20 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
\r
21 <meta http-equiv="Content-Style-Type" content="text/css" />
\r
22 <meta http-equiv="Content-Script-Type" content="text/javascript" />
\r
23 <link rel="index" href="./index.html" />
\r
24 <title>Nucleus - プラグイン API</title>
\r
25 <link rel="stylesheet" type="text/css" href="styles/manual.css" />
\r
26 <style type="text/css">
\r
27 /* refence parameters (greenish) */
\r
29 background-color: #c9f2d4;
\r
35 /* object parameters */
\r
43 content: " (object)";
\r
46 /* read-only parameters (non-ref; reddish) */
\r
48 background-color: #ffddce;
\r
54 list-style-image:none;
\r
55 list-style-type:none;
\r
60 <script src="http://www.google.com/jsapi"></script>
\r
61 <script type="text/javascript">
\r
62 google.load("jquery", "1");
\r
63 google.setOnLoadCallback(function() {
\r
64 $.getScript("javascript/fontsizeChanger.js");
\r
69 <div id="fontSizeChanger">
\r
70 <a href="#top" id="f_small">小</a>
\r
71 <a href="#top" id="f_medium">中</a>
\r
72 <a href="#top" id="f_large">大</a>
\r
76 <div class="heading">
\r
77 <a id="top" name="top">プラグイン API</a>
\r
81 <div class="note-trans"><strong>訳者注:</strong>
\r
83 <li>このドキュメントの原文は以下のURLにあります。<br />
\r
84 <a href="http://nucleuscms.org/documentation/devdocs/plugins.html">http://nucleuscms.org/documentation/devdocs/plugins.html</a></li>
\r
85 <li>誤訳にお気づきの方は<a href="http://japan.nucleuscms.org/bb/viewforum.php?f=7">NucleusCMS日本語フォーラム</a>までご連絡いただけると助かります。</li>
\r
89 <div class="note"><strong>注:</strong>
\r
91 <li>このドキュメントは基本的なプラグインの書き方についての情報を提供しています。さらに質問がある方は <a href="http://forum.nucleuscms.org/viewforum.php?f=10">Plugin
\r
92 Development Forum</a> (<a href="http://japan.nucleuscms.org/bb/viewforum.php?f=5">日本語フォーラム</a>)をご覧ください。</li>
\r
93 <li>Nucleusバージョン1.5以降に導入されたメソッドとイベントには、導入時のバージョン情報を付記しています。それらの機能を利用するときは、<code>getMinNucleusVersion</code> を適切に設定するのを忘れないでください。</li>
\r
100 <a href="./index.html">開発者向けドキュメントの目次へ戻る</a>
\r
104 このドキュメントはNucleusプラグインの作り方についての解説です。
\r
107 <h1><a id="toc" name="toc">目次</a></h1>
\r
110 <li><a href="#introduction">イントロダクション</a></li>
\r
111 <li><a href="#firstplug">はじめてプラグインを書いてみる</a></li>
\r
112 <li><a href="#nucleusplugin"><code>NucleusPlugin</code> クラスの概要</a></li>
\r
113 <li><a href="#skinvars"><code><%plugin(...)%></code> スキン変数</a></li>
\r
114 <li><a href="#templatevars"><code><%plugin(...)%></code> テンプレート変数</a></li>
\r
115 <li><a href="#actions"><code>action.php</code> を使ったアクション</a></li>
\r
116 <li><a href="#events">イベントとイベント登録の仕方</a></li>
\r
117 <li><a href="#options">オプションを保存する</a></li>
\r
118 <li><a href="#tables">データベース・テーブル</a></li>
\r
119 <li><a href="#admin">プラグイン管理エリアの提供</a></li>
\r
120 <li><a href="#help">ヘルプページの提供</a></li>
\r
121 <li><a href="#dependency">プラグイン依存チェック</a></li>
\r
122 <li><a href="#internationalization">プラグインの国際化</a></li>
\r
123 <li><a href="#skinvar-formatting">スキン変数の出力の書式</a></li>
\r
124 <li><a href="#additional-reading">追記事項</a></li>
\r
125 <!-- <li><a href="#parser">Using the <code>PARSER</code> class</a></li>
\r
126 <li><a href="#"></a></li>
\r
127 <li><a href="#"></a></li>
\r
128 <li><a href="#"></a></li>-->
\r
131 <h1>イントロダクション <a id="introduction" name="introduction" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
134 Nucleusプラグインによって、誰もがNucleusの提供する機能を、Nucleus内部のPHPコードを変更することなく拡張することができます。プラグインはあるメソッドを実装したシンプルなPHPスクリプトで、Nucleusユーザー同士で簡単に交換することができます。インストールは簡単で、プラグインディレクトリにファイルをアップし、Nucleusにそれを認識させるだけです。
\r
142 <li>実装について詳しくしらなくてもNucleusフレームワークに簡単に機能を追加できる</li>
\r
143 <li>必要なプラグインだけをインストールでき、ページ生成にかかる時間を節約できる</li>
\r
147 すべてのプラグインファイルは <code>config.php</code> に記述されたディレクトリに置く必要があります。一般的に、それは <code>/your/path/nucleus/plugins/</code> になるでしょう。プラグインファイル名は <code>NP<em>_name</em>.php</code> という形式を用いることにより認識されます。プラグインによっては、追加ファイルを格納する同名のサブディレクトリや、管理エリアを必要とします。
\r
151 <strong>注:</strong> プラグイン名は大文字・小文字を識別しますので、<code>Np_</code> や <code>np_</code> ではなく、<code>NP_</code> で始まることに気をつけてください。またプラグインがサブディレクトリを使用する場合は、サブディレクトリの名称は<em>すべて小文字にします</em>。
\r
157 <h1>はじめてプラグインを書いてみる<a id="firstplug" name="firstplug" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
160 では、シンプルなプラグインを書いてみましょう。基本的にプラグインは、あらかじめ定義された <code>NucleusPlugin</code> クラスを継承したPHPクラスです。以下は<code>HelloWorld</code>プラグインの例です。
\r
163 <pre class="example"><code><?php
\r
165 class NP_HelloWorld extends NucleusPlugin
\r
170 return 'Hello World';
\r
174 function getAuthor()
\r
176 return 'Wouter Demuynck';
\r
180 // mailto:foo@bar.com の形式も可
\r
183 return 'http://nucleuscms.org/';
\r
187 function getVersion()
\r
192 // インストール済みのプラグインリストに表示される説明文
\r
193 function getDescription()
\r
195 return 'Just a sample plugin.';
\r
198 function doSkinVar($skinType)
\r
200 echo 'Hello World!';
\r
203 function supportsFeature ($what)
\r
207 case 'SqlTablePrefix':
\r
221 このコードをコピーし、 <code>NP_HelloWorld.php</code> と名づけて保存し、プラグインディレクトリに置きます。<em>最後の <code>?></code> の後や、最初の <code><?php</code> の前にスペースがないことを確認しましょう</em>。ところでNP は "Nucleus Plugin" って意味ですよ :-) 念のため。
\r
223 <li>Nucleusの管理画面を開き、<em>Nucleusの管理>プラグインの管理</em>にいきます。</li>
\r
224 <li><em>HelloWorld</em> プラグインがインストール可能な状態になっているはずですので、インストールします。すべてがうまくいけば、インストール済みプラグインリストに追加されます。</li>
\r
226 あなたのスキンの1つを編集し、実際のページに表示する箇所に次の文を挿入します。
\r
227 <pre class="example"><code><%HelloWorld%></code></pre>
\r
228 注意:カッコ内の名称 (<code>HelloWorld</code>) は大文字小文字を識別します!
\r
230 <li>さて、編集したスキンから生成されるページを見てみましょう。プラグイン変数を追加した場所に "Hello World" と見えますね?</li>
\r
234 ここまではそれほど難しくなかったと思います。さらに読み進めて理解してください。
\r
243 <h1>NucleusPlugin クラスの概要 <a id="nucleusplugin" name="nucleusplugin" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
245 <p>すべてのプラグインは、<code>NucleusPlugin</code> というPHPクラスを継承しなければなりません。難しそうに聞こえても心配ご無用、大丈夫です。このPHPクラスの継承によって、プラグインに必要なメソッドだけを実装でき、いくつかの補助ファンクションにアクセスでき、つまりはあなたの人生はよりラクになります。</p>
\r
247 <p>下記は <code>NucleusPlugin</code> が提供する、再実装可能なメソッドの概要です。このクラス自身のソースコードを見たければ、<code>nucleus/libs/PLUGIN.php</code>にあります。</p>
\r
249 <table summary="An overview of the redefinable methods in the class NucleusPlugin">
\r
250 <caption><code>NucleusPlugin</code> クラスの概要(再定義可能なメソッド)</caption>
\r
252 <th abbr="method">メソッド名</th><th abbr="desc">説明</th>
\r
255 <td><code>getName()</code></td>
\r
256 <td>プラグイン名を返します。インストール済みプラグインリストに表示されます。デフォルトの実装では <code>Undefined</code> を返すため、必ず再定義されないといけません。</td>
\r
259 <td><code>getAuthor()</code></td>
\r
260 <td>プラグインの作者名を返します。インストール済みプラグインリストに表示されます。デフォルトの実装では <code>Undefined</code> を返すため、必ず再定義されないといけません。</td>
\r
263 <td><code>getURL()</code></td>
\r
264 <td>プラグインをダウンロード可能な、またはプラグインの追加情報のあるサイトのURLを返します。そのようなサイトがない場合は作者のメールアドレスへの mailto:リンクが適切です。デフォルトの実装では <code>Undefined</code> を返すため、必ず再定義されないといけません。</td>
\r
267 <td><code>getDescription()</code></td>
\r
268 <td>プラグインに関する説明文(長文)を返します。インストール済みプラグインリストに表示されます。デフォルトの実装では <code>Undefined</code> を返します。</td>
\r
271 <td><code>getVersion()</code></td>
\r
272 <td>プラグインの現在のバージョンを返します。デフォルトは <code>0.0</code> を返します。</td>
\r
275 <td><code>getMinNucleusVersion()</code></td>
\r
276 <td>(v2.0b) 最低限必要なNucleusのバージョンを返します。デフォルトは <code>155</code> (v1.55)を返します。後に導入されたプラグイン関連機能を利用している場合は、このファンクションを実装するようお願いします(例: v2.0 => 200)。ただし、Nucleus v1.55 はこのファンクションを使用しないため、新機能を利用したプラグインが(対応する前のシステムに)インストールされる可能性が残っています。</td>
\r
279 <td><code>getMinNucleusPatchLevel()</code></td>
\r
280 <td>(v3.1) 最低限必要なNucleusのバージョン(<code>getMinNucleusVersion</code>)での、最低限必要なパッチレベルを返します。デフォルトは <code>0</code> を返します。このファンクションは主に新しいプラグインの機能がNucleusの最新版のパッチによって可能になる場合に用いられます。</td>
\r
283 <td><code>init()</code></td>
\r
284 <td>プラグインを初期化します。このメソッドはプラグインオブジェクトが生成された直後に呼び出され、<code>plugid</code>属性がセットされます。デフォルトではこのメソッドは何もしません。</td>
\r
287 <td><code>doSkinVar($skinType)</code></td>
\r
288 <td><code><%plugin(...)%></code> スキン変数によってプラグインが呼び出されたときにこのメソッドが呼ばれます。<code>$skinType</code> パラメータはプラグインが呼ばれた場所のスキンタイプに該当します(<code>item</code>, <code>archive</code>, ...)。パラメータが一つしかないことに混乱しないでください。複数パラメータを渡すことも<strong>可能</strong>です。<a href="#skinvars"><code>doSkinVar</code> メソッドの実装に関する詳細情報はこちら</a>。デフォルトではこのメソッドはなにも出力しません。</td>
\r
291 <td><code>doTemplateVar(&$item)</code></td>
\r
292 <td>基本的に <code>doSkinVar</code> と同じですが、今度は<em>テンプレート</em>内(<code>item header/body/footer</code> と <code>dateheader/footer</code>)での<code><%plugin(...)%></code> 変数からの呼び出しになります。デフォルトではこのメソッドはテンプレートをスキンタイプとみなして<code>doSkinVar</code> メソッドに処理を渡します。<a href="#templatevars"><code>doTemplateVar</code> メソッドの実装に関する詳細情報はこちら</a></td>
\r
295 <td><code>doTemplateCommentsVar(&$item, &$comment)</code></td>
\r
296 <td>(v2.0b) 基本的に <code>doSkinVar</code> と同じですが、今度は<em>テンプレート</em>内(コメント部分)での<code><%plugin(...)%></code> 変数からの呼び出しになります。デフォルトではこのメソッドはテンプレートをスキンタイプとみなして<code>doSkinVar</code> メソッドに処理を渡します。<a href="#templatevars"><code>doTemplateCommentsVar</code>メソッドの実装に関する詳細情報はこちら</a></td>
\r
299 <td><code>doItemVar(&$item, &$param)</code></td>
\r
300 <td>(v3.30) 基本的に <code>doSkinVar</code> と同じですが、今度は<em>投稿した記事</em>内での<code><%plugin(...)%></code> 変数からの呼び出しになります。渡される引数のうち<code>&$item</code>は変数が記述されているアイテムのフルオブジェクトを、<code>&$param</code>はプラグインごとの関数のパラメータになります。</td>
\r
303 <td><code>doIf($key, $value)</code></td>
\r
304 <td>(v3.30) スキン変数 <code>if/ifnot/elseif/elseifnot</code> に対して、プラグイン独自の判断をする事が出来るメソッドです。通常は、<code>$key</code> 変数が <code>$value</code> の値を持っているかを調べて、 <code>true</code> か <code>false</code> を返すことになります。このメソッドをプラグインに実装する場合は、作者は使用方法のドキュメントを書くようにしてください。</td>
\r
307 <td><code>doAction($type)</code></td>
\r
308 <td>プラグインがユーザーインタラクションを求めたとき、 <code>action.php</code>を介してこのメソッドがそれを与えます。これはNucleus自身が新しいコメントや投票を処理するのに使用するスクリプトです。正しいパラメータを用いることで、プラグインからの <code>doAction</code> メソッドを呼び出せます。<code>$type</code> はオプションのメッセージタイプに該当します。<code>doAction</code> メソッド内で、リクエストからの追加の変数にアクセスできます。デフォルトではこのメソッドがエラーメッセージをトリガーすると<code>'No Such Action'</code>という文字列を返します。<a href="#actions"><code>doAction</code> に関する詳細情報はこちら</a></td>
\r
311 <td><code>install()</code></td>
\r
312 <td>このメソッドはプラグインがインストールされた際に呼ばれます。データベース・テーブルの生成やプラグインオプションの生成などの初期化作業を行うことができます。デフォルトではこのメソッドは何もしません。</td>
\r
315 <td><code>unInstall()</code></td>
\r
316 <td>プラグインがアンインストールされた際に呼ばれます。この時点でデータベースに作られたプラグイン情報を消去すると良いです。デフォルトではこのメソッドは何もしません。</td>
\r
319 <td><code>getEventList()</code></td>
\r
320 <td>プラグインはイベント登録が可能です。イベントはNucleusが何かアクションを起こすたびに生成されます。たとえば、<code>AddItem</code> イベントは、このイベントを登録しているすべてのプラグインを呼び出します。呼び出されるメソッドは <code>event_AddItem($params)</code>になります。 <code>$params</code> パラメータは、例えば <code>AddItem</code> の <code>itemid</code> のような、情報フィールドを複数持つ連想配列です。デフォルトではどのイベントにも登録されていないことを示す空の配列を返します。<a href="#events">イベントに関する詳細情報はこちら</a></td>
\r
323 <td><code>getTableList()</code></td>
\r
324 <td>このメソッドはプラグインが生成したデータベース・テーブルの配列を返します。これはNucleusが提供するバックアップ機能で利用されるので、プラグインテーブルをバックアップに含めることができます。デフォルトでは空の配列を返します。</td>
\r
327 <td><code>hasAdminArea()</code></td>
\r
328 <td>プラグインが独自の管理エリアをもつ場合 1 を、そうでない場合 0 を返します。デフォルトでは <code>0</code> を返します。</td>
\r
331 <td><code>getPluginDep()</code></td>
\r
332 <td>(v3.2) プラグイン名の配列を返します。Nucleusはこれらのプラグインが前もってインストールされてない場合、プラグインのインストールを拒否します。デフォルトでは空の配列が返されます。<a href="#dependency">プラグイン依存に関する詳細情報はこちら</a></td>
\r
336 <p>実装可能なメソッドの次は、<code>NucleusPlugin</code> クラスが提供する、再実装<strong>すべきでない</strong>幾つかの特殊メソッドです。これらはプラグイン内で、<code>$this->functionName()</code>シンタックスを利用して呼び出します。</p>
\r
338 <table summary="An overview of the auxiliary methods in the class NucleusPlugin. You should NOT redefine these">
\r
339 <caption><code>NucleusPlugin</code> クラスの概要(再定義不可能なメソッド)</caption>
\r
341 <th abbr="method">メソッド名</th><th abbr="desc">説明</th>
\r
346 <li><code>createOption(...)</code></li>
\r
347 <li><code>createBlogOption(...)</code>(v2.2)</li>
\r
348 <li><code>createCategoryOption(...)</code>(v2.2)</li>
\r
349 <li><code>createMemberOption(...)</code>(v2.2)</li>
\r
350 <li><code>createItemOption(...)</code>(v3.2)</li>
\r
353 <td><a href="#options" title="More info on options">新しいオプションを生成します。</a></td>
\r
358 <li><code>deleteOption(...)</code></li>
\r
359 <li><code>deleteBlogOption(...)</code>(v2.2)</li>
\r
360 <li><code>deleteCategoryOption(...)</code>(v2.2)</li>
\r
361 <li><code>deleteMemberOption(...)</code>(v2.2)</li>
\r
362 <li><code>deleteItemOption(...)</code>(v3.2)</li>
\r
365 <td><a href="#options" title="More info on options">オプションを削除します。</a></td>
\r
370 <li><code>setOption(...)</code></li>
\r
371 <li><code>setBlogOption(...)</code>(v2.2)</li>
\r
372 <li><code>setCategoryOption(...)</code>(v2.2)</li>
\r
373 <li><code>setMemberOption(...)</code>(v2.2)</li>
\r
374 <li><code>setItemOption(...)</code>(v3.2)</li>
\r
377 <td><a href="#options" title="More info on options">オプションに値をセットします。</a></td>
\r
382 <li><code>getOption(...)</code></li>
\r
383 <li><code>getBlogOption(...)</code>(v2.2)</li>
\r
384 <li><code>getCategoryOption(...)</code>(v2.2)</li>
\r
385 <li><code>getMemberOption(...)</code>(v2.2)</li>
\r
386 <li><code>getItemOption(...)</code>(v3.2)</li>
\r
389 <td><a href="#options" title="More info on options">オプションの値を取得します。</a></td>
\r
394 <li><code>getAllBlogOptions(...)</code>(v2.2)</li>
\r
395 <li><code>getAllCategoryOptions(...)</code>(v2.2)</li>
\r
396 <li><code>getAllMemberOptions(...)</code>(v2.2)</li>
\r
397 <li><code>getAllItemOptions(...)</code>(v3.2)</li>
\r
400 <td><a href="#options" title="More info on options">与えられたオプションにより、すべての値(コンテクストごとの一つの値)の連想配列を返します。</a></td>
\r
406 <li><code>getBlogOptionTop(...)</code>(v3.2)</li>
\r
407 <li><code>getMemberOptionTop(...)</code>(v3.2)</li>
\r
408 <li><code>getCategoryOptionTop(...)</code>(v3.2)</li>
\r
409 <li><code>getItemOptionTop(...)</code>(v3.2)</li>
\r
412 <td><a href="#options" title="More info on options">与えられたオプションにより、すべての値のうちの最初の値を返します。</a></td>
\r
415 <td><code>getID()</code></td>
\r
416 <td>このプラグインのIDを返します(このIDはNucleus内部で利用されるものです)。</td>
\r
419 <td><code>getAdminURL()</code></td>
\r
420 <td>プラグインの管理エリアが置かれたURLを返します(そのような管理エリアがない場合は、この情報は無効です)。</td>
\r
423 <td><code>getDirectory()</code></td>
\r
424 <td>プラグインの追加ファイルが格納されたサーバーのファイルシステムのパスを返します(そのようなファイルがない場合は、この情報は無効です)。結果は"<code>.../nucleus/plugins/<em>plugname</em>/</code>"のようになります。</td>
\r
427 <td><code>getShortName()</code></td>
\r
428 <td>"NP_"部分を省き、全てを小文字にしたプラグインのクラス名を返します。この情報は <code>getAdminURL</code> と <code>getDirectory</code> で使用されます。</td>
\r
433 <h1>スキン変数<a id="skinvars" name="skinvars" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
438 独自のスキン変数を生成し、<code><%plugin(<em>PlugName,parameters</em>)%></code> または <code><%PlugName(parameters)%></code>で呼び出すことが出来ます(すでに存在するスキン変数とかぶらない場合)。パラメータはカンマ区切りです。
\r
442 スキン変数を扱うには、<code>doSkinVar</code> メソッドを実装する必要があります。いくつかの例を以下に示します。
\r
445 <pre class="example"><code>function doSkinVar($skinType)
\r
446 function doSkinVar($skinType, $param1, $param2)
\r
447 function doSkinVar($skinType, $skinVar, $param1, $param2)
\r
448 function doSkinVar($skinType, $skinVar, $param1 = 'default value')</code></pre>
\r
451 <li><code>$skinType</code> パラメータは、'index', 'item', 'archive', 'archivelist', 'member', 'error', 'search', 'imagepopup', <a href="#templatevars" title="Information on templatevars">'template'</a>のうちの一つを取ります</li>
\r
452 <li><code>$skinVar</code> は、スキン変数のタイプとして解釈される実質的に最初のパラメータになります(例:<code><%plugin(PlugName,VarType)%></code>)。</li>
\r
453 <li><code>doSkinVar()</code>(パラメータ無し)を使い、PHPファンクションの<code>func_get_args()</code>を用いてパラメータを取得することができます。引数の数の異なる、タイプの違うスキン変数を扱うときに便利です。</li>
\r
459 <li>(v2.0b) グローバル変数としてパースされている <code>$currentSkinName</code> を使ってスキンの名前を取得できます。</li>
\r
465 <h1>テンプレート変数<a id="templatevars" name="templatevars" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
470 テンプレートプラグイン変数はスキンプラグイン変数と同様に働きますが以下の2点が異なります。</p>
\r
473 <li>スキン内ではなくテンプレート内から呼ばれます。</li>
\r
474 <li>$skinTypeパラメータを取りません。代わりに現在パースされているアイテムやコメントの情報付きの追加パラメータを取ります。
\r
476 <li><code>doTemplateVar</code> メソッドは <code>&$item</code> パラメータを取ります。</li>
\r
477 <li><code>doTemplateCommentsVar</code> メソッドは <code>&$item</code> と <code>&$comment</code> パラメータを取ります。</li>
\r
479 <strong>&マークに注意!</strong>
\r
483 <p>テンプレート変数はスキン変数と同じ要領で呼ばれます(<code><%plugin(PlugName,parameters)%></code> または <code><%PlugName(parameters)%></code>)。
\r
487 デフォルトでは、全てのテンプレート変数は'<code>template</code>'を<code>skintype</code>パラメータとして、<code>doSkinVar</code> メソッドに渡ります。
\r
491 独自の実装を提供したい場合は、<code>doTemplateVar</code> メソッドや <code>doTemplateCommentsVar</code> メソッドを再定義する必要があります。<code>skintype</code>パラメータが無くなる以外はdoSkinVarと同様に働きます。
\r
494 <pre class="example"><code>function doTemplateVar(&$item)
\r
495 function doTemplateVar(&$item, $param1, $param2)
\r
496 function doTemplateVar(&$item, $type, $param1, $param2)
\r
497 function doTemplateVar(&$item, $type, $param1 = 'default value')
\r
498 function doTemplateCommentsVar(&$item, &$comment)
\r
499 function doTemplateCommentsVar(&$item, &$comment, $param1, $param2)
\r
500 function doTemplateCommentsVar(&$item, &$comment, $type, $param1, $param2)
\r
501 function doTemplateCommentsVar(&$item, &$comment, $type, $param1 = 'default value')</code></pre>
\r
506 <li>(v2.0b) グローバル変数として内部で利用される <code>$currentSkinName</code> を使ってテンプレートの名前を取得できます。</li>
\r
512 <h1>アクション<a id="actions" name="actions" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
514 <p>プラグインは <code>action.php</code> を通してアクションを行うことができ、同様のスクリプトがコメントや投票の受け取りにも使用されてます。GETまたはPOSTのどちらかを通して呼び出せます。必要なパラメータは<code>action</code>('plugin'と指定)、<code>name</code>(プラグイン名)、<code>type</code>(リクエストされたアクションの種類)です。</p>
\r
516 <p>これらのアクションを有効にするために、<code>doAction($actionType)</code> メソッドをプラグイン内で実装する必要があります。リクエストからの追加パラメータは<code>requestVar('<em>name</em>')</code> で取得できます(<code>requestVar</code> はPHPが付加する magic_quotes_gpc に配慮しています)。</p>
\r
519 <code>doAction</code> メソッドが文字列を返すとき、エラーとして解釈され、エラーメッセージが表示されます。
\r
527 <h1>イベント<a id="events" name="events" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
530 Nucleusプラグインはなにか重要なことが起きたときに発生するイベントに登録可能です。プラグインはイベント発生の際にアクションを実行したり、テキストを出力したりできます。
\r
536 下記は <code>PreAddComment</code> イベント(blogにコメントが追加される直前に生成されるイベント)にプラグインが登録する例です。
\r
539 <pre class="example"><code>class NP_Acronyms extends NucleusPlugin {
\r
541 function getEventList() { return array('PreAddComment'); }
\r
543 function event_PreAddComment(&$data) {
\r
545 $data['comment']['body'] =
\r
547 '<acronym title="HyperText Markup Language">HTML</acronym>',
\r
548 $data['comment']['body']);
\r
553 <p>このプラグインはコメント中の'HTML'というテキストを'<code><acronym title="HyperText Markup Language">HTML</acronym></code>'に置き換えます。acronymタグはHTMLタグで、頭字語についての追加情報を提供します。</p>
\r
557 <p>イベント登録に必要なステップは以下になります。</p>
\r
560 <li><code>getEventList</code> メソッドから返る配列にイベント名を追加します。</li>
\r
561 <li><code>event_EventName($data)</code> という形でメソッドを生成し、この中でイベントを処理します。</li>
\r
564 <p>複数のプラグインが同じイベントに登録できます。管理エリアのプラグインリストの順序に従ってプラグインに通知が行きます。リストの上にあるプラグインほど早く通知されます。</p>
\r
568 <p><code>event_EventName</code> メソッドはひとつだけ <code>$data</code> パラメータを持ち、それはイベントごとに内容が異なります。これは連想配列です。この連想配列に渡されたオブジェクトや配列は<strong>参照形式</strong>で渡されるため、これらに加えた変更は記憶されます。</p>
\r
570 <p>以下のイベントリストは、パラメータ変更がNucleusに知られるかどうかを示すために色を使い分けています。</p>
\r
573 <li><var class="ref">参照渡し(緑)</var>: この種のパラメータに変更を加えるとNucleusに知られます。</li>
\r
574 <li><var class="ro">値渡し(赤)</var>: プラグインイベントハンドラに渡される前に値がコピーされます。これらの変数への変更は自動的に破棄されます。.</li>
\r
577 <p>パラメータとして渡されるオブジェクトは<var class="obj">object</var>.として示されます。ほとんどのオブジェクトは参照渡しで、<var class="obj ref">object by ref</var>のように示されます。</p>
\r
581 <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
582 <caption>プラグインが登録できるイベント</caption>
\r
584 <th abbr="name">イベントの名前</th><th abbr="timing">イベントが発生するタイミング</th><th abbr="param">プラグインに渡されるパラメータ</th>
\r
587 <td>InitSkinParse</td>
\r
588 <td>スキンの初期化の直前</td>
\r
590 <dt class="obj ref">skin</dt>
\r
591 <dd>パースする<code>SKIN</code>オブジェクト</dd>
\r
592 <dt class="ro">type</dt>
\r
593 <dd>スキンタイプ('index', 'item', 'archive', 'archivelist', 'member', 'error', 'search', 'imagepopup', 'fileparser'のいずれか)</dd>
\r
597 <td>PreSkinParse</td>
\r
598 <td>スキンのパースの直前</td>
\r
600 <dt class="obj ref">skin</dt>
\r
601 <dd>パースする<code>SKIN</code>オブジェクト</dd>
\r
602 <dt class="ro">type</dt>
\r
603 <dd>スキンタイプ('index', 'item', 'archive', 'archivelist', 'member', 'error', 'search', 'imagepopup', 'fileparser'のいずれか)</dd>
\r
604 <dt class="ref">contents</dt>
\r
609 <td>PostSkinParse</td>
\r
610 <td>スキンのパースの直後</td>
\r
612 <dt class="obj ref">skin</dt>
\r
613 <dd>パースする<code>SKIN</code>オブジェクト</dd>
\r
614 <dt class="ro">type</dt>
\r
615 <dd>スキンタイプ('index', 'item', 'archive', 'archivelist', 'member', 'error', 'search', 'imagepopup', 'fileparser'のいずれか)</dd>
\r
620 <td>アイテムのパース前、ただしアイテムヘッダーのパース後</td>
\r
622 <dt class="ref obj">blog</dt>
\r
623 <dd><code>BLOG</code> オブジェクト</dd>
\r
624 <dt class="ref obj">item</dt>
\r
625 <dd>アイテムデータを持つオブジェクト</dd>
\r
630 <td>アイテムのパース後、ただしアイテムフッターのパース前</td>
\r
632 <dt class="ref obj">blog</dt>
\r
633 <dd><code>BLOG</code> オブジェクト</dd>
\r
634 <dt class="ref obj">item</dt>
\r
635 <dd>アイテムデータを持つオブジェクト</dd>
\r
639 <td>PreComment</td>
\r
642 <dt class="ref">comment</dt>
\r
643 <dd>コメントデータを持つ連想配列</dd>
\r
647 <td>PostComment</td>
\r
650 <dt class="ref">comment</dt>
\r
651 <dd>コメントデータを持つ連想配列</dd>
\r
655 <td>PreDateHead</td>
\r
656 <td>日付ヘッダーのパース前</td>
\r
658 <dt class="obj ref">blog</dt>
\r
659 <dd><code>BLOG</code> オブジェクト</dd>
\r
660 <dt class="ro">timestamp</dt>
\r
661 <dd>日付ヘッダーのタイムスタンプ</dd>
\r
665 <td>PostDateHead</td>
\r
666 <td>日付ヘッダーのパース後</td>
\r
668 <dt class="obj ref">blog</dt>
\r
669 <dd><code>BLOG</code> オブジェクト</dd>
\r
670 <dt class="ro">timestamp</dt>
\r
671 <dd>日付ヘッダーのタイムスタンプ</dd>
\r
675 <td>PreDateFoot</td>
\r
676 <td>日付フッターのパース前</td>
\r
678 <dt class="ref obj">blog</dt>
\r
679 <dd><code>BLOG</code> オブジェクト</dd>
\r
680 <dt class="ro">timestamp</dt>
\r
681 <dd>日付フッターのタイムスタンプ</dd>
\r
685 <td>PostDateFoot</td>
\r
686 <td>日付フッターのパース後</td>
\r
688 <dt class="ref obj">blog</dt>
\r
689 <dd><code>BLOG</code> オブジェクト</dd>
\r
690 <dt class="ro">timestamp</dt>
\r
691 <dd>日付フッターのタイムスタンプ</dd>
\r
695 <td>LoginSuccess</td>
\r
698 <dt class="obj ref">member</dt>
\r
699 <dd><code>MEMBER</code> オブジェクト</dd>
\r
700 <dt class="ro">username</dt>
\r
701 <dd>ログ印字に使用されたログイン名</dd>
\r
705 <td>LoginFailed</td>
\r
708 <dt class="ro">username</dt>
\r
709 <dd>ログイン時に使われたユーザー名</dd>
\r
716 <dt class="ro">username</dt>
\r
717 <dd>ログアウト時のユーザー名</dd>
\r
721 <td>PreBlogContent</td>
\r
722 <td>blogの内容がスキン変数を通して挿入される前</td>
\r
724 <dt class="obj ref">blog</dt>
\r
725 <dd><code>BLOG</code> オブジェクト</dd>
\r
726 <dt class="ro">type</dt>
\r
727 <dd>呼び出されたスキン変数 ('blog', 'otherblog', 'archive', 'archivelist', 'item', 'searchresults', 'othersearchresults', 'categorylist', 'otherarchive', 'otherarchivelist')</dd>
\r
731 <td>PostBlogContent</td>
\r
732 <td>blogの内容がスキン変数を通して挿入された後</td>
\r
734 <dt class="obj ref">blog</dt>
\r
735 <dd><code>BLOG</code> オブジェクト</dd>
\r
736 <dt class="ro">type</dt>
\r
737 <dd>呼び出されたスキン変数 ('blog', 'otherblog', 'archive', 'archivelist', 'item', 'searchresults', 'othersearchresults', 'categorylist', 'otherarchive', 'otherarchivelist')</dd>
\r
741 <td>PreAddComment</td>
\r
742 <td>コメントがデータベースに追加される前</td>
\r
744 <dt class="ref">comment</dt>
\r
745 <dd>コメントデータ(連想配列)</dd>
\r
746 <dt class="ref">spamcheck</dt>
\r
747 <dd>(v3.3) <em>SpamCheck</em>イベントの結果として返されるデータ構造(連想配列)</dd>
\r
751 <td>PostAddComment</td>
\r
752 <td>コメントがデータベースに追加された後</td>
\r
754 <dt class="ref">comment</dt>
\r
755 <dd>コメントデータ(連想配列)</dd>
\r
756 <dt class="ref">commentid</dt>
\r
758 <dt class="ref">spamcheck</dt>
\r
759 <dd>(v3.3) <em>SpamCheck</em>イベントの結果として返されるデータ構造(連想配列)</dd>
\r
763 <td>PostRegister</td>
\r
764 <td>新規ユーザーの登録後</td>
\r
766 <dt class="obj ref">member</dt>
\r
767 <dd>新しい<code>MEMBER</code> オブジェクト</dd>
\r
771 <td>PostAddItem</td>
\r
772 <td>アイテムがデータベースに追加された後</td>
\r
774 <dt class="ro">itemid</dt>
\r
775 <dd>データベースに出来た新しい itemid</dd>
\r
779 <td>PostUpdateItem</td>
\r
780 <td>アイテムがデータベースにアップデートされた直後</td>
\r
782 <dt class="ro">itemid</dt>
\r
787 <td>PreAddItem</td>
\r
788 <td>アイテムがデータベースに追加される直前</td>
\r
790 <dt class="ref">title</dt>
\r
792 <dt class="ref">body</dt>
\r
794 <dt class="ref">more</dt>
\r
796 <dt class="ref obj">blog</dt>
\r
797 <dd><code>BLOG</code> オブジェクト</dd>
\r
798 <dt class="ref">authorid</dt>
\r
800 <dt class="ref">timestamp</dt>
\r
801 <dd>UNIX タイムスタンプ</dd>
\r
802 <dt class="ref">closed</dt>
\r
803 <dd>1 (コメント不可) or 0 (コメント可)</dd>
\r
804 <dt class="ref">draft</dt>
\r
805 <dd>1 (ドラフト) or 0 (非ドラフト)</dd>
\r
806 <dt class="ref">catid</dt>
\r
811 <td>PreUpdateItem</td>
\r
812 <td>データベースにあるアイテムが更新される直前</td>
\r
814 <dt class="ro">itemid</dt>
\r
816 <dt class="ref">title</dt>
\r
818 <dt class="ref">body</dt>
\r
820 <dt class="ref">more</dt>
\r
822 <dt class="ref obj">blog</dt>
\r
823 <dd><code>BLOG オブジェクト</code> object</dd>
\r
824 <dt class="ref">closed</dt>
\r
825 <dd>1 (コメント不可) or 0 (コメント可)</dd>
\r
826 <dt class="ref">catid</dt>
\r
831 <td>PrepareItemForEdit</td>
\r
832 <td>アイテムをデータベースから取得した直後で、編集のためにユーザーに表示される前</td>
\r
834 <dt class="ref">item</dt>
\r
835 <dd>アイテムデータを持つ連想配列</dd>
\r
839 <td>PreUpdateComment</td>
\r
840 <td>コメントが更新され、データベースに保存される直前</td>
\r
842 <dt class="ref">body</dt>
\r
847 <td>PrepareCommentForEdit</td>
\r
848 <td>コメントをデータベースから取得した直後で、編集のためにユーザーに表示される前</td>
\r
850 <dt class="ref">comment</dt>
\r
851 <dd>コメントデータ(連想配列)</dd>
\r
855 <td>PrePluginOptionsEdit</td>
\r
858 <li>(v2.0b) 'プラグインオプションの編集'フォームが生成される前</li>
\r
859 <li>(v2.2) パラメータ追加</li>
\r
860 <li>(v3.2) 各オプションにパラメータ追加</li>
\r
864 <dt class="ro">context</dt>
\r
865 <dd>(v2.2) <code>global</code>, <code>blog</code>, <code>member</code>, <code>item</code>, <code>category</code>のいずれか</dd>
\r
866 <dt class="ref">options</dt>
\r
867 <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
868 <code>extra</code>フィールドを用いて、オプションに追加HTML(たとえばフォームのコントロール)を追加できます。もしそうする場合、 <code>extra</code> に追加する前に <code>pid</code> と <code>getID()</code> を比較し、さらに <code>name</code> をチェックすべきです。</dd>
\r
869 <dt class="ro">plugid</dt>
\r
870 <dd>プラグイン ID (これが気になるなら、<code>GetID()</code>を見ると理解できる)(コンテクストがglobalのときのみ存在)</dd>
\r
871 <dt class="ro">contextid</dt>
\r
872 <dd>コンテクスト ID (blogid, memberid, catid, itemid コンテクストによる)</dd>
\r
877 <td>PrePluginOptionsUpdate</td>
\r
879 (v3.2) プラグインオプションが更新される前。(このイベントを使ってオプションの新しい値を評価したり変更したりできます)
\r
882 <dt class="ro">context</dt>
\r
883 <dd>(v2.2) <code>global</code>, <code>member</code>, <code>blog</code>, <code>item</code>, <code>category</code>のいずれか</dd>
\r
884 <dt class="ro">plugid</dt>
\r
885 <dd>プラグイン ID (これが気になるなら、<code>GetID()</code>を見ると理解できる)</dd>
\r
886 <dt class="ro">optionname</dt>
\r
888 <dt class="ro">contextid</dt>
\r
889 <dd>コンテクスト ID (blogid, memberid, catid, itemid コンテクストによる)</dd>
\r
890 <dt class="ref">value</dt>
\r
891 <dd>そのオプションの新しい値</dd>
\r
897 <td>PostPluginOptionsUpdate</td>
\r
900 <li>(v2.0b) プラグインオプションの更新後</li>
\r
901 <li>(v2.2) コンテクストによって異なるパラメータ</li>
\r
905 <dt class="ro">context</dt>
\r
906 <dd>(v2.2) <code>global</code>, <code>member</code>, <code>blog</code>, <code>item</code>, <code>category</code>のいずれか</dd>
\r
907 <dt class="ro">plugid</dt>
\r
908 <dd>プラグイン ID (これが気になるなら、<code>GetID()</code>を見ると理解できる)(globalコンテクスト)</dd>
\r
909 <dt class="ro">blogid</dt>
\r
910 <dd>(v2.2) blog ID (blog コンテクスト)</dd>
\r
911 <dt class="ref obj">blog</dt>
\r
912 <dd>(v2.2) BLOG オブジェクト (blog コンテクスト)</dd>
\r
913 <dt class="ro">memberid</dt>
\r
914 <dd>(v2.2) member ID (member コンテクスト)</dd>
\r
915 <dt class="ref obj">member</dt>
\r
916 <dd>(v2.2) MEMBER オブジェクト (member コンテクスト)</dd>
\r
917 <dt class="ro">catid</dt>
\r
918 <dd>(v2.2) category ID (category コンテクスト)</dd>
\r
919 <dt class="ro">itemid</dt>
\r
920 <dd>(v2.2) item ID (item コンテクスト)</dd>
\r
921 <dt class="ref obj">member</dt>
\r
922 <dd>(v2.2) ITEM オブジェクト (item コンテクスト)</dd>
\r
927 <td>PostAuthentication</td>
\r
928 <td>(v2.0b) ログイン処理の完了後。ページリクエストごとに発生</td>
\r
930 <dt class="ro">loggedIn</dt>
\r
931 <dd><code>$member->isLoggedIn()</code>の戻り値</dd>
\r
935 <td>PreAddItemForm</td>
\r
936 <td>(v2.0b) アイテム追加フォーム(ブックマークレットまたは管理エリア)が生成される直前</td>
\r
938 <dt class="ref">contents</dt>
\r
939 <dd>連想配列への参照。そのうちの'title', 'body', 'more'にはフォームフィールドへの初期値を与えることができます。複数のプラグイン間でこれらの値の変更を避けるには、処理後に'hasBeenSet'の値を1にセットします(かつ処理前にこの値をチェックするようにします)</dd>
\r
940 <dt class="ref obj">blog</dt>
\r
941 <dd><code>BLOG</code> オブジェクトへの参照</dd>
\r
945 <td>AddItemFormExtras</td>
\r
946 <td>(v2.0b) アイテム追加ページまたはブックマークレット内部のどこか。<code>template</code> ファイルの類を別に用意しなくても、ここでプラグインがカスタムフィールドを追加できる。</td>
\r
948 <dt class="ref obj">blog</dt>
\r
949 <dd><code>BLOG</code> オブジェクトへの参照</dd>
\r
953 <td>EditItemFormExtras</td>
\r
955 (v2.0b) アイテム編集ページまたはブックマークレット内部のどこか。<code>template</code> ファイルの類を別に用意しなくても、ここでプラグインがカスタムフィールドを追加できる。<br style="margin-bottom:1.5em;" />
\r
957 あまり多くのデータを追加しないこと。また以下のように<strong>正しいXHTML</strong>を生成してください。
\r
958 <pre class="example"><code><h3>プラグイン名</h3>
\r
959 <p>追加フォームの内容</p></code></pre>
\r
960 このようにして、正しい構造を保ちつつ複数のプラグインがオプションを保持できます。またフィールド名の重複を避けるためにプレフィックスを用いてください(例 <code>plug_tb_url</code>)。
\r
963 <dt class="ref obj">blog</dt>
\r
964 <dd><code>BLOG</code> オブジェクトへの参照</dd>
\r
965 <dt class="ro">variables</dt>
\r
967 (read-only) 編集されるアイテムに関する全ての情報を持つ連想配列: 'itemid', 'draft', 'closed', 'title', 'body', 'more', 'author', 'authorid', 'timestamp', 'karmapos', 'karmaneg', 'catid'
\r
969 <dt class="ro">itemid</dt>
\r
970 <dd>アイテム IDへのショートカット</dd>
\r
974 <td>BlogSettingsFormExtras</td>
\r
975 <td>(v2.0) blog設定ページにフォームを追加可能
\r
976 <br style="margin-bottom:1.5em;" />
\r
977 あまり多くのデータを追加しないこと。また以下のように<strong>正しいXHTML</strong>を生成してください。
\r
978 <pre class="example"><code><h4>プラグイン名</h4>
\r
979 <form method="post" action="..."><p>
\r
981 </p></form></code></pre>
\r
982 このようにして、正しい構造を保ちつつ複数のプラグインがオプションを保持できます。またフィールド名の重複を避けるためにプレフィックスを用いてください(例 <code>plug_tb_url</code>)。
\r
986 <dt class="obj ref">blog</dt>
\r
987 <dd><code>BLOG</code> オブジェクトへの参照</dd>
\r
991 <td>PreDeleteItem</td>
\r
992 <td>(v2.0) アイテムがデータベースから削除される直前</td>
\r
994 <dt class="ro">itemid</dt>
\r
995 <dd>削除されるアイテムID</dd>
\r
999 <td>PostDeleteItem</td>
\r
1000 <td>(v2.0) アイテムがデータベースから削除された直後</td>
\r
1002 <dt class="ro">itemid</dt>
\r
1003 <dd>削除されたアイテムID</dd>
\r
1007 <td>PreDeleteCategory</td>
\r
1008 <td>(v2.0) カテゴリーがデータベースから削除される直前</td>
\r
1010 <dt class="ro">catid</dt>
\r
1011 <dd>削除されるカテゴリー ID</dd>
\r
1015 <td>PostDeleteCategory</td>
\r
1016 <td>(v2.0) カテゴリーがデータベースから削除された直後</td>
\r
1018 <dt class="ro">catid</dt>
\r
1019 <dd>削除されたカテゴリー ID</dd>
\r
1023 <td>PreDeleteBlog</td>
\r
1024 <td>(v2.0) blogがデータベースから削除される直前</td>
\r
1026 <dt class="ro">blogid</dt>
\r
1027 <dd>削除されるblogID</dd>
\r
1031 <td>PostDeleteBlog</td>
\r
1032 <td>(v2.0) blogがデータベースから削除された直後</td>
\r
1034 <dt class="ro">blogid</dt>
\r
1035 <dd>削除されたblogID</dd>
\r
1039 <td>PreDeleteMember</td>
\r
1040 <td>(v2.0) メンバーがデータベースから削除される直前</td>
\r
1042 <dt class="ref obj">member</dt>
\r
1043 <dd><code>削除されるメンバーに関するMEMBER</code> オブジェクトへの参照</dd>
\r
1047 <td>PostDeleteMember</td>
\r
1048 <td>(v2.0) メンバーがデータベースから削除された直後</td>
\r
1050 <dt class="ref obj">member</dt>
\r
1051 <dd><code>削除されるメンバーに関するMEMBER</code> オブジェクトへの参照</dd>
\r
1055 <td>PreDeleteTeamMember</td>
\r
1056 <td>(v2.0) メンバーがweblogチームから削除される直前</td>
\r
1058 <dt class="ref obj">member</dt>
\r
1059 <dd><code>MEMBER</code> オブジェクトへの参照</dd>
\r
1060 <dt class="ro">blogid</dt>
\r
1065 <td>PostDeleteTeamMember</td>
\r
1066 <td>(v2.0) メンバーがweblogチームから削除された直後</td>
\r
1068 <dt class="ref obj">member</dt>
\r
1069 <dd><code>MEMBER</code> オブジェクトへの参照</dd>
\r
1070 <dt class="ro">blogid</dt>
\r
1075 <td>PreDeleteComment</td>
\r
1076 <td>(v2.0) コメントがデータベースから削除される直前</td>
\r
1078 <dt class="ro">commentid</dt>
\r
1079 <dd>削除されるコメントID</dd>
\r
1083 <td>PostDeleteComment</td>
\r
1084 <td>(v2.0) コメントがデータベースから削除された直後</td>
\r
1086 <dt class="ro">commentid</dt>
\r
1087 <dd>削除されたコメントID</dd>
\r
1091 <td>ActionLogCleared</td>
\r
1092 <td>(v2.0) アクションログが消去された後</td>
\r
1096 <td>PreDeleteTemplate</td>
\r
1097 <td>(v2.0) テンプレートがデータベースから削除される直前</td>
\r
1099 <dt class="ro">templateid</dt>
\r
1100 <dd>削除されるテンプレートID</dd>
\r
1104 <td>PostDeleteTemplate</td>
\r
1105 <td>(v2.0) テンプレートがデータベースから削除された直後</td>
\r
1107 <dt class="ro">templateid</dt>
\r
1108 <dd>削除されたテンプレートID</dd>
\r
1112 <td>PreDeleteSkin</td>
\r
1113 <td>(v2.0) スキンがデータベースから削除される直前</td>
\r
1115 <dt class="ro">skinid</dt>
\r
1116 <dd>削除されるスキンID</dd>
\r
1120 <td>PostDeleteSkin</td>
\r
1121 <td>(v2.0) スキンがデータベースから削除された直後</td>
\r
1123 <dt class="ro">skinid</dt>
\r
1124 <dd>削除されたスキンID</dd>
\r
1128 <td>PreDeleteSkinPart</td>
\r
1129 <td>スペシャルスキンパーツがデータベースから削除される直前</td>
\r
1131 <dt class="ro">skinid</dt>
\r
1132 <dd>削除されるスペシャルスキンパーツが含まれるスキンのID</dd>
\r
1133 <dt class="ro">skintype</dt>
\r
1134 <dd>削除されるスペシャルスキンパーツの名前</dd>
\r
1138 <td>PostDeleteSkin</td>
\r
1139 <td>スペシャルスキンパーツがデータベースから削除された直後</td>
\r
1141 <dt class="ro">skinid</dt>
\r
1142 <dd>削除されたスペシャルスキンパーツが含まれるスキンのID</dd>
\r
1143 <dt class="ro">skintype</dt>
\r
1144 <dd>削除されたスペシャルスキンパーツの名前</dd>
\r
1148 <td>PreDeletePlugin</td>
\r
1149 <td>(v2.0) プラグインがデータベースから削除される直前</td>
\r
1151 <dt class="ro">plugid</dt>
\r
1152 <dd>削除されるプラグインID</dd>
\r
1156 <td>PostDeletePlugin</td>
\r
1157 <td>(v2.0) プラグインがデータベースから削除された直後</td>
\r
1159 <dt class="ro">plugid</dt>
\r
1160 <dd>削除されたプラグインID</dd>
\r
1164 <td>PreDeleteBan</td>
\r
1165 <td>(v2.0) 禁止IPがデータベースから削除される直前</td>
\r
1167 <dt class="ro">blogid</dt>
\r
1168 <dd>禁止IPが削除されるblogのID</dd>
\r
1169 <dt class="ro">iprange</dt>
\r
1170 <dd>禁止されたIPレンジ</dd>
\r
1174 <td>PostDeleteBan</td>
\r
1175 <td>(v2.0) 禁止IPがデータベースから削除された直後</td>
\r
1177 <dt class="ro">blogid</dt>
\r
1178 <dd>禁止IPが削除されたblogのID</dd>
\r
1179 <dt class="ro">iprange</dt>
\r
1180 <dd>禁止されたIPレンジ</dd>
\r
1184 <td>PreAddCategory</td>
\r
1185 <td>(v2.0) 新しいカテゴリーがデータベースに生成される直前</td>
\r
1187 <dt class="ref obj">blog</dt>
\r
1188 <dd><code>BLOG</code> オブジェクトの参照</dd>
\r
1189 <dt class="ref">name</dt>
\r
1190 <dd>新しいカテゴリー名</dd>
\r
1191 <dt class="ref">description</dt>
\r
1192 <dd>新しいカテゴリーの説明</dd>
\r
1196 <td>PostAddCategory</td>
\r
1197 <td>(v2.0) 新しいカテゴリーがデータベースに生成された直後</td>
\r
1199 <dt class="ref obj">blog</dt>
\r
1200 <dd><code>BLOG</code> オブジェクトへの参照</dd>
\r
1201 <dt class="ro">name</dt>
\r
1202 <dd>新しいカテゴリー名</dd>
\r
1203 <dt class="ro">description</dt>
\r
1204 <dd>新しいカテゴリーの説明</dd>
\r
1205 <dt class="ro">catid</dt>
\r
1206 <dd>新しいカテゴリー ID</dd>
\r
1210 <td>PreAddBlog</td>
\r
1211 <td>(v2.0) 新しいblogが生成される直前</td>
\r
1213 <dt class="ref">name</dt>
\r
1214 <dd>新しい blog名</dd>
\r
1215 <dt class="ref">shortname</dt>
\r
1216 <dd>新しい blogの短縮名</dd>
\r
1217 <dt class="ref">timeoffset</dt>
\r
1218 <dd>新しい blogのタイムオフセット</dd>
\r
1219 <dt class="ref">description</dt>
\r
1220 <dd>新しい blogの説明</dd>
\r
1221 <dt class="ref">defaultskin</dt>
\r
1222 <dd>新しいblogのデフォルトスキンのID</dd>
\r
1226 <td>PostAddBlog</td>
\r
1227 <td>(v2.0) 新しいblogが生成された直後</td>
\r
1229 <dt class="ref obj">blog</dt>
\r
1230 <dd>新しい<code>BLOG</code> オブジェクト</dd>
\r
1234 <td>PreAddPlugin</td>
\r
1235 <td>(v2.0) プラグインが追加される直前</td>
\r
1237 <dt class="ref">file</dt>
\r
1238 <dd>新しいプラグインのファイル名</dd>
\r
1242 <td>PostAddPlugin</td>
\r
1243 <td>(v2.0) プラグインが追加された直後</td>
\r
1245 <dt class="ref obj">plugin</dt>
\r
1246 <dd>新しく追加されたプラグインのオブジェクト</dd>
\r
1250 <td>PreAddTeamMember</td>
\r
1251 <td>(v2.0) メンバーがblogチームに追加される直前</td>
\r
1253 <dt class="ref obj">blog</dt>
\r
1254 <dd><code>BLOG</code> オブジェクト</dd>
\r
1255 <dt class="ref obj">member</dt>
\r
1256 <dd><code>MEMBER</code> オブジェクト</dd>
\r
1257 <dt class="ref">admin</dt>
\r
1258 <dd>新しく追加されたメンバーが管理権限を持っているかどうかを示すブール値</dd>
\r
1262 <td>PostAddTeamMember</td>
\r
1263 <td>(v2.0) メンバーがblogチームに追加された直後</td>
\r
1265 <dt class="ref obj">blog</dt>
\r
1266 <dd><code>BLOG</code> オブジェクト</dd>
\r
1267 <dt class="ref obj">member</dt>
\r
1268 <dd><code>MEMBER</code> オブジェクト</dd>
\r
1269 <dt class="ro">admin</dt>
\r
1270 <dd>新しく追加されたメンバーが管理権限を持っているかどうかを示すブール値</dd>
\r
1274 <td>PreAddTemplate</td>
\r
1275 <td>(v2.0) 新しいテンプレートが生成される直前(注:テンプレートが複製されたときも呼ばれる)</td>
\r
1277 <dt class="ref">name</dt>
\r
1278 <dd>新しいテンプレート名</dd>
\r
1279 <dt class="ref">description</dt>
\r
1280 <dd>新しいテンプレートの説明</dd>
\r
1284 <td>PostAddTemplate</td>
\r
1285 <td>(v2.0) 新しいテンプレートが生成された直後</td>
\r
1287 <dt class="ro">name</dt>
\r
1288 <dd>新しいテンプレート名</dd>
\r
1289 <dt class="ro">description</dt>
\r
1290 <dd>新しいテンプレートの説明</dd>
\r
1291 <dt class="ro">templateid</dt>
\r
1292 <dd>新しいテンプレートID</dd>
\r
1296 <td>PreAddSkin</td>
\r
1297 <td>(v2.0) 新しいスキンが生成される直前(注:スキンが複製されたときも呼ばれる)</td>
\r
1299 <dt class="ref">name</dt>
\r
1301 <dt class="ref">description</dt>
\r
1302 <dd>新しいスキン名の説明</dd>
\r
1303 <dt class="ref">type</dt>
\r
1304 <dd>スキンのコンテントタイプ</dd>
\r
1305 <dt class="ref">includeMode</dt>
\r
1306 <dd>新しいスキンのインクルードモード</dd>
\r
1307 <dt class="ref">includePrefix</dt>
\r
1308 <dd>新しいスキンのインクルードプレフィックス</dd>
\r
1312 <td>PostAddSkin</td>
\r
1313 <td>(v2.0) 新しいスキンが生成された直後</td>
\r
1315 <dt class="ro">name</dt>
\r
1317 <dt class="ro">description</dt>
\r
1318 <dd>新しいスキンの説明</dd>
\r
1319 <dt class="ro">type</dt>
\r
1320 <dd>スキンのコンテントタイプ</dd>
\r
1321 <dt class="ro">includeMode</dt>
\r
1322 <dd>新しいスキンのインクルードモード</dd>
\r
1323 <dt class="ro">includePrefix</dt>
\r
1324 <dd>新しいスキンのインクルードプレフィックス</dd>
\r
1325 <dt class="ro">skinid</dt>
\r
1330 <td>PreAddBan</td>
\r
1331 <td>(v2.0) 新しい禁止IPが追加される直前</td>
\r
1333 <dt class="ref">blogid</dt>
\r
1335 <dt class="ref">iprange</dt>
\r
1336 <dd>禁止されたIPレンジ</dd>
\r
1337 <dt class="ref">reason</dt>
\r
1338 <dd>禁止された理由を記述したテキストメッセージ</dd>
\r
1342 <td>PostAddBan</td>
\r
1343 <td>(v2.0) 新しい禁止IPが追加された直後</td>
\r
1345 <dt class="ro">blogid</dt>
\r
1347 <dt class="ro">iprange</dt>
\r
1348 <dd>禁止されたIPレンジ</dd>
\r
1349 <dt class="ro">reason</dt>
\r
1350 <dd>禁止された理由を記述したテキストメッセージ</dd>
\r
1355 <td>PreMoveItem</td>
\r
1356 <td>(v2.0) アイテムが他のblog/カテゴリーに移される直前</td>
\r
1358 <dt class="ref">itemid</dt>
\r
1360 <dt class="ref">destblogid</dt>
\r
1361 <dd>移動先のblogID</dd>
\r
1362 <dt class="ref">destcatid</dt>
\r
1363 <dd>移動先のカテゴリーID</dd>
\r
1367 <td>PostMoveItem</td>
\r
1368 <td>(v2.0) アイテムが他のblog/カテゴリーに移された直後</td>
\r
1370 <dt class="ro">itemid</dt>
\r
1372 <dt class="ro">destblogid</dt>
\r
1373 <dd>新しいblogID</dd>
\r
1374 <dt class="ro">destcatid</dt>
\r
1375 <dd>新しいカテゴリーID</dd>
\r
1379 <td>PreMoveCategory</td>
\r
1380 <td>(v2.0) カテゴリーが他のblogに移される直前</td>
\r
1382 <dt class="ref">catid</dt>
\r
1384 <dt class="ref obj">sourceblog</dt>
\r
1385 <dd>移動元の<code>BLOG</code> オブジェクト</dd>
\r
1386 <dt class="ref obj">destblog</dt>
\r
1387 <dd>移動先の<code>BLOG</code> オブジェクト</dd>
\r
1391 <td>PostMoveCategory</td>
\r
1392 <td>(v2.0) カテゴリーが他のblogに移された直後</td>
\r
1394 <dt class="ro">catid</dt>
\r
1396 <dt class="ref obj">sourceblog</dt>
\r
1397 <dd>移動元の<code>BLOG</code> オブジェクト</dd>
\r
1398 <dt class="ref obj">destblog</dt>
\r
1399 <dd>移動先の<code>BLOG</code> オブジェクト</dd>
\r
1403 <td>MemberSettingsFormExtras</td>
\r
1404 <td><span style="display:block;margin-bottom:1.5em;">(v2.0) メンバー設定ページにフォームを追加可能</span>
\r
1405 あまり多くのデータを追加しないこと。また以下のように<strong>正しいXHTML</strong>を生成してください。
\r
1406 <pre class="example"><code><h4>プラグイン名</h4>
\r
1407 <form method="post" action="..."><p>
\r
1409 </p></form></code></pre>
\r
1410 このようにして、正しい構造を保ちつつ複数のプラグインがオプションを保持できます。またフィールド名の重複を避けるためにプレフィックスを用いてください(例 <code>plug_tb_url</code>)。
\r
1414 <dt class="ref obj">member</dt>
\r
1415 <dd><code>MEMBER</code> オブジェクトへの参照</dd>
\r
1419 <td>GeneralSettingsFormExtras</td>
\r
1420 <td><span style="display:block;margin-bottom:1.5em;">(v2.0) 一般設定ページにフォームを追加可能</span>
\r
1421 あまり多くのデータを追加しないこと。また以下のように<strong>正しいXHTML</strong>を生成してください。
\r
1422 <pre class="example"><code><h4>プラグイン名</h4>
\r
1423 <form method="post" action="..."><p>
\r
1425 </p></form></code></pre>
\r
1426 このようにして、正しい構造を保ちつつ複数のプラグインがオプションを保持できます。またフィールド名の重複を避けるためにプレフィックスを用いてください(例 <code>plug_tb_url</code>)。
\r
1432 <td>AdminPrePageHead</td>
\r
1433 <td>(v2.5) 管理画面で、ページヘッドを出力する直前。このイベントはヘッド領域にスクリプトやCSSを追加するのに用いられます。</td>
\r
1435 <dt class="ref">extrahead</dt>
\r
1436 <dd>HTMLページのヘッド領域に埋め込まれる追加情報。ここに追加したいものを入れてください。</dd>
\r
1437 <dt class="ro">action</dt>
\r
1438 <dd>現在実行されているアクション、またはページタイプ</dd>
\r
1442 <td>AdminPrePageFoot</td>
\r
1443 <td>(v2.5) 管理画面で、ページフッターを出力する直前。</td>
\r
1445 <dt class="ro">action</dt>
\r
1446 <dd>現在実行されているアクション、またはページタイプ</dd>
\r
1450 <td>PreSendContentType</td>
\r
1451 <td>(v2.5) HTTPヘッダーにコンテントタイプがセットされる直前</td>
\r
1453 <dt class="ref">contentType</dt>
\r
1454 <dd>コンテントタイプ(<code>application/xhtml+xml</code>など)</dd>
\r
1455 <dt class="ref">charset</dt>
\r
1456 <dd>キャラクターセット</dd>
\r
1457 <dt class="ro">pageType</dt>
\r
1458 <dd>表示するページの種類を示す文字列:<code>skin</code> (スキンタイプ), <code>media</code> (メディアライブラリ), <code>admin-<em>action</em></code> (管理エリア), <code>bookmarklet-<em>action</em></code> (ブックマークレット)</dd>
\r
1462 <td>QuickMenu</td>
\r
1463 <td>(v2.5) 管理エリアのクイックメニューの一番下。そこへのプラグイン登録に利用されます。登録するにはoptionsに連想配列を入れます。実装例が<a href="#admin">プラグイン管理エリアを作る</a>のセクションにあります。</td>
\r
1465 <dt class="ref">options</dt>
\r
1470 <td>BookmarkletExtraHead</td>
\r
1471 <td>(v2.5) ブックマークレット XHTMLコードのヘッド領域内。</td>
\r
1473 <dt class="ref">extrahead</dt>
\r
1474 <dd>XHTMLコードのヘッド領域に埋め込まれる追加情報。ここに追加したいものを入れてください。</dd>
\r
1478 <td>FormExtra</td>
\r
1479 <td>(v3.2) このイベントは、プラグインがコメント、メンバー間メール、認証フォームのいずれかのフォーム内に追加フィールドを挿入するときに使います。フォーム処理の際に発生する <code>ValidateForm</code> イベントに対応します。</td>
\r
1481 <dt class="ro">type</dt>
\r
1482 <dd>イベントを発生させるフォームタイプ
\r
1484 <li><code>activation</code></li>
\r
1485 <li><code>additemform</code> (注:これは管理画面のアイテム追加フォームではない)</li>
\r
1486 <li><code>commentform-loggedin</code></li>
\r
1487 <li><code>commentform-notloggedin</code></li>
\r
1488 <li><code>membermailform-loggedin</code></li>
\r
1489 <li><code>membermailform-notloggedin</code></li>
\r
1492 <dt class="ro obj">member</dt>
\r
1493 <dd><code>type</code> が <code>activation</code>のとき、このフィールドは認証メンバーの詳細情報を含みます</dd>
\r
1497 <td>ValidateForm</td>
\r
1498 <td>(v3.2) コメント、メンバー間メール、アカウント認証のいずれかが処理されるときに呼ばれます。プラグインはこれで各データの評価を実行でき、もし不具合があれば処理を中断できます。<code>FormExtra</code> と共に使うとフォームにフィールドを追加できます。</td>
\r
1500 <dt class="ro">type</dt>
\r
1503 <li><code>membermail</code></li>
\r
1504 <li><code>comment</code></li>
\r
1505 <li><code>activation</code></li>
\r
1508 <dt class="ref">error</dt>
\r
1509 <dd>フォーム処理をストップするときに、<code>error</code> フィールドに空でないエラーメッセージを記入します。このエラーメッセージはユーザー側に表示されます。</dd>
\r
1510 <dt class="ref">comment</dt>
\r
1511 <dd>コメントデータの連想配列(コメントフォームのときのみ)</dd>
\r
1512 <dt class="ref">spamcheck</dt>
\r
1513 <dd>(v3.3) <em>SpamCheck</em>イベントの結果として返される連想配列(コメントフォームのときのみ)</dd>
\r
1514 <dt class="ro obj">member</dt>
\r
1515 <dd>認証フォームのとき、認証中のメンバー情報を含みます。</dd>
\r
1520 <td>(v3.22)NucleusのコアでURLからアイテムやカテゴリのIDを読み取る前。プラグインはこのイベントを使ってURLを解釈します</td>
\r
1522 <dt class="ro">type</dt>
\r
1523 <dd>FancyURLの仮想ディレクトリ(拡張子無しファイル)のファイル名(item, blog, ...)</dd>
\r
1524 <dt class="ro">info</dt>
\r
1525 <dd>解決される前のURL(この名前は以前の変数名である<code>pathinfo</code>から来ています).</dd>
\r
1526 <dt class="ref">complete</dt>
\r
1527 <dd>プラグインがURLを解釈し終わるとこれが<strong>true</strong>にセットされます。<strong>false</strong>の場合はプラグインはURLを解釈していません。</dd>
\r
1531 <td>GenerateURL</td>
\r
1532 <td>(v3.22)URLが自動生成される前。このイベントを使って独自のURLを生成する事が出来ます。</td>
\r
1534 <dt class="ro">type</dt>
\r
1535 <dd>生成するURLのタイプ(item, blog, ...)</dd>
\r
1536 <dt class="ro">params</dt>
\r
1537 <dd>生成するURLに付加するパラメータ</dd>
\r
1538 <dt class="ref">completed</dt>
\r
1539 <dd>プラグインはURLを生成し終わるとこれを<strong>true</strong>にセットしてURLを返します。<strong>false</strong>の場合はプラグインはURLを生成していません。</dd>
\r
1540 <dt class="ref">url</dt>
\r
1541 <dd>プラグインが生成したURLを格納する為の空の変数</dd>
\r
1545 <td>SpamCheck</td>
\r
1546 <td>(v3.3) 新しいコメントが追加されるときに呼ばれます。アンチスパムのプラグインはこのイベントを使ってコメントがスパムかどうかマークを付けられます。<code>SpamCheck</code>イベントの詳しい説明は別の文書を参照のこと(<a href='http://wakka.xiffy.nl/spamcheck_api'>SpamCheck API 2.0</a>)</td>
\r
1548 <dt class="ref">spamcheck</dt>
\r
1549 <dd>spamcheckのデータ構造(連想配列)</dd>
\r
1553 <td>PreMediaUpload</td>
\r
1554 <td>(v3.3)アップロードされたファイルが「media」ディレクトリに書き込まれる前。</td>
\r
1556 <dt class="ref">collection</dt>
\r
1557 <dd>アップロードされたファイルが格納されるべき「コレクション」</dd>
\r
1558 <dt class="ro">uploadfile</dt>
\r
1559 <dd>テンポラリディレクトリに狩り沖されているアップロードされたファイルのファイル名</dd>
\r
1560 <dt class="ref">filename</dt>
\r
1561 <dd>最終的に保存されるファイル名</dd>
\r
1565 <td>PostMediaUpload</td>
\r
1566 <td>(v3.3)アップロードされたファイルが「media」ディレクトリに書き込まれた後。</td>
\r
1568 <dt class="ro">collection</dt>
\r
1569 <dd>アップロードされたファイルが格納された「コレクション」</dd>
\r
1570 <dt class="ro">mediadir</dt>
\r
1571 <dd>アップロードされたファイルが保存されたメディアディレクトリ</dd>
\r
1572 <dt class="ro">filename</dt>
\r
1573 <dd>保存されたファイル名</dd>
\r
1578 <td>(v3.3)「ブログの設定」で「更新時にweblogsアップデート通知サービスへPingを送りますか?」が「はい」に設定されている時に限り、新しいアイテムを追加した時に呼び出されます(このイベントに対応しているプラグインがインストールされている時に限る)。このイベントはPing送信プラグインで各種「ブログ検索サービス」へ更新pingを送信します(例えば<a href="http://blogsearch.google.co.jp/">Googleブログ検索</a>など)</td>
\r
1580 <dt class="ref">blogid</dt>
\r
1581 <dd>アイテムが追加されたブログのID</dd>
\r
1585 <td>JustPosted</td>
\r
1586 <td>(v3.3)投稿された未来の日付のアイテムの設定時刻が来た時。このイベントはページの表示が完了した後に発生条件をチェックします。</td>
\r
1588 <dt class="ref">blogid</dt>
\r
1589 <dd>未来の日付のアイテムの設定時刻が来たブログのID</dd>
\r
1593 <td>RegistrationFormExtraFields</td>
\r
1594 <td>(v3.33) createaccount.php からビジターに表示されるアカウント作成フォームが表示され、FormExtra イベントが起きる前。プラグインはこのイベントによって、アカウント作成フォームに独自のフィールドを付け加える事が出来ます。PostRegister イベントに同時に登録すると、付け加えたフィールドの値を評価する事が出来る様になります。渡されるパラメータは、付け加えられたフィールドを、元々のフィールドと違和感無く表示させる為に使用されます。</td>
\r
1596 <dt class="ro">type</dt>
\r
1597 <dd>アカウント作成フォームのタイプ。通常は <code>createaccount.php</code>。</dd>
\r
1598 <dt class="ro">prelabel</dt>
\r
1599 <dd>追加フィールドの「ラベル」の<strong>前に</strong>挿入される HTML コード</dd>
\r
1600 <dt class="ro">postlabel</dt>
\r
1601 <dd>追加フィールドの「ラベル」の<strong>後に</strong>挿入される HTML コード</dd>
\r
1602 <dt class="ro">prefield</dt>
\r
1603 <dd>追加フィールドの「入力フィールド」の<strong>前に</strong>挿入される HTML コード</dd>
\r
1604 <dt class="ro">postfield</dt>
\r
1605 <dd>追加フィールドの「入力フィールド」の<strong>後に</strong>挿入される HTML コード</dd>
\r
1609 <td>TemplateExtraFields</td>
\r
1610 <td>(v3.40) テンプレートが編集・更新される時。プラグイン製作者がコアのテンプレートシステムをより使いやすくするために、テンプレートにフィールドを追加する事が出来ます。プラグイン作者は追加するテンプレートフィールドの初期状態をプラグインオプションに保存し、そこで使用するテンプレート変数についてのドキュメントを書くことが要求されます。また、このイベントに関するサンプルプラグインが、フォーラムの<a href="http://japan.nucleuscms.org/bb/viewtopic.php?p=24401#24401" title="Sample">新API「TemplateExtraFields」を使ったプラグインの見本</a>(本家フォーラムのスレッドは <a href="http://forum.nucleuscms.org/viewtopic.php?p=87672#87672" title="Sample">Skin specific values for Plugins</a>)にあります。</td>
\r
1612 <dt class="ref">fields</dt>
\r
1613 <dd>プラグイン名をキーにした連想配列。配列の内容は、テンプレートのフィールド名をキーにした連想配列で、その値はフォームのフィールドに表示されるラベル。フィールド名は全て英数小文字で、フィールド名の重複を避けるためにプラグイン名を含んでいる事が好ましい。</dd>
\r
1617 <td>PreArchiveListItem</td>
\r
1618 <td>(v3.40) アーカイブリストが表示される前。アーカイブリストを表示するために使われたテンプレートのアーカイブリスト本体フィールドのテンプレート変数を追加/修正することを可能にします。追加のテンプレート変数についてのドキュメントも整備すべきです。</td>
\r
1620 <dt class="ref">listitem</dt>
\r
1621 <dd>テンプレート変数をキーにした連想配列。値はテンプレート変数に置き換えられる内容。この配列にキーと値のペアを追加する事で、新しい変数が追加できます。</dd>
\r
1625 <td>PreCategoryListItem</td>
\r
1626 <td>(v3.40) カテゴリーリストが表示される前。カテゴリーリストを表示するために使われたテンプレートのカテゴリーリスト本体フィールドのテンプレート変数を追加/修正することを可能にします。追加のテンプレート変数についてのドキュメントも整備すべきです。</td>
\r
1628 <dt class="ref">listitem</dt>
\r
1629 <dd>テンプレート変数をキーにした連想配列。値はテンプレート変数に置き換えられる内容。この配列にキーと値のペアを追加する事で、新しい変数が追加できます。</dd>
\r
1633 <td>PreBlogListItem</td>
\r
1634 <td>(v3.40) ブログリストが表示される前。ブログリストを表示するために使われたテンプレートのブログリスト本体フィールドのテンプレート変数を追加/修正することを可能にします。追加のテンプレート変数についてのドキュメントも整備すべきです。</td>
\r
1636 <dt class="ref">listitem</dt>
\r
1637 <dd>テンプレート変数をキーにした連想配列。値はテンプレート変数に置き換えられる内容。この配列にキーと値のペアを追加する事で、新しい変数が追加できます。</dd>
\r
1641 <td>PreTemplateRead</td>
\r
1642 <td>(v3.40) テンプレートが読み込まれる直前。読み込むテンプレートを変更する事が出来ます。NP_MultiLanguage はこのイベントを使用しています。</td>
\r
1644 <dt class="ref">name</dt>
\r
1645 <dd>呼び出されるテンプレートの名前</dd>
\r
1649 <td>CustomLogin</td>
\r
1650 <td>(v3.40) Nucleus にログインする直前。ログインの手順をカスタマイズできます。外部認証を簡素化し、ログイン ID にメールアドレス等を使用出来る様になります。</td>
\r
1652 <dt class="ref">login</dt>
\r
1653 <dd>ユーザーが「ログインID」フィールドに入力した文字列。Nucleus のメンバーとして登録されているなら、プラグイン側で外部認証された「ログインID」と Nucleus のそれを紐つけるべきです。そうでないとクッキーがセットされず、ページを移動するごとにログアウトしてしまいます。</dd>
\r
1654 <dt class="ref">password</dt>
\r
1655 <dd>ユーザーが「パスワード」フィールドに入力した文字列。</dd>
\r
1656 <dt class="ref">success</dt>
\r
1657 <dd>認証が成功したかどうかのフラグ。「1」が成功。失敗だと「0」。初期値は「0」。プラグイン側でセットします。</dd>
\r
1658 <dt class="ref">allowlocal</dt>
\r
1659 <dd>整数値。プラグイン側で外部認証に失敗した後に、Nucleus のログインを試すかどうかのフラグ。「1」が試す「0」が試さない。初期値は「1」プラグイン側でセットします。</dd>
\r
1663 <td>PrePasswordSet</td>
\r
1664 <td>(v3.50)パスワードを設定する時に呼び出されます。パスワードの強度をプラグインで設定することが出来ます。</td>
\r
1666 <dt class="ro">password</dt>
\r
1667 <dd>ユーザーが入力したパスワード文字列</dd>
\r
1668 <dt class="ref">errormessage</dt>
\r
1669 <dd>エラーメッセージ。エラーが起きない場合は空白に設定します。</dd>
\r
1670 <dt class="ref">valid</dt>
\r
1671 <dd>設定しようとしているパスワードが妥当かどうかのフラグ。デフォルトは「真」。プラグインはこの値の妥当性を審査するべきです。</dd>
\r
1743 <h1>オプションを保存する<a id="options" name="options" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
1745 <p>プラグインに簡単にオプションを登録・取得できるように一連のメソッドが用意されています。これらのオプションは直接Nucleusの管理エリアで編集でき、プラグイン自身の管理エリアを用意する必要もなく、PHPファイルそのものの中にオプションの値を書き込まずにすみます。</p>
\r
1747 <p>オプションは異なったコンテクストで利用可能です。</p>
\r
1750 <li><strong>グローバルオプション</strong>:管理エリアのプラグインセクションで編集可能</li>
\r
1751 <li><strong>blogオプション</strong>:blog設定ページで編集可能</li>
\r
1752 <li><strong>カテゴリーオプション</strong>:blog設定ページ(のカテゴリー編集ページ)で編集可能</li>
\r
1753 <li><strong>メンバーオプション</strong>:メンバー編集ページで編集可能</li>
\r
1754 <li><strong>アイテムオプション</strong>:アイテムの追加、およびアイテムの編集ページで編集可能</li>
\r
1759 <p>オプションにはいくつかのタイプが提供されています。</p>
\r
1763 <dd>シンプルなテキスト</dd>
\r
1765 <dd>'yes'か'no'どちらか(編集画面ではラジオボタンとして表示されます)</dd>
\r
1767 <dd>テキストフィールド (編集画面では伏字で表示されます)</dd>
\r
1768 <dt>textarea (v2.2)</dt>
\r
1769 <dd>複数行のテキストフィールド</dd>
\r
1770 <dt>select (v2.2)</dt>
\r
1771 <dd>ドロップダウンメニュー。次のような形式の追加情報が必要です: Option 1|value1|Option 2|value2|Option 3|value3
\r
1777 <p>Nucleus v3.2よりオプション・メタデータを用いて、オプションタイプを正しい値を受け取れるように制限できるようになりました。このメタデータは <code>$typeExtras</code>フィールドにセミコロン区切りのリストで保存されます。注:selectオプションでは、selectリストは<code>$typeExtras</code>のなかで一番最初でなければいけません。</p>
\r
1779 <table summary="メタデータ"><tr>
\r
1780 <th abbr="key">キー</th>
\r
1781 <th abbr="desc">説明</th>
\r
1783 <td><code>datatype</code></td>
\r
1784 <td>Nucleus本体に、どのデータ型を使いたいかという追加情報を与えます。現在は '<code>numerical</code>' のみ利用できます。 '<code>numerical</code>' を指定することでNucleusは数値情報のみを受け付けます(クライアントサイド・サーバサイド両方でチェック) ('<code>select</code>' と '<code>text</code>'のオプションタイプで利用できます)</td>
\r
1786 <td><code>access</code></td>
\r
1787 <td>'<code>readonly</code>'にセットすることで、オプションを編集不可能にします('<code>text</code>' と '<code>textarea</code>'のオプションタイプで利用できます)<br />
\r
1788 '<code>hidden</code>'を使うと、利用者側にそのオプションの存在を完全に隠蔽します('<code>text</code>'のオプションタイプで利用できます)</td>
\r
1792 <pre class="example"><code>// 数値のみを受け付けるテキストオプションを作成
\r
1793 $this->createBlogOption('FooBar', 'foobar', 'text', '0', 'datatype=numerical');
\r
1794 // 数値のみを受け付けるセレクトオプションを作成
\r
1795 $this->createItemOption('FooBar', 'foobar', 'select', '0', '0|0|1|1|2|2;datatype=numerical');
\r
1796 // 編集不可能なテキストエリアオプションを作成
\r
1797 $this->createOption('FooBar', 'foobar', 'textarea', 'This textarea is readonly', 'access=readonly');
\r
1803 <li>オプション名は最大20文字です。</li>
\r
1804 <li>オプションの説明文は最大255文字です。</li>
\r
1805 <li>オプションの値は制限ありません(v2.2より前のバージョンでは128文字の制限がありました)</li>
\r
1806 <li>'=', '|', ';' のキャラクターはセレクトオプション用のセレクトリストやオプション・メタデータ中で使用することはできません。</li>
\r
1811 <h3>createOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>
\r
1813 <p><strong>グローバル</strong>なコンテクストで新しいオプションを生成します。</p>
\r
1815 <table summary="createOption"><tr>
\r
1816 <th abbr="param">パラメータ</th>
\r
1817 <th abbr="value">値</th>
\r
1823 <td>オプション編集画面で表示される説明文</td>
\r
1826 <td>オプションタイプ(前出)</td>
\r
1828 <td>$defValue</td>
\r
1831 <td>$typeExtras</td>
\r
1832 <td>オプションタイプの追加情報(前出)</td>
\r
1835 <h3>[v2.2] createBlogOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>
\r
1837 <p><strong>blog</strong>のコンテクストで新しいオプションを生成します(<code>createOption</code>を参照)。</p>
\r
1839 <h3>[v2.2] createCategoryOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>
\r
1841 <p><strong>カテゴリー</strong>のコンテクストで新しいオプションを生成します(<code>createOption</code>を参照)。</p>
\r
1843 <h3>[v2.2] createMemberOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>
\r
1845 <p><strong>メンバー</strong>のコンテクストで新しいオプションを生成します(<code>createOption</code>を参照)。</p>
\r
1847 <h3>[v3.2] createItemOption($name, $desc, $type, $defValue = '', $typeExtras = '')</h3>
\r
1849 <p><strong>アイテム</strong>のコンテクストで新しいオプションを生成します(<code>createOption</code>を参照)。</p>
\r
1851 <h3>setOption($name, $value)</h3>
\r
1853 <p>すでにデータベースに存在するオプションの値を変更します。</p>
\r
1855 <table summary="setOption"><tr>
\r
1856 <th abbr="param">パラメータ</th>
\r
1857 <th abbr="value">値</th>
\r
1866 <h3>[v2.2] setBlogOption($blogid, $name, $value)</h3>
\r
1868 <p>blogオプションの値を変更します。<code>blogid</code>属性はどのblogでそのオプションが有効かを示します(その他のオプション:<code>setOption</code>を参照)。</p>
\r
1870 <h3>[v2.2] setCategoryOption($catid, $name, $value)</h3>
\r
1872 <p>カテゴリーオプションの値を変更します。<code>catid</code>属性はどのカテゴリーでそのオプションが有効かを示します(その他のオプション:<code>setOption</code>を参照)。</p>
\r
1874 <h3>[v2.2] setMemberOption($memberid, $name, $value)</h3>
\r
1876 <p>メンバーオプションの値を変更します。<code>memberid</code>属性はどのメンバーでそのオプションが有効かを示します(その他のオプション:<code>setOption</code>を参照)。</p>
\r
1878 <h3>[v3.2] setItemOption($itemid, $name, $value)</h3>
\r
1880 <p>アイテムオプションの値を変更します。<code>itemid</code>属性はどのアイテムでそのオプションが有効かを示します(その他のオプション:<code>setOption</code>を参照)。</p>
\r
1882 <h3>getOption($name)</h3>
\r
1884 <p>データベース内のオプションの値を返します。</p>
\r
1886 <table summary="getOption"><tr>
\r
1887 <th abbr="param">パラメータ</th>
\r
1888 <th abbr="value">値</th>
\r
1894 <h3>[v2.2] getBlogOption($blogid, $name)</h3>
\r
1896 <p>blogオプションの値を返します。<code>blogid</code>属性は値がリスエストされたblogを示します(その他のオプション:<code>getOption</code>を参照)。</p>
\r
1898 <h3>[v2.2] getCategoryOption($catid, $name)</h3>
\r
1900 <p>カテゴリーオプションの値を返します。<code>catid</code>属性は値がリスエストされたカテゴリーを示します(その他のオプション:<code>getOption</code>を参照)。</p>
\r
1902 <h3>[v2.2] getMemberOption($memberid, $name)</h3>
\r
1904 <p>メンバーオプションの値を返します。<code>memberid</code>属性は値がリスエストされたメンバーを示します(その他のオプション:<code>getOption</code>を参照)。</p>
\r
1906 <h3>[v3.2] getItemOption($itemid, $name)</h3>
\r
1908 <p>アイテムオプションの値を返します。<code>itemid</code>属性は値がリスエストされたアイテムを示します(その他のオプション:<code>getOption</code>を参照)。</p>
\r
1910 <h3>deleteOption($name)</h3>
\r
1912 <p>データベースからオプションを削除します。</p>
\r
1914 <table summary="deleteOption"><tr>
\r
1915 <th abbr="param">パラメータ</th>
\r
1916 <th abbr="value">値</th>
\r
1922 <h3>[v2.2] deleteBlogOption($name)</h3>
\r
1924 <p>blogオプションを削除します(<code>deleteOption</code>を参照)。</p>
\r
1926 <h3>[v2.2] deleteCategoryOption($name)</h3>
\r
1928 <p>カテゴリーオプションを削除します(<code>deleteOption</code>を参照)。</p>
\r
1930 <h3>[v2.2] deleteMemberOption($name)</h3>
\r
1932 <p>メンバーオプションを削除します(<code>deleteOption</code>を参照)。</p>
\r
1934 <h3>[v3.2] deleteItemOption($name)</h3>
\r
1936 <p>アイテムオプションを削除します(<code>deleteOption</code>を参照)。</p>
\r
1938 <h3>[v2.2] getAllBlogOptions($name)</h3>
\r
1940 <p>与えられたblogオプションの全ての値を返します。結果は存在するblogidごとの連想配列です。</p>
\r
1942 <h3>[v2.2] getAllCategoryOptions($name)</h3>
\r
1944 <p>与えられたカテゴリーオプションの全ての値を返します。結果は存在するcatidごとの連想配列です。</p>
\r
1946 <h3>[v2.2] getAllMemberOptions($name)</h3>
\r
1948 <p>与えられたメンバーオプションの全ての値を返します。結果は存在するmemberidごとの連想配列です。</p>
\r
1950 <h3>[v3.2] getAllItemOptions($name)</h3>
\r
1952 <p>与えられたアイテムオプションの全ての値を返します。結果は存在するitemidごとの連想配列です。</p>
\r
1954 <h3>[v3.2] getBlogOptionTop($name, $amount = 10, $sort = 'desc')</h3>
\r
1956 <p>与えられたオプションの最初の値を返します。結果は配列で、各要素がそれぞれのblogid ('id') の値 ('value') を持つ配列になっています。</p>
\r
1958 <table summary="getOption"><tr>
\r
1959 <th abbr="param">パラメータ</th>
\r
1960 <th abbr="value">値</th>
\r
1966 <td>必要なオプション数</td>
\r
1969 <td>昇順 ('asc') か降順 ('desc') で並べ替え</td>
\r
1972 <h3>[v3.2] getMemberOptionTop($name, $amount = 10, $sort = 'desc')</h3>
\r
1974 <p>与えられたオプションの最初の値を返します。結果は配列で、各要素がそれぞれのメンバーID ('id') の値 ('value') を持つ配列になっています(パラメータは<code>getBlogOptionTop</code>を参照)。</p>
\r
1976 <h3>[v3.2] getCategoryOptionTop($name, $amount = 10, $sort = 'desc')</h3>
\r
1978 <p>与えられたオプションの最初の値を返します。結果は配列で、各要素がそれぞれのカテゴリーID ('id') の値 ('value') を持つ配列になっています(パラメータは<code>getBlogOptionTop</code>を参照)。</p>
\r
1980 <h3>[v3.2] getItemOptionTop($name, $amount = 10, $sort = 'desc')</h3>
\r
1982 <p>与えられたオプションの最初の値を返します。結果は配列で、各要素がそれぞれのアイテムID ('id') の値 ('value') を持つ配列になっています(パラメータは<code>getBlogOptionTop</code>を参照)。</p>
\r
1984 <div class="note">
\r
1985 <strong>注:</strong> プラグインクラス内のコンストラクタから、これらのファンクションを呼ぶことはできません。プラグインがロードされた後にこれらを実行したいときは、かわりに<code>init()</code>メソッド内に置きます。
\r
1988 <h1>データベース・テーブル<a id="tables" name="tables" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
1990 <h2>Nucleusテーブルへのアクセス</h2>
\r
1992 <p>v2.0まで、Nucleusテーブルへのアクセスは単に<code>nucleus_</code>と名づけられたテーブルに対してSQL命令を実行するだけのものでした。Nucleusのバージョン2.2以降はカスタム・テーブル名を利用できるようになったため、プラグイン開発に若干注意する必要があります。</p>
\r
1993 <p>v3.5でNucleusはPDO等MySQL以外のデータベースハンドラのサポートをするようになりました。この機能はベータ実装ではありますが、プラグイン開発者はデータベースの呼び出しに使用する関数の「sql_*」への書き換えを始めてください。
\r
1994 基本的に、使用している全ての「mysql_*」関数を「sql_*」に置き換える必要があります。たとえば<code>mysql_fetch_assoc($result)</code>は<code>sql_fetch_assoc($result)</code> に置き換えになります。
\r
1995 全ての関数を書き換えたら、Sql APIが無い古いバージョンのNucleusインストールできないように、次に示すコードをプラグイン内に記述して、インストールに必要な最低バージョンを350に指定する必要があります。<br />
\r
1996 <code>function getMinNucleusVersion( return '350';)</code></p>
\r
1999 <li><code>nucleus_item</code> などの固定されたテーブル名の代わりに、テーブル名のプレフィックスを生成するために <code>sql_table('item') </code>というグローバルファンクションを利用します。</li>
\r
2000 <li><code>supportsFeature('SqlTablePrefix')</code> が呼ばれたときにプラグインが1(真)を返すようにします。これがないと、カスタムプレフィックスがセットされている場合でバージョンが2.0より大きいNucleusではプラグインをロードできません(用心のため)。</li>
\r
2001 <li>3.5以降:<code>supportsFeature('SqlApi')</code> が呼ばれたときにプラグインが1(真)を返すようにします。3.5以降のバージョンでは、データベースのバックエンドにmysqlでないものを使用している場合にプラグインをロードできなくなります(用心のため)。</li>
\r
2004 <p class="note">v2.0までのNucleusではグローバルファンクション <code>sql_table</code> は利用できないことに注意してください。もしこのメソッドを用いつつ、プラグインをv2.0以下のNucleusで動作させたい場合は、以下のコードをプラグインクラスの前に追加してください。</p>
\r
2006 <pre class="example"><code><?
\r
2008 // プラグインがNucleusバージョン2.0以下と互換性を持つために必要
\r
2009 if (!function_exists('sql_table'))
\r
2011 function sql_table($name) {
\r
2012 return 'nucleus_' . $name;
\r
2016 class NP_HelloWorld extends NucleusPlugin {
\r
2020 ?></code></pre>
\r
2024 <p>もしプラグイン独自のテーブルが必要なら、<code>install</code>メソッドの中で独自テーブルを生成し、<code>unInstall</code>メソッドの中でそれを削除するようにします。</p>
\r
2028 <li><code>nucleus_plug_<em>plugname</em></code> のように、他のプラグインと競合しないテーブル名を考えてください。カスタムプレフィックスに対応するため、テーブル名を<code>sql_table('plug_plugname')</code> で生成してください。</li>
\r
2029 <li>自分自身でデータベース接続をする必要はありません。PHPコマンド <code>mysql_query()</code> を使ってSQL命令を実行できます。</li>
\r
2030 <li>自分でデータベース接続をする場合、後でNucleusデータベースへの接続を復元するようにしてください。自前処理の後で <code>sql_connect()</code> を呼ぶことで可能です。頻繁な再接続を避けるために、コンストラクタでそれを行うのも良いです。<code>$this- >db</code>のリンクIDを保持でき、各クエリにそれを渡すことができます。</li>
\r
2031 <li>バックアップ機能を使う時は、独自テーブルもバックアップに含めるよう、<code>getTableList()</code> を再定義してください。</li>
\r
2032 <li>ユーザーがプラグインをアップデートする時や、何らかの理由で一時的にプラグインをアンインストールしなければならない時、やプラグイン独自のテーブルの内容が失われる事があります。そうならないように、テーブルを削除するか否かをプラグインオプションで設定できるようにしておくといいでしょう。テーブルの削除をオプションでコントロールするには、install()メソッドで次のようなオプションを作成します。
\r
2033 <pre class="example"><code>$this->createOption('del_uninstall', 'Delete NP_MyPlugin data tables on uninstall?', 'yesno','no');</code></pre>
\r
2034 そしてuninstall()メソッドで、次のようにします。
\r
2035 <pre class="example"><code>if ($this->getOption('del_uninstall') == 'yes') {
\r
2036 foreach ($this->getTableList() as $table) {
\r
2037 sql_query("DROP TABLE $table");
\r
2039 }</code></pre></li>
\r
2044 <h1>プラグイン管理エリア<a id="admin" name="admin" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
2046 <p>Ver2.5から、Nucleusの管理エリアに統合されたプラグイン管理エリアを作成できます。これらのページは従来のプラグイン管理ページや左側のクイックメニューからアクセスできます。</p>
\r
2050 <p>管理エリアを提供するには、次のステップが必要です。</p>
\r
2053 <li>プラグインディレクトリに<strong>プラグイン名</strong>のサブディレクトリを作ります。たとえばプラグイン名が<code>NP_PluginName</code>なら、'pluginname'です。ディレクトリ名はすべて小文字で!</li>
\r
2055 そのディレクトリで、次のような<strong>index.php</strong>を用意します。
\r
2056 <pre><code><?php
\r
2058 // if your 'plugin' directory is not in the default location,
\r
2059 // edit this variable to point to your site directory
\r
2060 // (where config.php is)
\r
2061 $strRel = '../../../';
\r
2063 include($strRel . 'config.php');
\r
2064 if (!$member->isLoggedIn())
\r
2065 doError('You\'re not logged in.');
\r
2067 include($DIR_LIBS . 'PLUGINADMIN.php');
\r
2069 // create the admin area page
\r
2070 $oPluginAdmin = new PluginAdmin('<strong>PluginName</strong>');
\r
2071 $oPluginAdmin->start();
\r
2073 echo '<h2>プラグイン名</h2>';
\r
2075 echo '<p><strong>ページ内容</strong><p>';
\r
2077 $oPluginAdmin->end();
\r
2079 ?></code></pre>
\r
2082 プラグイン側に次のコードを挿入し、クイックメニューイベントに登録します。
\r
2083 <pre><code>function event_QuickMenu(&$data) {
\r
2087 'title' => '<strong>プラグイン名</strong>',
\r
2088 'url' => $this-%gt;getAdminURL(),
\r
2089 'tooltip' => '<strong>ツールチップテキスト</strong>'
\r
2095 プラグイン側に次の関数を記述します。
\r
2096 <pre><code>function hasAdminArea()
\r
2101 <li> オプション。クイックメニュー登録のオプションを作成し、誰に表示するか制限します。<code>quickmenu</code>という<code>yesno</code>タイプのオプションがinstall()にあるとします。次のように、クイックメニュー登録の表示を最高管理者とブログ管理者に制限します。
\r
2102 <pre class="example"><code>function event_QuickMenu(&$data) {
\r
2103 // only show when option enabled
\r
2104 if ($this->getOption('quickmenu') != 'yes') return;
\r
2106 if (!$member->isAdmin() && !count($member->getAdminBlogs())) return;
\r
2107 array_push($data['options'],
\r
2108 array('title' => 'PluginName',
\r
2109 'url' => $this->getAdminURL(),
\r
2110 'tooltip' => 'Administer NP_PluginName'));
\r
2118 <li>登録できるからといって安易にクイックメニューへ登録しないこと。クイックメニューにプラグインが100個並んだりしたらかなりウンザリするでしょう。ですので、クイックメニューに登録する場合でも、クイックメニュー登録を有効・無効化するプラグインオプションを(グローバルまたはメンバーオプションで)用意することを考えてください。</li>
\r
2119 <li><code>プラグインディレクトリが nucleus/plugins/ ではない場合は、index.php内の $strRel</code> 変数は手動で書き換える必要があります。</li>
\r
2120 <li>管理エリアのアウトプットが<strong>正しいXHTML</strong>になっているか確認してください。正しくないと、MozillaなどのGeckoベースのブラウザでページ表示が崩れます。</li>
\r
2123 <h2>PluginAdmin クラス</h2>
\r
2125 <p><code>PluginAdmin</code> クラスは助けになります。これを一度生成すれば、<code>$oPluginAdmin->plugin</code> でプラグインのインスタンスにアクセスできます。</p>
\r
2127 <h1>プラグイン用ヘルプページ <a id="help" name="help" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
2129 <p>Nucleus v3.2から、プラグインの機能の概要、利用できるスキン・テンプレート変数、さらに詳細な情報のありかなどを示すヘルプページを提供可能になりました。</p>
\r
2131 <p>ヘルプページは管理画面のプラグイン一覧からアクセス可能になります。</p>
\r
2134 <p>ヘルプページを提供するために、次のステップが必要です。</p>
\r
2136 <li>プラグインディレクトリに、プラグイン名をつけたサブディレクトリを作成します。ディレクトリ名は小文字であることに注意します。<a href="#admin">管理エリア</a>を作るときと同様です。</li>
\r
2137 <li>そのディレクトリの中に help.html を作り、プラグインについての文章を記述します。次の雛型からはじめると良いでしょう。
\r
2138 <pre><code><h3>プラグインの概要</h3>
\r
2140 <p>このプラグインはヘルプページがいかに機能するかを示すためだけのものです</p>
\r
2142 <h3>インストール</h3>
\r
2144 <p>これを読めてるならインストールは正しく出来てます :-)</p>
\r
2146 <h3>スキン変数</h3>
\r
2148 <p>このプラグインはただのテストケースなのでスキン・テンプレート変数はありませんが、書くとすれば。
\r
2150 <ul><li><b><%HelpPageTestCase1%></b>: なにかをする</li>
\r
2151 <li><b><%HelpPageTestCase1(foobar)%></b>: 別のなにかをする</li></ul></p>
\r
2153 <h3>サポートとバグ報告</h3>
\r
2155 <p>さらなるサポートやバグ報告のために、次のフォーラムのスレッドを利用してください。
\r
2156 <a href="http://forum.nucleuscms.org/viewtopic.php?t=<トピックID>">
\r
2157 http://forum.nucleuscms.org/viewtopic.php?t=<トピックID></a></p>
\r
2159 <h3>バージョン履歴</h3>
\r
2161 <ul><li>Version 0.1: 最初のテストケースバージョン</li>
\r
2162 <li>Version 0.0: その前のバージョン ;-)</li></ul></code></pre>
\r
2164 <li>supportsFeature('HelpPage') で0より大きい数字を返すように設定します。
\r
2165 <pre><code>function supportsFeature($what) {
\r
2176 <h1>プラグイン依存チェック <a id="dependency" name="dependency" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
2178 <p>v3.2から、他のプラグインとの依存関係を宣言する新しいプラグインインターフェイスが追加されました。
\r
2179 他のプラグインの機能を必要とするプラグインに利用できます。特に依存関係が成立しなくて正しく機能しない状態を検知するときに便利です。</p>
\r
2181 <h2>この機能を利用するプラグインの書き方</h2>
\r
2183 <p>現実世界での例からはじめましょう。</p>
\r
2185 <p>NP_PageLinkList は NP_BlogWithOffset の機能を利用するため、利用者には NP_BlogWithOffset のインストール後に NP_PageLinkList をインストールさせたいとします。
\r
2186 NucleusはこのAPIによって、インストール前に依存関係を検知させる方法をプラグインに提供します。</p>
\r
2188 <p>このケースでは、NP_PageLinkList 側に NP_BlogWithOffset が必要だということを認識させるコードを埋め込みます。
\r
2189 プラグインがインストールされる際に、Nucleusコアは <code>getPluginDep()</code> というファンクションを呼び出します。
\r
2190 このファンクションは必要なプラグインのリストを返し、コアはインストール済みのプラグインをチェックして、もし依存関係に欠如があればインストールを拒否します。</p>
\r
2192 <p>必要なことは NP_PageLinkList にこのファンクションを追加する、ただそれだけです。</p>
\r
2194 <pre><code>function getPluginDep() {
\r
2195 return array('NP_BlogWithOffset');
\r
2198 <p>このプラグイン依存チェックは、他のプラグインが依存しているプラグインがアンインストールされることも防ぎます。</p>
\r
2200 <h1>プラグインの多国語化<a name="internationalization" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
2202 <h2>プラグインをより多くの人に使ってもらうために</h2>
\r
2204 <p>あなたと同じ言葉を話さない世界中の人達がプラグインをより使いやすくするために、プラグインを多国語化できます。
\r
2205 少し手間は増えますが、プラグインが出力する文章を翻訳するだけで可能です。
\r
2206 以下に Nucleus のコアで用意されている標準的な手順を記載します。
\r
2210 <li><strong>プラグインを作る</strong>
\r
2212 先ずはじめに、あなたが普段使っている言葉でプラグインを作ります。プラグインが安定して動作するようになってから、言語ファイルを作成することが推奨されます。</li>
\r
2213 <li><strong>プラグインディレクトリを作る</strong>
\r
2215 作ったプラグインの名前が NP_AbcDef なら、プラグインディレクトリの名前は abcdef になります(必ず小文字を使用すること)。</li>
\r
2216 <li><strong>言語ファイルを作る</strong>
\r
2218 プラグインディレクトリに言語ファイルを作成します。言語ファイルの名前は Nucleus コアが使用しているものと同じにします。例えば、英語なら english.php。日本語の UTF-8 なら japanese-utf8.phpになります(UTF がお勧めです。参考までに日本語の EUC の場合は japanese-euc.php になります)。</li>
\r
2219 <li><strong>文を定義する</strong>
\r
2221 次のように言語ファイル内で分を定義します。
\r
2223 <pre class="example"><code><?php
\r
2224 define('_ABCDEF_MESSAGENAME', '実際のメッセージ');
\r
2226 ?></code></pre>
\r
2228 全ての文を定義する必要があります。定数は一回しか定義できないので、既に定義されているものと重複しないようにプラグインの名前をはじめにつけることが推奨されます(この例だと _ABCDEF)。</li>
\r
2229 <li><strong>文の置き換え</strong>
\r
2231 全ての文を、言語ファイルで定義した定数と置き換えます</li>
\r
2232 <li><strong>init() メソッドの編集</strong>
\r
2234 プラグイン内の init() メソッドを、次のように編集します(既に init() メソッドを定義している場合は init() メソッド内にコードを追記します)。
\r
2236 <pre class="example"><code> function init() {
\r
2237 // include language file for this plugin
\r
2238 $language = ereg_replace( '[\\|/]', '', getLanguageName());
\r
2239 if (file_exists($this->getDirectory().$language.'.php'))
\r
2240 include_once($this->getDirectory().$language.'.php');
\r
2242 include_once($this->getDirectory().'english.php');
\r
2244 このコードは Nucleus のコアで使用されているものと同一です。</li>
\r
2246 <li><strong>言語ファイルの追加</strong>
\r
2248 「英語」が基本の言語になっていますので、「英語」の言語ファイルも追加することが望まれます。</li>
\r
2253 <h1>スキン変数の出力の書式 <a name="skinvar-formatting" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
2255 <p>偉大なプラグインのいくつかは、様々なスキンや URL の生成において、必ずしもそのまま使用できるとはいえません。なぜなら、doSkinVar() メソッドによって出力されるものが、
\r
2256 ユーザーのニーズに十二分に合致するものであるとは言いがたいからです。Nucleus では、出力をここのユーザーによっておのおののニーズに沿ったものにする為に、いくつかのツールを用意しています。</p>
\r
2260 <p>各ブログ・カテゴリー・アイテム・メンバー、それから action.php や管理エリア、または各プラグインの管理エリアなどの URL を出力する為に、Nucleus はコアの機能として
\r
2261 いくつかのファンクションとグローバル変数を用意しています。:</p>
\r
2263 <table summary="Nucleus の各ページへのリンクを生成する為に便利な変数とファンクション">
\r
2264 <caption>Nucleus の各ページへのリンクを生成する為に便利な変数とファンクション</caption>
\r
2266 <th>名前</th><th>種類</th><th>引数</th><th>説明</th>
\r
2269 <td><code>$CONF['AdminURL']</code></td>
\r
2272 <td>Nucleus の管理領域への絶対 URL</td>
\r
2275 <td><code>$CONF['PluginURL']</code></td>
\r
2278 <td>Nucleus のプラグインディレクトリへの絶対 URL。<code>$CONF['PluginURL'].'pluginname/'</code> の様にして、プラグインの管理エリアへのリンク生成に使用する。</td>
\r
2281 <td><code>$CONF['ActionURL']</code></td>
\r
2284 <td>Nucleus の action.php への絶対 URL。</td>
\r
2287 <td><code>$CONF['MediaURL']</code></td>
\r
2290 <td>Nucleus のメディアディレクトリへの絶対 URL。</td>
\r
2293 <td><code>$CONF['SkinsURL']</code></td>
\r
2296 <td>Nucleus のスキンディレクトリへの絶対 URL。</td>
\r
2299 <td><code>$CONF['IndexURL']</code></td>
\r
2302 <td>Nucleus のメインディレクトリへの絶対 URL。</td>
\r
2305 <td><code>$DIR_NUCLEUS</code></td>
\r
2308 <td>Nucleus のメインディレクトリへのシステムルートからのフルパス。</td>
\r
2311 <td><code>$DIR_SKINS</code></td>
\r
2314 <td>Nucleus のスキンディレクトリへのシステムルートからのフルパス。</td>
\r
2317 <td><code>$DIR_MEDIA</code></td>
\r
2320 <td>Nucleus のメディアディレクトリへのシステムルートからのフルパス。</td>
\r
2323 <td><code>$DIR_PLUGINS</code></td>
\r
2326 <td>Nucleus のプラグインディレクトリへのシステムルートからのフルパス。</td>
\r
2329 <td><code>$DIR_LANG</code></td>
\r
2332 <td>Nucleus の言語ファイルディレクトリへのシステムルートからのフルパス。</td>
\r
2335 <td><code>$DIR_LIBS</code></td>
\r
2338 <td>Nucleus のコアディレクトリへのシステムルートからのフルパス。</td>
\r
2341 <td><code>getAdminURL()</code></td>
\r
2342 <td>PLUGIN クラス内メソッド</td>
\r
2344 <td>プラグインの管理エリアディレクトリが存在すればその URL を返す(存在しない場合は無効)。</td>
\r
2347 <td><code>getDirectory()</code></td>
\r
2348 <td>PLUGIN クラス内メソッド</td>
\r
2350 <td>プラグインの追加ファイルが格納されたサーバーのファイルシステムのパスを返します(存在しない場合は無効)。結果は".../nucleus/plugins/plugname/"のようになります。</td>
\r
2353 <td><code>createItemLink($itemid, $extra = '')</code></td>
\r
2354 <td>グローバルファンクション</td>
\r
2355 <td><code>$itemid</code> 整数。リンクしたいアイテムの ID。<br />
\r
2356 <code>$extra</code> 連想配列。「キー」と「値」のペアが、URL の「パラメータ」と「値」に反映される。
\r
2358 <td>ユーザーによって選択されたスキームにより、 <code>$itemid</code> に対応したアイテムへのリンクが生成されます。</td>
\r
2361 <td><code>createMemberLink($memberid, $extra = '')</code></td>
\r
2362 <td>グローバルファンクション</td>
\r
2363 <td><code>$memberid</code> 整数。リンクしたい存在するメンバーの ID。<br />
\r
2364 <code>$extra</code> 連想配列。「キー」と「値」のペアが、URL の「パラメータ」と「値」に反映される。
\r
2366 <td>ユーザーによって選択されたスキームにより、 <code>$memberid</code> に対応したメンバーへのリンクが生成されます。</td>
\r
2369 <td><code>createCategoryLink($catid, $extra = '')</code></td>
\r
2370 <td>グローバルファンクション</td>
\r
2371 <td><code>$catid</code> 整数。リンクしたいカテゴリーの ID。<br />
\r
2372 <code>$extra</code> 連想配列。「キー」と「値」のペアが、URL の「パラメータ」と「値」に反映される。
\r
2374 <td>ユーザーによって選択されたスキームにより、 <code>$catid</code> に対応したカテゴリーへのリンクが生成されます。</td>
\r
2377 <td><code>createArchiveListLink($blogid = '', $extra = '')</code></td>
\r
2378 <td>グローバルファンクション</td>
\r
2379 <td><code>$blogid</code> 整数。リンクしたいアーカイブ一覧が存在ブログの ID。<br />
\r
2380 <code>$extra</code> 連想配列。「キー」と「値」のペアが、URL の「パラメータ」と「値」に反映される。
\r
2382 <td>ユーザーによって選択されたスキームにより、 <code>$blogid</code> に対応したアーカイブ一覧へのリンクが生成されます。</td>
\r
2385 <td><code>createArchiveLink($blogid, $archive, $extra = '')</code></td>
\r
2386 <td>グローバルファンクション</td>
\r
2387 <td><code>$blogid</code> 整数。リンクしたい月別アーカイブが存在するブログの ID。<br />
\r
2388 <code>$archive</code> 文字列。アーカイブのパラメータとして、渡した「日(または年、月)」のものが存在するもの。<br />
\r
2389 <code>$extra</code> 連想配列。「キー」と「値」のペアが、URL の「パラメータ」と「値」に反映される。
\r
2391 <td>ユーザーによって選択されたスキームにより、 <code>$blogid</code> に対応した月別アーカイブへのリンクが生成されます。</td>
\r
2394 <td><code>createBlogidLink($blogid, $extra = '')</code></td>
\r
2395 <td>グローバルファンクション</td>
\r
2396 <td><code>$blogid</code> 整数。リンクしたいブログの ID。<br />
\r
2397 <code>$extra</code> 連想配列。「キー」と「値」のペアが、URL の「パラメータ」と「値」に反映される。
\r
2399 <td>ユーザーによって選択されたスキームにより、 <code>$blogid</code> に対応したブログへのリンクが生成されます。</td>
\r
2403 <h2>スキンへの出力にテンプレートを使う</h2>
\r
2405 <p>出力する文字列をテンプレートを使って整形出来るようにしましょう。あなたが順不同のリストで出力したいと考えていたとしても、別のユーザーは同じデータを
\r
2406 記号で区切ったり、特別な形で出力したいと考えるかもしれません。Nucleus にはテンプレートデータを作ったり定義したりする2種類の方法があります。
\r
2407 次に上げるれいの両方において、<code><%foo%></code> と <code><%bar%></code> のふたつのテンプレート変数を使用します。</p>
\r
2410 <li><strong>プラグインのオプションを使う方法。</strong>この方法は v3.2 以降で使用でき、次のように <code>install()</code> メソッド
\r
2411 に記述する事によって簡単に作成する事が出来ますが、アップグレードのためにプラグインを削除した時に、ユーザーは同時にカスタマイズした
\r
2412 テンプレートを失ってしまうという大きなデメリットがあります。
\r
2413 <pre class="example"><code>$this->createOption('my_template',
\r
2414 'プラグインの出力の為のテンプレート',
\r
2416 '<li><%foo%> loves <%bar%></li>');</code></pre>
\r
2417 <code>doSkinVar()</code> メソッドで、<code>foo</code> と <code>bar</code> を次のように定義して、テンプレートを埋めます。
\r
2418 <pre class="example"><code>$mytemplate = $this->getOption('my_template');
\r
2421 'foo'=>'Ricky',
\r
2422 'bar'=>'Lucy'),
\r
2425 'bar'=>'Nancy'),
\r
2427 'foo'=>'Mickey',
\r
2428 'bar'=>'Minnie')
\r
2430 foreach ($couples as $values) {
\r
2431 echo TEMPLATE::fill($mytemplate,$values);
\r
2433 これでプラグインのスキン変数 <code><%TemplateTest%></code> を書いたところに、次のように出力されます。
\r
2434 <pre class="example"><code><li>Ricky loves Lucy</li>
\r
2435 <li>Sid loves Nancy</li>
\r
2436 <li>Mickey loves Minnie</li></code></pre>
\r
2439 <li><strong>Nucleus コアのテンプレートシステムを使う方法。</strong>この方法は v3.4以降で使用できます。この方法の利点は、他のテンプレートと
\r
2440 同じようにデータベースに格納され、配布用にテンプレートをエクスポートできるところにあります。この API を使用したプラグインのサンプルが、
\r
2441 フォーラムの<a href="http://japan.nucleuscms.org/bb/viewtopic.php?p=24401#24401" title="Sample">新API「TemplateExtraFields」を使ったプラグインの見本</a>に
\r
2442 (本家フォーラムのスレッドは <a href="http://forum.nucleuscms.org/viewtopic.php?p=87672#87672" title="Sample">Skin specific values for Plugins</a>)
\r
2443 にあります。細かな点は本家フォーラムの <a href="http://forum.nucleuscms.org/viewtopic.php?p=87672#87672" title="Sample">Skin specific values for Plugins</a> スレッド
\r
2444 を参照してください。ここでは要約のみ書いてあります。
\r
2445 まず、<code>install()</code> メソッド中でプラグインオプションを作成し、ここでテンプレートのデフォルトの内容を定義します。
\r
2446 <pre class="example"><code>$this->createOption('my_template',
\r
2447 'Template used to format output of plugin.',
\r
2449 '<li><%foo%> loves <%bar%></li>');</code></pre>
\r
2450 次に割り込みをかけるイベントのリストに <code>TemplateExtraFields</code> を登録します。
\r
2451 <pre class="example"><code>function getEventList() { return array('TemplateExtraFields'); }</code></pre>
\r
2452 そして、<code>event_TemplateExtraFields</code> メソッドを作成します。
\r
2453 <pre class="example"><code>function event_TemplateExtraFields(&$data) {
\r
2454 /* Add an element in the $data['fields'] array using your plugin name as the key
\r
2455 and an associative array containing the field name and field label*/
\r
2456 /* note that your field names should be lowercase and include the name
\r
2457 of your template as shown below. This will ensure that all template field names are unique. */
\r
2458 $data['fields']['NP_TemplateTest'] = array(
\r
2459 'templatetest_body'=>'TemplateTest Body'
\r
2462 最後に <code>doSkinVar()</code> メソッドで、テンプレートを埋めます。この時、スキン変数の引数に使用するテンプレート名が必要です。
\r
2463 <pre class="example"><code>function doSkinVar($skinType,$template = '') {
\r
2464 global $blog, $CONF, $manager,$member;
\r
2466 $template =& $manager->getTemplate($template);
\r
2467 if (trim($template['templatetest_body']) == '')
\r
2468 $template['templatetest_body'] = $this->getOption('my_template');
\r
2472 'foo'=>'Ricky',
\r
2473 'bar'=>'Lucy'),
\r
2476 'bar'=>'Nancy'),
\r
2478 'foo'=>'Mickey',
\r
2479 'bar'=>'Minnie')
\r
2481 foreach ($couples as $values) {
\r
2482 echo TEMPLATE::fill($template['templatetest_body'],$values);
\r
2485 ユーザーは『テンプレート編集』画面で、「TemplateTest Body」フィールドに出力したい形式でテンプレートを編集します。
\r
2486 例えば「default/index」テンプレートを使って、こんな風にテンプレートを編集します。
\r
2487 <pre class="example"><code><li><%foo%> loves <%bar%>!!!</li></code></pre>
\r
2488 そしてスキンに <code><%TemplateTest(default/index)%></code> と書くと、そこに
\r
2489 <pre class="example"><code><li>Ricky loves Lucy!!!</li>
\r
2490 <li>Sid loves Nancy!!!</li>
\r
2491 <li>Mickey loves Minnie!!!</li></code></pre>と表示されます。<br />
\r
2494 <li><strong>通常のテンプレートを使って書式化。</strong>この方法は v3.4 以降で、アイテムを出力するプラグインで使用できます。
\r
2495 この方法にはコアのテンプレートシステムの既存の「アイテム」フィールドを使うというアドバンテージがあり、スキン変数の <code><%blog%></code>
\r
2496 の様に使用します。スキン変数の引数として、一つ以上のアイテムの ID と使用するテンプレート名を、また、BLOG クラスの <code>readLogFromList()</code>
\r
2497 メソッドを呼び出せることが条件です。テンプレート変数として使用したい場合は、<code>doTemplateVar()</code> メソッドで使用することも出来ます。
\r
2498 例として <code>doSkinVar()</code> メソッドでこのテクニックを使う方法を示しておきます。
\r
2499 4つのアイテムの ID を引数として受け取り、「default/index」テンプレートを使って出力します。
\r
2500 <pre class="example"><code>function doSkinVar($skinType,$item1 = 0,$item2 = 0,$item3 = 0,$item4 = 0) {
\r
2503 $template = 'default/index';
\r
2504 $item_array = array($item1,$item2,$item3,$item4);
\r
2505 $blog->readLogFromList($item_array, $template);
\r
2512 <h1>この他にも…… <a name="additional-reading" href="#top" class="toplink"><img src="../icon-up.gif" width="15" height="15" alt="back to top" /></a></h1>
\r
2514 <h2>役立つドキュメントがたくさん!</h2>
\r
2516 <p>このドキュメント以外にもあなたがプラグインを開発するにあたって、リンク先のページもきっと役立つことと思います。</p>
\r
2518 <li><a href="http://wiki.nucleuscms.org/plugindev:index" title="Development Wiki">Development Wiki(公式サイト(英語))</a></li>
\r
2519 <li><a href="http://japan.nucleuscms.org/wiki/plugindev" title="Development Wiki">Nucleusプラグインの技術情報(日本公式サイト)</a></li>
\r
2520 <li><a href="sqltables.html" title="Database Tables">Nucleus - SQL テーブル構造</a></li>
\r
2521 <!-- <li><a href="" title=""></a></li> -->
\r
2525 <pre class="example"><code></code></pre>
\r
2526 <pre class="example"><code></code></pre>
\r
2527 <pre class="example"><code></code></pre>
\r
2528 <pre class="example"><code></code></pre>
\r