• ブログ単位に、アイテム拡張用テーブルが作成され、そこにフィールドを追加します。
• フィールドは、Textタイプ、Imageタイプ、Selectタイプなどが（現時点で7種類、下表参照）あります。
• Selectタイプは、更に拡張したテーブルとリレーションするためのフィールドタイプです。
• テンプレートで、表示したいフィールドを指定します。
  拡張したフィールド、imgを表示する場合、
  
  <%znItemFieldEX(img)%>
  リレーションを使用する場合、フィールド名を"->"でつないで指定します。
  <%znItemFieldEX(products->material->desc)%>
  『アイテム拡張用テーブルのproductsフィールドに（管理ページで）設定してある商品テーブルの、materialフィールドに（管理ページで）設定してある材質テーブルの、descフィールド』といった感じになります。
  設計上、つなげる数に規制はありませんが、そんなにつなげる用途もないですね。。。
  もちろん、ひとつのテーブル内に、複数のSelectタイプを持つことも可能です。

追加できるフィールドのタイプは、以下の通りです。
（表1.）

タイプ	用途
Text	一行のテキスト（最大255バイト）
Number	数値（-2147483648～2147483647）
Textarea	複数行のテキスト 改行に、<br />を挿入するかどうかの設定は、「ブログの設定」にならいます。（管理ページで編集する場合、デフォルトブログの設定にならいます。） アイテム表示前イベントで記事整形する他プラグイン（スマイリーなど）が動作します。（対応していないプラグインもあるかと思います。）
Image	画像（mediaディレクトリ内のファイルを選択して入力します）
DateTime	日付・時間
Checkbox	複数選択可能な選択肢（決まった文字列を入力するTextタイプ）
Select	「拡張した別テーブルの内容」を選択（リレーション機能） 詳細は、「拡張テーブル・拡張フィールドついて」を参照ください。

1. プラグイン管理ページにて、拡張フィールドを設定
   詳細は、「拡張テーブル・拡張フィールドついて」を参照ください。
   
   
2. プラグイン管理ページにて、拡張テーブルを設定（リレーション機能を使う場合のみ）
   詳細は、「拡張テーブル・拡張フィールドについて」を参照ください。
   
   
3. テンプレート編集
   詳細は、「テンプレートへの記述について」を参照ください。
   
   
4. アイテム投稿（追加・編集）にて、各アイテムごとにデータを入力
   
   • znItemFieldEXデータの追加・編集・削除
     znItemFieldEXデータを追加したくないアイテムがある場合、「znItemFieldEXデータを追加しない」にチェックを入れてください。
     すでにznItemFieldEXデータを入力したアイテムから、znItemFieldEXデータを削除する場合、「znItemFieldEXデータを削除」にチェックを入れてください。（既存データの編集・削除のみ、管理ページのレコード編集から行うこともできます。）
   • Imageタイプフィールドの入力は、Flash UIを使用します。「Flash Player 8以上」、「JavaScript」が使用できるブラウザが必要です。
     mediaディレクトリの設定したディレクトリ内の画像がサムネイル表示されます。（サイズは自動調整） 「クリックで選択」、「ドラッグで全体の移動」、「ダブルクリック（押しっぱなし）＆上下ドラッグで拡大縮小（分かり難いっすね）」です。
     「アップロード」、「コレクション（ディレクトリ）変更」も、Flash内で可能です。
   • Imageタイプフィールドで使用できる画像フォーマットは、jpg、gif、pngです。

プラグインオプション

オプション	解説
ハイライトテンプレート	検索にヒットした際に使用するテンプレート
管理ページのレコード一覧で１ページに表示するレコード数	デフォルトは30件です。
管理ページへのリンクを、クイックメニューに表示しますか？	Nucleus Admin のサイドバーのクイックメニューに、管理ページへのリンクを表示するかどうかの設定です。
アンインストール時、データを破棄しますか？	プラグインをアンインストールした際に、フィールドデータ、アイテムデータを破棄するかどうかの設定です。
最新バージョンの確認をしますか？	「はい」に設定すると、ただちに最新バージョンが公開されていないかどうかを確認し、表示します。 結果は、オプションの保存ボタンの下に表示されます。（そして設定は「いいえ」に戻ります。）

