pup.cgi設置説明書

Pup.cgi 設置説明書

◆概　要

pup.cgiは、作者のQzさんが、画像をアップロードできる掲示板として作成され、その後にYY-BOARDに
アイコン登録機能を付加するスクリプトとして利用＆再配布を許可されているスクリプトです。
初版（Ver1.0）から再三改良されて設定項目も大幅に増えたので、設置説明書を準備することにしました。
このドキュメントは、yy-niftyに同梱されているpup.cgiの詳しい設定方法を説明する為に作成されてます。
尚、pup.cgiの最新バージョンは、yy-niftyの配布アーカイブセットに同梱されてます。

※pup.cgiスクリプトは、Qzさんの著作物です。

バージョン情報　：pup.cgi Ver1.72　　
　　最終更新日　：2000/10/14（Sat）

◆主な特徴

Ｗｅｂ上でパソコンから直接画像ファイルをアップロードできます。
ＧＩＦ、ＪＰＧ、ＰＮＧの３タイプの画像ファイルを扱えます。
登録する画像の縦横サイズ（ピクセル単位）、ファイルサイズ（ＫＢ単位）、最大保存数の指定が出来ます。
画像名の他に、投稿者名、Ｅメール、コメント等を入力できるので、簡易な掲示板としての機能もあります。
投稿の権限を無制限、パスワード制限、リモートホスト制限の３通りで運用できます。
投稿内容の一部（投稿者名、Ｅメール、ＵＲＬ、投稿キーなど）はクッキー対応です。
Ｖｅｒ1.60から、管理者用の簡易入力モードも備わりました。

◆設置方法

◆必要最低限の変更箇所（＠niftyでの設置を前提に説明しています）

　　yy-niftyの配布アーカイブセットに含まれている「pup.cgi」をエディタで開いて
　　以下の赤字の部分を変更して上書き保存してください。
　　アドレス指定箇所「http://homepage?.nifty.com/******/～」では、自分の＠niftyの
　　ＵＲＬアドレスを指定してください。

pup.cgi（アイコン管理）の変更箇所

###################################
###　必須項目の設定　　　　　　　　　####
###################################

$JcodeLib = './jcode.pl'; 　　　　　　　　　　　　　　　　　　　　　　　　　　 #--漢字ライブラリ jcode.pl のファイル名
$CharCode = 'sjis'; 　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 #--漢字コード（'sjis' 'euc' 'jis'）
$addminpass = "0123";　　　　　　　　　　　　　　　　　　　　　　　　　　 #--管理者パスワード(必ず変更してください)
$ReturnBBS = "./yy-nifty.cgi"; 　　　　　　　　　　　　　　　　　　　　　 #--戻り先掲示板ＵＲＬ
$icon_url 　 = "http://homepage?.nifty.com/******/yy-nifty/icon"; #--画像保存ＵＲＬ
$IconPath　= "/homepage/yy-nifty/icon";　　　　　　　　　　　　　　　 #--画像保存場所(Pathで指定してください。)
###################################
###　必須項目の設定の終了　　　　　####
###################################

◆アップロード（ファイルの配置）

　　pup.cgiの単体の動作に必要なファイルは、pup.cgi、iconfile.log、jcode.plの3種類だけです。
　　pup.cgiを単体で動かす場合は、以下の様な配置でファイルをアップロードしてパーミッションを変更すればＯＫです。
　　以下の配置例は、yy-niftyと一緒に使用する場合のpup.cgiに必要なファイル配置です。
　　当サイトでは、pup.cgiをyy-nifty又はhoney-mk2と組み合わせて使用することを前提としていますので、
　　アイコン式掲示板と組み合わせて使用する場合の設置方法は、各々の掲示板の解説書を参照して下さい。

