我楽多 cgi @nifty	Sunroom設置説明書	最終更新日：2002/08/25(Sun)
	ウィルスチェック無料、ドメイン取得維持無料 レンタルサーバー

Sunroomとは、KENT-WEBさんのSunBoardを元に改造したYY-BOARDの様な返信型の掲示板です。
ログをHTMLに整形して出力するので、サーバーへの負荷が少なく閲覧時の動作が軽快なのが特徴です。
Sunroomは、KENT-WEBさんの「再配布規定」に基づいて再配布を行っています。
ご利用される前に「ＣＧＩスクリプト利用規定」を必ずお読みください。
※SunBoardＣＧＩスクリプトは、ＫＥＮＴさんの著作物です。

開発コンセプト
Sunroomは「シンプルで軽快な動作の返信型ＢＢＳ」を目指して作成しました。
開発の大きな動機は、yy-niftyの様な多機能な掲示板はテレホタイム等の時間帯に動作が非常に遅くなることでした。
Sunroomは表示部分がＨＴＭＬでサーバー負荷が少なく且つYY-BOARDの様に返信記事が親記事の階層に表示される
「軽快な動作」が特徴のHTML表示タイプの返信機能付きＢＢＳです。　

主な特徴は、以下の通りです。

• 通常のＣＧＩ掲示板と違い、ログをHTMLファイルに整形して表示するので、サーバの負荷が少ないです。
• 親記事に対して返信記事を付けることが出来ます。返信は誰でも行えます。
• 投稿記事に一覧から好きなアイコンを選択して表示できます。（アイコン無しの設定も可能）
• 新規投稿フォームもHTMLファイル上に表示しています（JavaScriptでクッキーに対応しています）
• 投稿フォームのラジオボタンで投稿記事のタイトル、文字、背景の色選択が可能です。
• 投稿者自身で投稿記事の編集、削除を行うことが出来ます。(Ver1.00より）
• WEB上からタイトル壁紙、パスワード等の各種設定の変更が可能です。(Ver1.00より）
• WEB上からアイコンの登録、削除が行えます。(Ver1.00より）
• YY-BOARD Ver4.xと同じdataファイル形式の過去ログ機能があります。

サンプルはこちら＞Sunroom設置サンプル（試験書き込みは出来ません）

以下の圧縮ファイルをダウンロードします。
圧縮ファイルは LHA形式と ZIP形式のいずれかを選んでください。

バージョン情報　：Sunroom.cgi Ver1.06

ダウンロード後、圧縮ファイルを解凍すると以下の１６個ファイルが展開されます。

尚、フリーの掲示板用アイコンが欲しい方は、以下のサイトを訪ねてみて下さい。

掲示板用アイコンのお勧めサイト
ホームページ名	内　　　　　　　容
	赤毛のアンや妖精等の可愛い素材があるホームページです。 掲示板用の顔アイコンや動物アイコンもフリーで提供されてます。 サンプルの掲示板でも、一部アイコンを使わせてもらってます。
	ニフティで知り合いになったゆうさんのフリー素材のホームページ。 幻獣、妖精、異界人、１２星座など写実的なファンタジー系の素材があります。
	ほのぼのとした絵柄のイラストを描かれる城尾浩美さんのホームページ。 掲示板のアイコンに使える版権フリーのイラストが沢山あります。 素材を使われた方は、Ｅメールで一言お礼を送って下さいね。
	トラックポインタで自作アイコンを作成されているLinoさんのホームページ。 掲示板に使える家アイコン、メールアイコン、人物アイコン等を配付してます。

◆@nifty対応のディレクトリ構造
　　　@niftyには、cgi-binにおけるファイルに制限があります。（共通事項参照）
　　　Sunroomを設置するためには、以下の様なディレクトリを作成する必要
　　　があります（ディレクトリ名は任意です）

　  Root/ ←あなたのルートパス
　　　|
　　　+--cgi-bin/　←http://hpcgi▲.nifty.com/■■■■■■　
　　　|       |
　　　|       +--sunroom/（cgi本体を設置する場所）
　　　|
　　　+--homepage/　←http://homepage▲.nifty.com/■■■■■■　
　　　　　　　　|
　　　　　　　　+--sunroom/（HTMLや画像ファイル等を設置する場所）

◆スクリプトの必須変更箇所（動かす為に絶対変更する所）
　　エディタ等でsunroom.cgiを開いて、基本設定欄を以下の様に変更します。
　　青字の部分 … この設置説明の通りのファイル配置であれば特に変更の必要がありません。
　　赤字の部分 … 管理者パスワード、記事最大保持数、1ページの記事数をあなたの好みに合わせて変更します。
　　▲■の部分 … あなたに割当てられた＠ｎｉｆｔｙのＵＲＬアドレスに合わせて変更します。

　　エディタ等でiconmgr.cgiを開いて、基本設定欄を以下の様に変更します。
　　青字の部分 … この設置説明の通りのファイル配置であれば特に変更の必要がありません。
　　赤字の部分 … 管理者パスワード、記事最大保持数、1ページの記事数をあなたの好みに合わせて変更します。
　　▲■の部分 … あなたに割当てられた＠ｎｉｆｔｙのＵＲＬアドレスに合わせて変更します。

◆ファイルのアップロード
　　スクリプトの変更が完了したら、以下のディレクトリにアップロードして各ファイルのパーミッションを下記の通り変更します。

　 　Root/ ←あなたのルートパス
　  　|
   　 +--cgi-bin/
   　 |    |
   　 |    +--Sunroom/パーミッション[777]（任意のディレクトリ名）
   　 |         jcode.pl    パーミッション[644]
   　 |         cgi-lib.pl  パーミッション[644]
   　 |         sunroom.cgi パーミッション[755]
   　 |         sunroom.cfg パーミッション[666]
   　 |         sunroom.log パーミッション[666]
   　 |         setup.cgi　 パーミッション[755]
   　 |         icon.pl     パーミッション[666] ※アイコン使用時に必要
   　 |         iconmgr.cgi パーミッション[755] ※アイコン管理に必要
   　 |         iconmgr.dat パーミッション[666] ※アイコン管理に必要
   　 |         pastno.dat  パーミッション[666] ※過去ログ機能を使用する場合に必要
   　 |         1.dat    　 パーミッション[666] ※過去ログ機能を使用する場合に必要
   　 |
   　 +--homepage/
          |
          +--Sunroom/（任意のディレクトリ名）
       　 　  | page1.html  パーミッション[666]
       　 　  | page2.html　パーミッション[666]
       　 　  |      *.gif (壁紙、タイトル画像等)
       　 　  +--icon/ パーミッション[777]
　　　　　　　　　   home.gif (投稿者ＵＲＬリンクの家アイコン)
　　　　　　　　　   0.gif    (削除アイコンの代替画像ファイル)
　　　　　　　　　   *.gif    (任意のアイコン画像ファイル等)

　
◆sunroom.cgiの初期設定とリンク指定
　　ここまでの最低限の設定で、Sunroomは@niftyで動きます。
　　Sunroomの実行スクリプト名は「sunroom.cgi」です。

　※設置して初めて実行する場合（Setupモードの実行）
　　　Sunroomを設置後はじめて実行する場合は、ブラウザから下記の様に入力します。
　　　＞http://hpcgi▲.nifty.com/■■■■■■/sunroom/sunroom.cgi?mode=setup
　　※ＵＲＬアドレスの▲と■■■■■■の部分は、自分の@niftyのＵＲＬに読み替えて下さい。

　(1)　セットアップモードで呼び出すと管理者パスワードを入力する画面が表示されます。
　 (2)　管理者パスワード「初期値＝0123」を入力して送信キーを押すとHTMLファイルの自動更新が始まります。
　 (3)　しばらくすると掲示板の画面が表示されます。
　　　　※sunroom.cgiの設定を変更した後は、必ずセットアップ処理を行ってください。

　※２回目以降の呼び出し方法＆リンク指定
　　ホームページでSunroomを呼び出すリンクには下記の通り表示ＨＴＭＬファイルのＵＲＬを指定します。
　　<a href="http://homepage▲.nifty.com/■■■■■■/sunroom/page1.html">掲示板</a>

セットアップ処理が完了したら、環境設定で各種項目の設定を変更することが出来ます。
環境設定は、掲示板メニューから[管理用]→[環境設定]で呼び出せます。
アイコン管理は、掲示板メニューから[管理用]→[アイコン管理]で呼び出せます。

■以下に環境設定画面の呼び出し方を図解します。

１．掲示板のメニューから[管理用]をクリックします。


２．管理メニューから[環境設定]を選択します。


３．管理パスワード（初期値は「0123」）を入力します。


４．設定画面が表示されます。※管理者パスワードは必ず変更して下さい。



■設定内容について
環境設定画面では、以下の項目が設定できます。
それぞれの設定項目の詳しい内容については、以下の解説をご覧下さい。

　Sunroom.cgiのWeb設定で変更できない項目は「応用設定」欄にまとめてあります。
　通常の使用では殆ど使用しない設定項目ばかりですが、変更したい場合は以下の解説を参考にして下さい。

#================#
# 応用設定項目　 #
#================#
# タグ広告挿入オプション (FreeWebなど）
# → <!--上部--> <!--下部--> の代わりに「広告タグ」を挿入する。
# → 広告タグ以外に、MIDIタグ や LimeCounter等のタグにも使用可能です。
$banner1 = '<!--上部-->'; # 掲示板上部に挿入
$banner2 = '<!--下部-->'; # 掲示板下部に挿入
※ 掲示板の上下に画像（広告、リンクバナー等）を挿入するときに使用します。
　バナー行の段落変えと左右表示位置（初期値は中央）もタグで指定します。
(設定例）
中央…$banner1 = '<img src="http://www.hogehoge.ne.jp/image.jpg"><P>';
右詰…$banner1 = '<DIV ALIGN=Right><img src="http://www.hogehoge.ne.jp/image.jpg"></DIV><P>';
左詰…$banner1 = '<DIV ALIGN=Left><img src="http://www.hogehoge.ne.jp/image.jpg"></DIV><P>';

※ＢＧＭ（音楽）を鳴らすタグを挿入する事も出来ます。
　 例：$banner1 = '<embed src="http://homepage▲.nifty.com/■■■■■■/BGM.mid" autostart=true loop=true hidden=true>';
　　　　　　　　　　　　　　　　　　　　　↑
　　BGM.midの部分は、任意のmidiファイル名を指定して下さい。
　　また、閲覧者のブラウザが<embed>タグに対応している必要があります。

# キャッシュ拒否のMETAタグ挿入 (0=no 1=yes)
$nocashe =1;
※この設定は特に変更する必要がありません。

# ホスト名取得モード
# --> 0 : $ENV{'REMOTE_HOST'} で取得できる場合
# --> 1 : gethostbyaddr で取得できる場合
$get_remotehost = 0;
※この設定は特に変更する必要がありません。

# ファイルロック形式
# --> 0=no 1=symlink関数 2=dir関数
# --> 1 or 2 を設定する場合は、ロックファイルを生成するディレクトリ
# のパーミッションは 777 に設定する。
$lockkey = 1;
※新規記事投稿時の衝突によるログの消失を防ぐためにファイルロック機能が用意されてます。
　　初期値では$lockkey = 2;「dir関数」になっています。
　@niftyではsymlink関数が使えますので、ロックファイルを使用する場合は$lockkey = 1;として下さい。

# ロックファイル名
$lockfile = "./sunroom.lock";
※この設定は特に変更する必要がありません。

# 記事の更新は method=POST 限定 (0=no 1=yes)
# --> 連続投稿などの荒らし対策
$MethPost = 1;
※この設定は特に変更する必要がありません。

#---(以下は「過去ログ」機能を使用する場合の設定です)---#
#
# 過去ログ用NOファイル
$nofile = './pastno.dat';
※過去ログ番号ファイル名の設定です。（変更の必要はありません）

# 過去ログのディレクトリ
# → sunroom.cgiと同一のディレクトリに作成するならばこのままでよい
# → フルパスなら / から記述（http://からではない）
# → 最後は必ず / で閉じる
$pastdir = './';
※過去ログデータファイル（1.dat）の保存ディレクトリ名の設定です。
　 sunroom.cgiと同じディレクトリに保存する場合は変更の必要はありません。

# 他サイトから投稿排除時に指定 (http://から書く)
$base_url = "";
※書き込みを禁止したいホストのＵＲＬをhttp;//から記述します。（閲覧は出来ます）
　 例えば、http://www.hogehoge.comというホストから接続しているユーザーに投稿されたくない場合は、
　 $base_url = "http://www.hogehoge.com";と設定します。（ＵＲＬは部分指定で有効です）
　 相手には「不正なアクセスです！」というエラーＭＳＧが表示されます。
　 $base_url = "/proxy";と設定すると、簡易なプロキシ経由のアクセス制限になるかもしれません。
　しかし…@niftyではこの機能の動作は未確認です。ＤＮＳの逆引きが出来ないので多分使えません。

# アクセス制限（ホスト名を記述）
@deny = (
　　　　　"192.168.0.*",
　　　　　"",
　　　　　"",
　　　　　"",
　　　　　"",
　　　　　"",
　　　　　"",
　　　　　"",
　　　　　""
　　　　);

掲示板へのアクセスを全面的に禁止します。（HTML表示ファイルは閲覧できますが新規投稿や検索機能は使えません）
@deny設定欄にアクセス制限したいＩＰアドレスを記入します。（@niftyでも動作します）
投稿者のＩＰアドレスは、管理者モードで確認できます。
ＩＰアドレスの指定には、ワイルドカードを使えるので、
127.0.0.1 というＩＰアドレスのホストにまとめて制限をかけたい場合は、
127.0.0.* という風に記述します。
相手には、「アクセスを許可されてません」と表示されます。

◆その他の注意点
　　　Sunroomの最大の特徴は、表示部にHTMLファイルを使用している事です。
　　　一度生成されたＨＴＭＬファイルは、登録・編集機能でＨＴＭＬファイルを更新しないと表示が変わりません。
　　　その為、デバッグ中はＣＧＩスクリプトを変更しただけでは表示結果に反映しません。
　　　表示部のデザイン等を変更した場合は、setup機能で表示用ＨＴＭＬファイルを更新して下さい。

Sunroomの設置で作者が経験したトラブルを記しておきます。
ここまでの説明で、Sunroomの設置や設定の変更がうまくいかない場合は、以下の点を確認して下さい。

◆サーバーエラーになる？
　　・スクリプトの１行目のperlのパスが間違っている。（@nifty仕様なので、変更不要です）
　　・各種ファイルのパーミッションの設定が正しくない？　 （ココを参照して正しく設定して下さい）
　　・各種ファイルのサーバーの設置場所を間違えている？（ココを参照して正しく配置して下さい）
　　・サーバーが混雑している？（時間を置いて再度試してみて下さい）
　　・ｃｇｉスクリプトをＦＴＰ転送する時にアスキーモードにしていない？
　　・ｃｇｉスクリプトを編集するエディタがソースに余分な制御コードを付加している？
　　（ワープロソフト等の保存形式を用いずにテキスト形式で保存して下さい）

◆ｃｇｉエラーになる？
　　・スクリプト命令の行末の「；」記号が抜けている？
　　・スクリプト命令の行末の「；」記号の後ろに全角のスペースがある？
　　・画面に表示する変数（掲示板タイトル等）の中身に特殊文字（@、!、$、%、&）を使ってる？

◆ページが見つかりませんと表示される？
　　・ＣＧＩの呼び出しＵＲＬが間違っている？
　　　　　良くある誤り　>http://homepage▲.nifty.com/■■■■■■/Sunroom/sunroom.cgi
　　　　　ＣＧＩのＵＲＬ 　>http://hpcgi▲.nifty.com/■■■■■■/Sunroom/sunroom.cgi
　　・スクリプト内のパス名、ＵＲＬ名がサーバーのディレクトリ名と相違している？

◆Sunroomの改造履歴
　　2000/11/25 Ver0.10 SunBoardのログ仕様を変更、返信記事の階層表示機能を追加。
　　2000/11/26 Ver0.11 ＨＴＭＬ出力ルーチンでログ件数の参照漏れを修正
　　2000/11/26 Ver0.12 投稿フォームの表示デザインを変更
　　2000/11/27 Ver0.13 文字色選択ラジオボタンの初期値が無しになる不具合を修正。
　　2000/11/27 Ver0.20 ＣＧＩの設定内容でＨＴＭＬを更新するSetupモードを追加。
　　2000/12/09 Ver0.30 表示画面と返信画面のレイアウトを変更、クッキー保存選択を追加
　　2000/12/30 Ver0.40 クッキーの保存／読込をJavaScriptに変更。
　　2000/12/31 Ver0.50 管理者モードに「投稿記事の編集機能」を追加。
　　2000/12/31 Ver0.51 HTMLページ生成で親記事のみカウントする様に修正。
　　2000/12/31 Ver0.60 YY-BOARDVer4.0と同じdataファイル形式の過去ログ機能を追加。
　　2001/01/01 Ver0.61 Setupモードを修正、管理者パスワード入力画面を追加。
　　2001/01/01 Ver0.62 アイコンモード使用時の画面レイアウトの乱れを修正。
　　2001/01/02 Ver0.63 アイコン選択のクッキー不具合を修正
　　2001/01/02 Ver0.64 管理者モードの記事編集で選択アイコンを修正可能にした。
　　2001/01/03 Ver0.65 投稿フォームと記事のテーブル表示幅を設定項目に追加。
　　2001/01/03 Ver0.66 表示ログが無くても「次ページ」が表示される不具合を修正。
　　2001/01/06 Ver0.67 HTML更新で１件目のログを読み飛ばしていたバグを修正。
　　2001/01/07 Ver0.68 編集処理で２ページ目のHTMLファイル更新の不具合を修正。
　　2001/01/13 Ver0.69 HTMLページに壁紙とタイトル画像の設定が反映されない不具合を修正。
　　2001/02/25 Ver0.70 Bodyタグの文字色設定を追加（黒背景対応）
　　2001/02/25 Ver0.71 フッターにページトップに戻るボタンを追加。
　　2001/02/25 Ver0.72 編集モードでのＵＲＬオートリンク変換漏れを修正。
　　2001/02/28 Ver0.73 新規生成の過去ログデータファイルのパーミッション６６６変更漏れを修正。
　　2001/03/13 Ver0.74 記事表示部の中央揃えに<div align=center>を適用。
　　2001/03/13 Ver0.75 掲示板へ戻るリンクを$scriptからpage1.htmlに変更。
　　2001/04/07 Ver0.76 過去ログ表示の改ページ処理のミスを修正。
　　2001/08/22 Ver0.77 HTMLヘッダーにキャッシュ制御のメタタグを追加
　　2001/09/06 Ver0.78 Location使用モードの設定追加（location使用不可サーバー対応）
　　2002/05/26 Ver0.79 本文中ＵＲＬの自動リンクを新ウィンドで開く様に変更。
　　2002/05/26 Ver0.80 画面デザインを若干変更＆ネスケでの表示不具合に対応
　　2002/06/02 Ver0.85 Cookie処理を大幅に改訂＆クッキーの動作不具合を改善。
　　2002/06/07 Ver0.90 ユーザー記事編集機能を追加
　　2002/06/10 Ver1.00 Web設定機能とアイコン管理機能を追加
　　2002/06/12 Ver1.01 HOMEへ戻るリンクの不具合を修正
　　2002/06/13 Ver1.02 タイトル画像、壁紙画像の表示不具合を修正
　　2002/06/19 Ver1.03 アイコン未使用時のアイコン用クッキー読み込みの不具合を修正
　　2002/06/19 Ver1.04 色選択を未使用時の色選択用クッキーの不具合を修正
　　2002/06/19 Ver1.05 色選択が単色指定の場合の色セットを入力チェックサブルーチンに移動
　　2002/08/25 Ver1.06 ユーザー削除処理の不具合を修正

■ＣＧＩ設置代行サービス
　▲ＣＧＩ設置代行サービスを行うサイトと提携しました。
　　ご自分でＣＧＩを設置できない方やニフティ以外に設置したいという方はご利用してみて下さい。

設置に成功したら、是非 BBSか メールでご報告をお願いします。
設置成功のご報告が何よりもホームページ運営の励みになりますので。
もしよろしければ、Sunroomを設置されたＨＰと掲示板へのリンクを LinkPageで紹介させてもらいます。(^-^)

また、下記のフォームを利用すれば、このページに直接コメントが出来ますので
このページのご意見、ご感想などの発言にお気軽にご利用下さい。
※一言コメントの記事最大保存数は３０件です。（旧い記事は自動的に削除されます）

■このページのご感想など、一言コメントをお願いします。