#==========================================================================#
# ■ B.Forum Ver.1.01                                                      #
# ■ プラグインSDK(README)                                                 #
# □ Hiroaki,Sakuma ( sakuma@beetas.org )                                  #
#                                                                          #
# このアプリケーションはオープンソースウェアです.                          #
# 無料で使用することができます.                                            #
# なお, 詳細な使用条件/最新情報については下記サイトをご覧下さい.           #
# http://www.beetas.org/                                                   #
#                                                                          #
# ------------------------------------------------------------------------ #
# Copyright 2001-2002 Hiroaki,Sakuma All Rights Reserved.                  #
# Copyright 2001-2002 BEETAS.org All Rights Reserved.                      #
#                                                                          #
#==========================================================================#



======================================
■プラグインSDK
======================================

B.Forumはプラグイン機能を使用する事で，機能拡張を行っています．
このパッケージはB.Forumのプラグインを開発するDeveloper向けのテンプレートとな
るファイルが入っています．なおこのプラグインをそのまま使用すると，B.Forum
Ver1.01B-4と同程度の動作をします．これをベースとして独自の拡張を加えたり，挙
動を変更してオリジナルのプラグインを作成してください．


======================================
■プラグインによる機能拡張(オプション)
======================================

.bforumrcのPLUGIN_DIR項目で指定したディレクトリにプラグインファイルを設置す
る事で，機能拡張が可能です．フォーマットは,

 * ファイル名で呼び出しタイミングが変わる．ファイル名の拡張子は'.pl'．
  main.pl,create.pl,index.pl,thread.pl,tree.pl,list.pl,search.pl,form.pl,
  regist.pl,sendmail.pl,code.pl等(内容は同名の サブルーチン参照の事)
 * 独自のファイル名を使用する事で，新しい関数を定義可能．呼び出しはURLに
  'plugin=***'パラメータを含める事で呼び出す．
 * 文法はPerlに準拠．
 * パッケージ名はファイル名と同名．
   main,create,index...等．
 * 次のサブルーチンを定義すること．
   [version]
    プラグイン固有の名称とバージョン等．
   [require_min]
    最低必要なバージョンをリビジョンで指定する．無い場合は未定義値．"0047"以
    前はプラグイン機能自体が無いため，指定しても無効．
   [require_max]
    特定のバージョン以降での動作を制限する．リビジョンで指定する．無い場合は
    未定義値．
   [status]
    プラグインを使用する場合，'1'を返す．無い場合は未定義値．
   [main]
    処理を行う．標準出力は使用せず，return構文で返す．未定義値を返すと標準の
    ルーチンが実行される．
 * print構文は使用禁止．出力はreturn構文で返す．
 * 引数として，$head(HTMLヘッダ)，$foot(HTMLフッタ)，\%QUERY_STRING(ハッシュ
   のリファレンス)，ルーチン呼び出しの引数を渡すので，使用可能．
 * 文法ミスがある場合，処理は無効.(通常の処理で代用)



======================================
■著作権
======================================

B.Forumと配布ファイル，その他リソースについては

   佐久間 浩彰(Hiroaki,Sakuma)
   BEETAS.org

に著作権があります．

 * B.Forum
   Copyright 2001-2002 Hiroaki,Sakuma All Rights Reserved.
   Copyright 2001-2002 BEETAS.org All Rights Reserved.



======================================
■ライセンス
======================================

BPL(BEETAS.org Public License)の元での使用を認めます．
現時点，及び以降のBPLのいずれかを適用できます．最新のBPLは下記サイトをご覧下
さい．
>> http:/www.beetas.org/



□BEETAS.org Public License

 * 商用利用は可能です．
 * 著作権はBEETAS.orgにあります．
 * 自由に改造を行ってかまいません．改造を行った際は利用者にわかるように明記
   してください．
 * 自由に再配布を行ってかまいません．構成を変更したり，変更を加えた場合は利
   用者(設置者/ユーザ)がわかるように明記してください．またオリジナル
   (BEETAS.org)の配布元(http://www.beetas.org/等)も明記してください．
 * 自由に販売を行ってかまいません．またサポートを販売してもかまいません．し
   かし必ずオリジナル(BEETAS.org)の配布元(http://www.beetas.org/等)も明記し
   てください．
 * プログラムを使用して何らかの損害を被った時もBEETAS.orgはその責を一切負わ
   ないものとします．
 * 動作保証は一切ありません．サポート掲示板は利用可能ですが，全て解決できる
   保証はありません.


