━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ パンヤ絵文字プラグイン Ver.1.10 (2009/09/28)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━──────
このプラグインは、Web Board Professionalで「（まじ）」や「（それ）」
といった文字列をスカッとゴルフ パンヤの絵文字に置換するプラグインです。
ご利用は、各自の自己責任において行ってください。
────────────────────────────────────
■ 対象プログラム
Web Board Professional Ver 3.25 (2009/04/05)
もしくは、Skin.pmが上記と同じバージョン。
このプラグインの動作を実現するために、上記プログラムのSkin.pmを
改造して添付しています。
必要なら、事前にバージョンを合わせておいてください。
なお、上記対象プログラムについて、以下の文章では「Web Board Professional」
と表記します。
Web Board Professionalは、次の場所で配布されています。
Web Board Professional - Web Liberty
http://www.web-liberty.net/download/boardpro/index.html
────────────────────────────────────
■ 絵文字の準備
この配布ファイルは、パンヤの絵文字を含んでいません。
表示する絵文字は、別途、準備しておいてください。
なお、このプラグインの配布ファイルの設定では、絵文字に置換する
文字列と絵文字のファイル名の対応をMSNメッセンジャーキットに
合わせています。
MSNメッセンジャーキットは、パンヤの公式サイトの「パンヤを広めよう！
-> ファンサイトキット」で配布されています。
スカッとゴルフ パンヤ - 無料で楽しめるオンラインゴルフゲーム！
http://www.pangya.jp/
────────────────────────────────────
■ ファイル／ディレクトリ（フォルダ）構成
設置を容易にするため、Web Board Professionalの配布ファイルに
倣ったファイル／ディレクトリ構成としています。
│
├─ PangYaFace.txt ＜このファイル＞
│
└─ lib ＜ディレクトリ＞
│
└─ webliberty ＜ディレクトリ＞
│
├─ Skin.pm ＜改造ファイル＞
│
└─ Plugin ＜ディレクトリ＞
│
├─ PangYaFace.pm ＜プラグイン＞
│
└─ PangYaFace ＜ディレクトリ＞
│
├─ init.cgi ＜プラグイン設定ファイル＞
│
├─ css ＜ディレクトリ＞
│ │
│ └─ PangYaFace.css ＜スタイルシート＞
│
├─ image ＜絵文字用画像のディレクトリ＞
│ │
│ └─ 絵文字について.txt
│
└─ js ＜ディレクトリ＞
│
└─ PangYaFace.js ＜JavaScript＞
────────────────────────────────────
■ アップロード
上記のファイルとディレクトリをそのまま「boardpro/」へ上書き
してください。
また、パンヤの絵文字用画像ファイルを「絵文字用画像のディレクトリ」
へアップロードしてください。
※ アップロード時はファイルの文字コードを変換しないようご注意ください。
※ 「絵文字について.txt」は、配布ファイルの解凍時に空のディレクトリ
を展開できないソフトを想定して入れています。
このファイルと「絵文字について.txt」は、このプラグインの動作には
必要ありませんので、不要ならサーバーから削除しても問題ありません。
────────────────────────────────────
■ 使用方法
このプラグインは、スキンファイルを編集しなくても、パンヤの絵文字の
置換を行います。
また、スキンファイルを編集することで、絵文字パレットを表示し、
JavaScriptが有効なら、絵文字をクリックして入力できるようになります。
絵文字パレットを表示するには、「boardpro/skin/list.html」の
フォーム部分に次の２行を追加します。
絵文字
${PangYaFace}
この２行の追加場所は、メッセージ入力欄の次の行に挿入すると良いでしょう。
たとえば、次のようにします。
メッセージ
絵文字
${PangYaFace}
なお、「board.cgi?plugin=PangYaFace」を表示すると、使用可能な絵文字
の確認ページを表示できます。
このページは、プラグインの設定により、絵文字パレットに表示用リンク
を追加することが可能です。
追加されたリンクを参考に、必要なら、モバイル用のスキンファイルに
リンクを追加するのも良いと思います。
────────────────────────────────────
■ プラグインの設定
初期状態では、そのままアップロードすると良いように設定済みです。
ですが、次のようなケースがあるかもしれません。
Ａ． お使いのサーバーが通常のページとCGI専用でサーバーを使い分けている。
Ｂ． 著作表示のタグや場所を変更したい。
Ｃ． 絵文字パレットや絵文字一覧を編集したい。
Ｄ． 絵文字に置換する文字列と絵文字のファイル名の対応を変更したい。
そのような場合は、「プラグイン設定ファイル」を編集することで設定
を変更できます。
設定の変更が可能なのは、次の13項目です。
１． 絵文字を置いたディレクトリ
$init->{image_path} = './lib/webliberty/Plugin/PangYaFace/image/';
２． PangYaFace.cssのあるディレクトリ
$init->{css_path} = './lib/webliberty/Plugin/PangYaFace/css/';
３． PangYaFace.jsのあるディレクトリ
$init->{js_path} = './lib/webliberty/Plugin/PangYaFace/js/';
４．プラグインによるページフッターの書き換え
$init->{footer} = 1;
５．ページ内絵文字パレットの表示列数（最低は3）
$init->{image_cols} = 9;
６．ページ内絵文字パレットの最大表示行数（0は全て表示）
$init->{image_rows} = 0;
７．ページ内絵文字パレットに反転絵文字「（＠まじ）」とかを表示
$init->{image_reverse} = 0;
８．ページ内絵文字パレットに絵文字一覧のウィンドウを開くリンクの設置
$init->{palette_open} = 0;
９．絵文字一覧のウィンドウサイズ（横幅）（最低は150）
$init->{palette_size_x} = 570;
10．絵文字一覧のウィンドウサイズ（高さ）（最低は150）
$init->{palette_size_y} = 400;
11．絵文字一覧のウィンドウの絵文字表示列数（最低は1 携帯では常に1）
$init->{palette_cols} = 4;
12．絵文字一覧のウィンドウの絵文字１つの枠幅（最低は100）
$init->{palette_width} = 130;
13． 文字と絵文字の対応設定
$init->{face_list} = [
['まじ','011.gif'],
['あせ','012.gif'],
・
・
・
['でんち','009.gif'],
['めだる','010.gif']
];
１． 絵文字を置いたディレクトリ
２． PangYaFace.cssのあるディレクトリ
３． PangYaFace.jsのあるディレクトリ
１．〜３．は、http://から始まるURLを指定することも可能です。
※ 直リンクなど、CGIを設置したサーバーとは別のサーバー提供者が提供
するサーバーを無許可で指定することが無いように注意！
無料で提供されているサーバーであっても、その運用にはコストが
かかっています。
４．プラグインによるページフッターの書き換え
４．については、ページのフッター部分にリンクがあるとき、1を指定する
ことで、このプラグインが必要な著作表示を挿入します。
この機能を無効にする場合は、0（1以外）を指定してください。
５．ページ内絵文字パレットの表示列数（最低は3）
６．ページ内絵文字パレットの最大表示行数（0は全て表示）
７．ページ内絵文字パレットに反転絵文字「（＠まじ）」とかを表示
８．ページ内絵文字パレットに絵文字一覧のウィンドウを開くリンクの設置
５．と６．は、絵文字パレットの横と縦の絵文字数を指定します。
なお、６．で指定した行数に収まらなかった絵文字は、絵文字パレット
に表示されません。
７．は、＠で始まる絵文字が存在するとき、1を指定することで、
絵文字パレットに＠で始まる絵文字を表示するようになります。
８．は、1を指定することで、絵文字パレット下部に絵文字一覧ウィンドウ
を開くリンクを追加します。
９．絵文字一覧のウィンドウサイズ（横幅）（最低は150）
10．絵文字一覧のウィンドウサイズ（高さ）（最低は150）
11．絵文字一覧のウィンドウの絵文字表示列数（最低は1 携帯では常に1）
12．絵文字一覧のウィンドウの絵文字１つの枠幅（最低は100）
９．と10．は、絵文字一覧のウィンドウサイズをドットで指定します。
ウィンドウはリサイズ可能な状態で開きます。
11．は、絵文字一覧のウィンドウに表示する、横の絵文字数です。
12．は、絵文字一覧ウィンドウの絵文字1文字あたりに割り当てる横幅を
ドットで指定します。
13． 文字と絵文字の対応設定
13．については、「['絵文字に置換する文字列','絵文字のファイル名'],」
を追加することで、対応する絵文字を増やすことが可能です。
また、設定を減らすことで、対応する絵文字を減らすこともできます。
なお、「（」と「）」は置換処理時に追加しているので、設定時は「（」と
「）」をのけて記述してください。
設定変更時は、一番最後の設定箇所については、行末に「,」をつけない
ようにしてください。
['きゅーま','008.gif'],
['でんち','009.gif'],
['めだる','010.gif'] <--- 最後の設定箇所は、行末に「,」をつけない。
]; <--- 設定はここより上の行に記述し、この部分はそのままにしてください。
一番最後の設定箇所のさらに後ろに設定を追加する場合は、それまでの
一番最後の設定箇所の行末に「,」を追加してください。
['でんち','009.gif'],
['めだる','010.gif'], <--- 行末に「,」を追加する。
['ぽんた','ponta.gif'] <--- 新たな最後の設定箇所は、行末に「,」をつけない。
]; <--- 設定はここより上の行に記述し、この部分はそのままにしてください。
絵文字に置換したい文字列があるけど今は絵文字のファイルを用意
できていないというような場合、「['三角帽子',''],」のように
「'絵文字のファイル名'」を「''」とすることで、該当文字列の置換処理を
スキップするようにしています。
────────────────────────────────────
■ 著作表示について
このプラグインでは、ページのフッター部分にリンクがあれば、
その部分に必要な著作権表示とリンクを追加するようにしています。
もしも、スキンを変えていてフッター部分にリンクがない場合は、
以下を参考にスキンを修正してください。
パンヤの素材を使用するページには、著作権表示が必要です。
スキンを変更している場合などで著作権表示が自動挿入されていない
ときは、次の著作権表示をご使用のスキンに記入してください。
©2004 Ntreev Soft Co.,Ltd. All Rights Reserved. Exclusive License ©2004 HanbitSoft, Inc., All rights reserved. ©2004 Gamepot Inc., All rights reserved.
また、このプラグインは改造したSkin.pmとセットで配布しているので、
それを示す表示が必要です。
これもスキンを変更している場合などで自動挿入されていないときは、
次のリンクをスキンに記入してください。
Skin.pm Edited & パンヤ絵文字プラグイン by CJ？ごろう
なお、プラグインがフッター部分にリンクを追加するため、上記の
リンクをスキンに追加した場合、「スキンに記入したリンク」と
「プラグインによって追加されたリンク」の２つが表示されるケースが
あります。
そのような場合は、「■ プラグインの設定」を参考に「init.cgi」を
編集してください。
────────────────────────────────────
2009/09/26 Ver.1.00公開
2009/09/28 Ver.1.10公開
次の設定項目の追加とそれに伴う修正をしています。
ページ内絵文字パレットの表示列数（最低は3）
ページ内絵文字パレットの最大表示行数（0は全て表示）
ページ内絵文字パレットに反転絵文字「（＠まじ）」とかを表示
ページ内絵文字パレットに絵文字一覧のウィンドウを開くリンクの設置
絵文字一覧のウィンドウサイズ（横幅）（最低は150）
絵文字一覧のウィンドウサイズ（高さ）（最低は150）
絵文字一覧のウィンドウの絵文字表示列数（最低は1 携帯では常に1）
絵文字一覧のウィンドウの絵文字１つの枠幅（最低は100）
……このファイルの編集が一番時間かかってるかも？w
by CJ？ごろう
http://www7a.biglobe.ne.jp/~goroh/