ブログオプション(各ブログの設定)

オプション	解説
検索対象となるフィールド	ここで指定したフィールドが検索対象となります。 フィールド名だけを書きます。複数設定する場合は、改行して入力してください。 例えばこんな感じ weather selecttest->test

1. ブログごとに「アイテム拡張用テーブル」が存在します。
   アイテムの拡張フィールドは、ブログ単位の「アイテム拡張用テーブル」に保存されます。
   「アイテム拡張用テーブル」は、znItemFieldEXをインストールした時に自動的に作成され、ブログを削除した時に自動的に削除されます。
   また、プラグインオプションが、「アンインストール時データを破棄する設定」になっている場合、znItemFieldEXをアンインストールした時に、削除されます。
   
   
2. Selectタイプフィールド（リレーション）を使用しない場合、新たに拡張テーブルを作成する必要はありません。
   アイテム拡張用以外の拡張テーブルは、Selectタイプフィールドに結合させるために使用します。（アイテム拡張用テーブルは、Nucleusのアイテムに結合しているイメージです。）
   
   
3. リレーション用テーブルとして使用するためには、Textタイプフィールドが必要です。
   実際には、リレーション用テーブルの「id」フィールドを結合に使用するのですが、入力する際に、idではその内容を把握し難いため、ラベル代わりにTextフィールドを使用します。
   具体例）
   
   ┌─┬────────┐
   │id│products(Select)│アイテム拡張用テーブル（以下Ａ）
   ├─┼────────┤
   　　　│　　│
   　┌─┘　　│productsフィールドの設定で指定
   　↓結合　　↓
   ┌─┬──────┬─────┬───────┐
   │id│pname(Text) │pic(Image)│price(Number) │リレーション用テーブル（以下Ｂ）
   ├─┼──────┼─────┼───────┤
   
   
   Ａのproductsフィールド（Selectタイプ）の設定で、Ｂのpnameフィールド（Textタイプ）を登録しています。
   Ａのproductsフィールドのレコードには、Ｂのidフィールドが保存されます。（実際にはidに結合している。）
   Ａにデータを入力する際に、id（数値）が表示されても、Ｂのどのレコードに対応しているのか把握し難いため、Ｂのpneme（Textタイプ）を表示するようにしています。そのために、リレーション用テーブルにはTextタイプフィールドが必要になります。
   
   

1. フィールドには、複数のタイプがあります。
   フィールドを追加したら、（編集）から、フィールドの設定を行ってください。設定内容は以下の通りです。
   （表2.）
   

   タイプ	用途	設定内容
   Text	一行のテキスト（最大255バイト）	追加・変更フォームで表示される時の横幅
   Number	数値（-2147483648～2147483647）	追加・変更フォームで表示される時の横幅
   Textarea	複数行のテキスト	追加・変更フォームで表示される時の横幅と行数
   Image	画像（255バイトまでの、mediaディレクトリからの相対パスを保持）	デフォルトのmediaディレクトリ（Flash版UIの場合、投稿ページで、ディレクトリを変更できます。） 投稿ページでの、インターフェースモード（Image mode、List mode）を設定しておきます。画像枚数が多い場合、ジャンル別にディレクトリを分けるか、List modeをお使いください。
   DateTime	日付・時間	2005-12-25形式、2005-12-25 23:59:59形式の何れか
   Checkbox	複数選択可能な選択肢（決まった文字列を入力するTextタイプ）	選択肢を、改行で区切って設定（現バージョンでは、すでにアイテムに入力している文字列を変更・削除しても、アイテムデータは補正されません。）
   Select	別テーブルのTextタイプフィールドを選択	Textタイプフィールドを持つテーブルが対象となります。（idでは意味が判別し難いので、Textタイプフィールドをラベル代わりに使用するためです。実際には指定したテーブルの「id」フィールドに結合します。）

   
   
2. 各テーブルには、必ず「id」フィールドが存在します。
   「id」フィールドは、他のデータに結合するために使用しています。（「アイテム拡張用テーブル」の場合、Nucleusのアイテムと結合するために使用）この「id」フィールドは、編集・削除することができません。また、「id」というフィールドを、あらたに追加することもできません。