　　Root/ ←あなたのルートパス
　　　|
　　　+--cgi-bin/　←http://hpcgi?.nifty.com/UserName　
　　　|       |
　　　|       +--yy-nifty/ [777]（cgi本体を設置する場所）
　　　|           pup.cgi      [755]
　　　|           iconfile.log [666]
　　　|           jcode.pl     [644]
　　　|
　　　+--homepage/　←http://homepage?.nifty.com/UserName　
　　　　　　　　|
　　　　　　　　+--yy-nifty/
　　　　　　　　     | 
　　　　　　　　     |
　　　　　　　　     +--icon/[777]（画像ファイルが保存される場所）
　
　※青いディレクトリは新しく作成するモノです。（名前は任意です）
　※/cgi-bin/yy-nifty/ディレクトリのパーミッションは必ず[777]に設定してください。
　※/homepage/yy-nifty/icon/ディレクトリのパーミッションは必ず[777]に設定してください。

◆動作確認
　　ここまでで一度動作確認をしてみましょう。
　　ブラウザのアドレス欄に次の通りタイプして下さい
　　http://hpcgi?.nifty.com/******/yy-nifty/pup.cgi
　　※？と******の部分は、あなたに割り当てられたアドレスを指定してください。

　　無事に掲示板の画面が表示されたら設置成功です！(^-^)

◆各種設定の変更について

　基本的な設置に成功したら、以下の色々な設定変更に挑戦してみてください。

◆画像保存の動作設定（６８行目以降）
#--保存ＯＫの容量(単位KB, 0:無制限)
$MaxPicSize = 20;

#--保存ＯＫの縦サイズ(0:無制限)
$MaxPicHeight = 120;

#--保存ＯＫの横サイズ(0:無制限)
$MaxPicWidth = 120;

#--保存件数(0:無制限)
$MaxSaveCount = 50;

#--記事削除時の画像ファイル削除(1:削除 0:削除しない)
$PicDeiMode = 1;

設定変数の解説

$MaxPicSize	保存する画像のファイルサイズの制限をＫＢ単位で指定します。あまり大きな値にすると掲示板の動作が重くなりますので、１０～２０程度にして下さい。この値を超えたファイルサイズの画像を登録するとエラーＭＳＧが表示されます。
$MaxPicHeight	保存する画像の縦サイズの制限をピクセル単位で指定します。この値を超えたファイルサイズの画像を登録するとエラーＭＳＧが表示されます。
$MaxPicWidthl	保存する画像の横サイズの制限をピクセル単位で指定します。この値を超えたファイルサイズの画像を登録するとエラーＭＳＧが表示されます。
$MaxSaveCount	保存できる画像の最大件数を指定します。この数を超えて登録しようとするとエラーＭＳＧが表示されます。
$PicDeiMode	ログを削除するときに画像ファイルも一緒に削除する／しない、の指定をします。

◆掲示板の壁紙、背景色、文字色、リンク色等の設定（８７行目）
#--各種色設定
$BackColor = "#ADDEFC"; 　# 背景色を指定
$TextColor = "#000000"; 　　# 文字色を指定
$LinkColor = "#0000FF"; 　　# リンク色を指定（未リンク）
$VLinkColor = "#0000FF"; 　# リンク色を指定（既リンク）
$ALinkColor = "#FF0000"; 　# リンク色を指定（リンク中）

掲示板の背景色及び文字色を指定します。
初期値では、背景及び文字色の指定は以下の通りです。
背景色＝薄青、文字色＝黒、リンク（未訪問）＝青、リンク（未訪済）＝青、リンク（訪問中）＝赤

$IN_TBL_Color = "C0C0C0"; # 入力画面のテーブル背景色
$IN_IMG_Color = "FF8040"; # 入力画面のイメージ欄の色

$IN_TBL_Colorは、入力フォームのテーブル背景色（初期値は灰色）の指定です。
$IN_IMG_Colorは、入力フォームのアイコン名、ファイル名入力欄の背景色（初期値はオレンジ色）の指定です。

#--背景画像(未指定なら、表示しません)
# 設定例＞$BackGround = "http://homepage?.nifty.com/****/back.gif"';
$BackGround = "";