3. 別テーブルから結合先に設定されているTextタイプフィールドには、フィールド一覧のタイプ項目に、下記鎖マークが付き、結合元フィールド編集ページへのリンクが表示されます。
   
4. フィールド一覧で、Selectタイプフィールドの設定項目には、結合先フィールド編集ページへのリンクが表示されます。
   
5. フィールド一覧の、フィールド記述項目には、テンプレートやスキンで指定する際の（->で繋がった）フィールド名が自動生成されます。「アイテム拡張用テーブル」と繋がっていない場合、頭に「リンク切れアイコン」が付きます。
   

1. リレーションを設定しているフィールド（Selectタイプ）には、が付きます。
   
   • 一覧のタイトル部分のをクリックすると、リレーション先のフィールドの編集画面に飛びます。
   • 設定していたリレーション先が、変更・削除されてしまった場合、が表示されます。
   • レコードには、リレーション先のTextタイプフィールドのデータが表示されます。
   • リレーション先にデータがないレコードには、のみが表示されます。
   
   
2. プラグイン管理ページでは、アイテム拡張用テーブルへのレコード追加はできません。
   既存レコードの編集・削除は可能ですが、アイテム拡張用テーブルへのレコード追加は、アイテム投稿から行います。

「アイテムの本体」に、

<%znItemFieldEX(フィールド名)%>

と、記述します。
フィールド名は、プラグイン管理ページで、「アイテム拡張用テーブル」に設定したものです。（半角英数字及び_）
各フィールドタイプには、以下のような特徴があります。

フィールドタイプ	解説
Checkbox	<li></li>のみを出力しますので、お好みで、<ul>や、<ol>を付け加えてください。 表示設定（後述）により、いくつかの表示方法を指定することができます。
Image	<img>タグに、class属性が自動的に振られます。 値は、"zmifex_フィールド名"です。スタイルシートでカスタマイズしてください。 リレーションを指定した場合、"->"部分が"__"に置き換わります。 例） products->material->mname ↑ "zmifex_products__material__mname" というclassが付きます。
Select	リレーションするフィールド名は、"->"でつなぎます。詳細は、下記の「リレーションの指定方法」を参照ください。
Textarea	アイテム整形系（PreItemイベントで本文に作用する）のプラグインの効果が得られます。 入力の際、そのブログの「改行を変換する」の設定により、<br />が付加されます。 表示設定（後述）により、いくつかの表示方法を指定することができます。
その他	データがそのまま表示されます。

表示設定、テンプレート名を指定することで、更に細かく設定することができます。
テンプレート、スキンで書く場合、こんな感じです。

パラメータ	解説
フィールド名	プラグイン管理ページで、「アイテム拡張用テーブル」に設定したものです。（半角英数字及び_）以前からあったパラメータです。
表示設定	Numberタイプ、Imageタイプでのみ有効なパラメータです。 Numberタイプ 小数点以下の桁数|小数点に使用する文字のASCIIコード|3桁区切に使用する文字のASCIIコード 例） 2|46|44 小数点以下2桁で、小数点には"."、3桁区切には","となり、12,345.67と表示されます。（分かり難いですねぇ。すみません。） 実は、Numberタイプフィールドは、整数にしか対応していませんので、今のところ、小数点以下の設定は意味がありません。（今後、少数値を扱う時のために実装しました。） 最後のZERODISPは、値が0だった時の表示方法を設定します。 ZERODISPと書くと値が0であっても表示します。それ以外、もしくは書かなかった場合、値が0の時は表示をしなくなります。（アイテムに拡張フィールドを追加していない場合も非表示となります。） Imageタイプ サイズ属性=値 サイズ属性は、width or heightで、それぞれw or hと指定します。 例） w=100 元画像の縦横比率を保持します。 Textareaタイプ 以下の3つの定数の内、何れかを指定します。 removeBreaks：行末の<br />を削除します。 htmlspecialchars：htmlタグなどの特殊文字を、HTML エンティティに変換します。 removeBreaks_htmlspecialchars：上記2つの効果が得られます。 Checkboxタイプ 以下の2つの機能があります。 区切り文字指定 Checkboxタイプは、標準では以下のように<li></li>表示されますが、 <li>値1</li><li>値2</li><li>値3</li> $（半角ドル）,（半角カンマ）以外の文字を指定すると、（例えば「、」を指定すると） 値1、値2、値3 というように、区切り文字で表示するようになります。（半角カンマ使えないのはちょっとねぇ。。。） 条件指定により、文字列置換え $真の時の文字列$否の時の文字列$条件[||条件] という書式になっています。（これじゃ、全然意味わかんないっすよね。） <%znItemFieldEX(mytemplate , $●$×$リンゴ||ミカン)%> のように書きます。上記例の場合、Checkboxの値が、「リンゴかミカンの場合、●」を、「そうでない場合、×」を出力します。 条件は、||で区切ることで複数指定可能です。現時点では、orしか使えません。andには未対応です。 Nucleusリファレンスブログの、スキン変数早見表でこの方法を使用しています。
テンプレート名	拡張フィールドを表示する際に、テンプレートを指定できるようになりました。 値を入力していない場合、テンプレートごと表示しなくなります。 テンプレートのアイテムの本体に、以下のように書きます。テンプレートは、専用で作成すると良いと思います。 <a href="<%imgurl%>"><%fieldex%></a><br /> <%fieldex%>部分に、拡張フィールドが表示されます。 <%imgurl%>は、Imageタイプでのみ有効なテンプレート変数で、画像のurlを返します。 上記例では、クリックすると、別窓で画像を表示します。 下記例では、特別価格フィールドに価格が設定されている場合のみ、「特別価格***円」と表示します。 特別価格<%fieldex%>円<br /> Nucleus標準のテンプレート変数を使用する場合、下記「テンプレート内で標準変数をパースするか」を1に設定する必要があります。
テンプレート内で標準変数をパースするか	拡張フィールドを表示する際に、テンプレートを指定した場合、その中でNucleus標準テンプレート変数を使用するかどうかの設定です。 空白：使用しない、true：使用する

テンプレート、スキンでの記述例です。 imgtest（Image）フィールドを、横幅100pxで、fieldtestテンプレート（のアイテム本体パーツ）を使用して表示 リレーション先のnum（Number）フィールドを、3桁区切りに","を使用して表示

『Selectタイプフィールドに設定（※1）した、結合先テーブル』の、『任意のフィールド（※2）のデータ』を表示することができます。
※1 ･･･ 管理ページで設定します。
※2 ･･･ テンプレートで設定します。
ver0.05alphaから、下記のリレーションフィールドの記述は、フィールド一覧のフィールド記述欄に、自動生成されるようになりました。

例１）

また、複数の"->"で、1つ以上のテーブルとリレーションさせることも可能です。
例２）

もう一度整理すると、

<%znItemFieldEX(products->pic)%>

↑　『アイテム拡張用テーブルのproductsフィールドに（管理ページで）設定してある商品テーブルの、picフィールド』となり、

<%znItemFieldEX(products->material->desc)%>

↑　『アイテム拡張用テーブルのproductsフィールドに（管理ページで）設定してある商品テーブルの、materialフィールドに（管理ページで）設定してある材質テーブルの、descフィールド』となります。

【リレーションSQLの生成】
テンプレートに記述したリレーション構造（aaa->bbb->ccc）で、動的にSQLを生成しているのですが、アイテムが表示されるたびに動的生成していたのでは、無駄なオーバーヘッドが発生してしまいます。そこで、一度生成したSQLは、キャッシュして使いまわしています。キャッシュは、フィールド編集をした時にクリアされます。

ブログオプションで指定したフィールドが検索対象となります。（ただし、Imageタイプフィールドと、Selectタイプフィールド※は検索対象となりません。）
※･･･もちろん、リレーション先も検索対象となります。ここで言うSelectタイプフィールドとは、「表示するフィールドタイプがSelectタイプフィールドの場合」です。

NP_znItemFieldEXで拡張したフィールドを、検索の対象にするためには、Andy氏作成のNP_ExtensibleSearchが必要です。
Nucleus(JP)フォーラム - 検索機能をプラグインで拡張可能に
素晴らしいプラグインをありがとうございます。

<%znItemFieldEX(モード,拡張フィールド)%>