※掲示板の背景に壁紙を使用する場合は以下の様に指定します。
　　設定例では、壁紙画像ファイルを/homepage/yynifty/にアップロードしています。
　　設定例＞$BackGround = "http://homepage?/nifty.com/****/yy-nifty/????.gif";

　＠niftyでは、ｃｇｉ専用のディレクトリに設置した画像やHTMLファイルは正しく表示されない事に注意して下さい。
　壁紙画像の設置パスは/homepageの下ならどこでもかまいません。

◆掲示板タイトルの設定（１０１行目）
#--掲示板タイトル
# 画像の指定も可能です。
# 設定例＞$TopTitle = '<img src="http://homepage?.nifty.com/****/title.gif">';
$TopTitle = 'アイコン登録コーナー'; 　　#画面タイトルの指定
$TopColor ='#DD0000'; 　　　　　　　　　 #画面タイトルの文字色
$HeadTitle = "Regist Icon Corner"; 　　#<Head>タグのタイトル指定

※掲示板のタイトルや色を変更したい場合は、上記の設定を変更して下さい。
　タイトルに画像を使用したい場合は、以下のように指定します。
　設定例＞$TopTitle = '<img src="http://homepage?.nifty.com/****/title.gif">';

◆応用設定（１０８行目以降）

###############################################
###　応用設定（必要に応じて変更して下さい　　　　####
###############################################

#--文字サイズ（スタイルシート）
$head_size = '20pt'; 　　#タイトルの文字サイズ
$body_size = '12pt'; 　　#文字サイズ

※掲示板のタイトルや文字のサイズをポイント数で指定できます。

#--１ページの表示件数
$PageCount = 8;

※１ページに表示するログの件数を指定します。
　この件数以上のログがある場合は、次のページへのリンクが表示されます。

◆改ページマークと投稿者ホームページＵＲＬマークの設定（１１９行目）

#--改ページマークの設定
# 画像の指定も可能です。
# 設定例＞$PrevPageMark = '<img src="http://homepage?.nifty.com/****/PreMark.gif">';
$PrevPageMark = '<small>▲前のページ</small>';
$NextPageMark = '<small>次のページ▼</small>';

※ログが複数ページある場合の「次ページ」「前ページ」のマークを指定します。
　設定例の様に<img>タグで画像をマークに使うことも出来ます（画像は自分で用意します）

#--URLマークの設定
# 画像の指定も可能です。
# 設定例＞$HomeMark = '<img src="http://homepage?.nifty.com/****/home.gif">';
$HomeMark = '[HOME]';

※投稿者のホームページのＵＲＬマークを指定します。
　設定例の様に<img>タグで画像をマークに使うことも出来ます（画像は自分で用意します）

◆管理者簡易登録の為の設定（１３０行目）
#--管理者用簡易登録のための設定
$AdminName = '管理人'; 　　　　　　　　　#あなたのおなまえ
$AdminMail 　= 'admin@xxxx.ne.jp'　　; 　 #あなたのメールアドレス
$AdminURL　= 'www.xxxx.ne.jp/~admin'; #あなたのホームページＵＲＬ
$AdminComment = '管理人登録です'; 　#登録メッセージ

※管理者用簡易登録の設定です。
　管理者簡易登録では、アイコン名、ファイル名、登録キー（管理者パスワード）だけで画像が登録できます。
　登録者名、Ｅメール、コメントは、ここでの設定が自動的に反映されます。

◆保存セキユリティモードの設定（１４３行目）

#--保存セキュリティーモード
# 0-誰でも登録可能
# 1-パスワードによる制限
# 2-基本的に誰でも登録可能だけど、登録するリモートホストに制限をかける
$SaveMode = 0;
※この掲示板で画像を保存できるセキュリティモードを設定します。
　 0の場合…誰でも画像を登録することが出来ます。
　 1の場合…後述の登録パスワードを知っているユーザーだけが登録できます。
　 2の場合…登録を禁止するリモートホストを指定します。

#--登録用パスワード(保存セキュリティーモードが１のときに必要)
$UserPass = "passu";
※保存セキュリティモード＝１（パスワード制限）の場合に使用するパスワードを設定します。

#--登録不可リモートホスト名(保存セキュリティーモードが２のときに必要)
$NGRemortHost =<<'_____E_';
a
aa
aaa
_____E_
#↑ _____E_ は削除しないでください。

※保存セキュリティモード＝２（ホスト制限）の場合に登録を禁止するホスト名を指定します。
　＠niftyの場合は、ホスト名を取得できないのでＩＰアドレスで指定します。

◆ログの形式について

pup.cgiのログ（iconfile.log）の形式を以下に示します。旧バージョンのログを移行する際の参考にして下さい。

項目名	使用変数名	データ内容の凡例
画像FileName	$PicName	20000624182705.gif
アイコン名	$FORM{'TITLE'}	我楽多もぐら
標準時間	$GTime	961838825
登録キー（暗号化）	$EncodePass	Gy0AXXYf8Lbn
登録番号	$No	1
登録日時	$DateFormat	2000/06/24 (Sut) 18:27
お名前	$FORM{'NAME'}	Season
Ｅメール	$FORM{'EMAIL'}	season.aki@nifty.com
コメント	$FORM{'MESSAGE'}	試験アイコン
host名	$Host	192.168.0.1
画像横幅ピクセル	$PicWidth	100
画像高さピクセル	$PicHeight	100
画像タイプ	$PicType	GIF
画像容量(Byte）	$PicLen	5287
元FileName	$PicFile	mogura.gif
ＵＲＬ	$HPURL	homepage1.nifty.com/mystaff/topmenu.htm
専用アイコンフラグ	$FORM{'Only'}	on

◆ヒストリー

◆更新の履歴
# 1999/09/05 1.00 初版
# 2000/03/25 1.01 maileto -> mailtoに修正
# 2000/03/25 1.10 MultiPartのデコードを最新板に変更
# 2000/03/25 1.20 pngに対応
# 2000/03/25 1.30 Locationを使用するかどうか設定可能にした($LocationMode)
# 2000/03/25 1.40 マックバイナリの場合、マックバイナリを除去する処理を追加
# 2000/03/25 1.41 IP,リモートホストなどの投稿者情報をコメントにした
# 2000/06/24 1.42 登録フォームのデザイン変更、ＵＲＬ入力欄を追加　　　(by Season)
# 2000/06/24 1.50 使用者専用アイコンの指定が出来るように項目を追加　 (by Season)
# 2000/06/24 1.51 パスワードの暗号化＆照合ロジックをyy-niftyと統一　 (by Season)

# 2000/08/04 1.60 以下の変更を行った(by Qz)
#　　改ページ処理
# 　　ホームページのマークの選択OKにした
# 　　ログファイルよみこみのロジック変更
# 　　表示順番の設定はやめにした
# 　　最大保存件数に達した時、登録フォームの表示ができないように変更
# 　　管理者用簡易アイコン登録モードの追加
# 　　管理者用簡易アイコン登録のためと、あまり意味がないのと、
# 　　うまく動作しないプロバイダがあるので、$LocationModeをやめた

# 2000/08/16 1.70 以下の変更を行った(by Season)
# 　　スタイルシートで文字ポイントを指定する方法に変更
# 　　掲示板タイトルの設定方法を変更
# 　　使用方法の欄に最大保存件数を表示する様に変更
#
# 2000/08/24 1.71 以下の修正を行った(by Season)
# 　　投稿フォーム表示ルーチンを常に管理者用登録モードにしていた為、
#　　通常登録処理でパスワードエラーが発生していたバグを修正。
#
# 2000/10/14 1.72 以下の修正を行った(by Season)
# 　　管理者簡易登録モードで「お名前が未入力です」エラーが出るバグを修正
# 　　管理者簡易登録用の初期変数に$AdminURL(ホームページＵＲＬ)を追加
# 　　管理者簡易登録モードから一般登録モードへのリンク表示を追加

Back