パラメータ	解説
モード	アイテムスキンで使用する場合、item
拡張フィールド	テンプレートでの指定方法と同じです。リレーションを使用することもできます。

具体的には、以下のようになります。

<%znItemFieldEX(item,products->material->supplier)%>

アイテムスキン以外で使用した場合、非表示となります。

基本的に、サイドバーのような場所で使うことを想定した、<%blog%>系のアイテム群を表示します。この時、表示する順番と、摘出条件を、スキン変数のパラメータで、設定できます。
普通は、「Nucleus標準のアイテム項目の日付」で決まる順番や、"ドラフトと未来の日付以外"等々によって決まる摘出条件を、自由に設定できるようにすることで、拡張したフィールドに、意味を持たせることができるようになります。

以下のような使い方が可能です。

• 「Selectタイプで"オススメ"にしたアイテム」を摘出条件として、「Dateタイプの発売日」を基準にソートした10件
• ルービックキューブの計測時間を、Numberタイプに記録して、「最速記録10件」
• 商品->材質->単価が、1000円以上とか、複雑な摘出条件も、設定可能
• イベントスタート日が「本日」以降＆イベント終了日が「本日」以前と条件設定することで、開催中イベントの一覧を表示する。（日付が変わると自動的に消えます。）

INDEX表示するテンプレートを、専用で作っておけば、メインの記事とは違ったレイアウトで表示できます。 そこから、<%itemlink%>を、クリックすれば、個別アイテムページに飛ぶようにしておくと便利です。

<%znItemFieldEX(モード,ソートキー,昇降順,摘出条件,テンプレート,表示数,別ブログid,allCategory)%>

具体的には、以下のようになります。

<%znItemFieldEX(index,products->material->mname,ASC,products->material->mname|%|あいう,default/index,30,1)%>

パラメータ	解説
モード	アイテム群表示の場合、index
ソートキー	並順の基準となるフィールドです。
昇降順	昇順がASC、降順がDESC、となります
摘出条件	フィールドと、比較演算子と、値を、|で区切って指定します。 演算子は、>、>=、=、!=、<=、<、%、が使用可能です。%は、LIKE '%値%'となります。 複数の条件を指定することも可能です。 ANDの場合、 && ORの場合、 || で条件を繋ぎます。 例）「startフィールドが2006-11-15以前で、なおかつ、endフィールドが2006-11-15以後」という条件 <%znItemFieldEX(index,test,ASC,start|<=|2006-11-15&&end|>=|2006-11-15,default/index,30)%> 条件の値に、動的に変化する「本日」を指定することも可能です。 例）「startフィールドが本日以前で、なおかつ、endフィールドが本日以後」という条件 <%znItemFieldEX(index,test,ASC,start|<=|[date]5&&end|>=|[date],default/index,30)%> [date]の部分が、ブログを閲覧した日になりますので、手修正をせずに自動的に「開催中のイベント一覧」などを表示することができます。
テンプレート	使用するテンプレートです。専用でテンプレートを作成することで、レイアウトを自由にカスタマイズすることが可能です。
表示数	最大表示数です。
別ブログid	別ブログのアイテム一覧を表示する場合、対象ブログidを指定します。別ブログでない場合は省略できます。
allCategory	1と指定すると、カテゴリの絞込みの影響を受けなくします。

別プラグインなどから、NP_znItemFieldEXで拡張したフィールドを利用するためのAPIです。以下のように、アイテムidとフィールド名を渡すと、そのフィールドの値（表示文字列）を返します。

if ($manager->pluginInstalled('NP_znItemFieldEX') and 
    $plugin = &$manager->getPlugin('NP_znItemFieldEX')) {
    echo $plugin->getItemFieldEX($itemid,"products->material->supplier");
}

• 管理ページ関連
  • Imageタイプのインターフェースに、media.phpなどを
• テンプレート関連
  • 数値タイプフィールドの前後のデータとの比較
• ブログ閲覧関連
  • アイテム群表示にページスイッチ
  • テンプレート等のフィールド名が不正だと、PHPがエラーを吐くのを何とかする
  • ブログ上での、検索機能（Numberタイプで、指定値以下・以上。DateTimeタイプで、指定日以前・以降のような条件指定）
  • グラフ出力