【多機能電子会議室】
じょじょBBS ver.8.15

Release on 2007/07/20
Copyright(c) 1997-2007 JoJo's Web Lab.
Email: webmaster@starwars.jp
URL: http://www.starwars.jp/web/


1. はじめに

「じょじょBBS」はあなたのサイトを訪れたゲストの方々で、テーマ別の情報交換をしてもらうための電子会議室システムです。ゲストは自由にテーマを決めて新しいトピックを作成でき、他の人たちがそのトピックにメッセージを書き込むことができます。活発な情報交換が実現すれば、あなたのサイトも繁盛間違い無し!設置はとても簡単です。この機会にぜひ、じょじょBBSを!


2. 利用規定および免責


3. 特徴

じょじょBBSの主な機能は以下のとおりです。


4. 動作環境

(1) サーバ環境

(2) クライアント環境


5. 設置方法

(1) 本体の新規設置

  1. bbs???.lzh もしくは bbs???.zip を適当なツールで解凍します。
  2. bbs.cgi の1行目を、プロバイダから指示された perl のパスに変更します。
  3. 下記の設置例にしたがって、すべてのファイルをASCIIモードでサーバに転送します。
  4. bbs.cgi と同じ位置に log/ および backup/ というディレクトリを作成します。
  5. 下記の設置例の[ ]内の指示にしたがって、各ファイル、ディレクトリのパーミッションを設定します。
  6. ブラウザのURL入力欄に http://〜/~user/bbs/bbs.cgi と入力し、アクセスします。
  7. トピック一覧画面(最初はトピックはありません)が表示されたことを確認したら、http://〜/~user/bbs/index.html をアクセスします。
  8. 上記2つの結果が同じになれば設置完了です。訪問者には http://〜/~user/bbs/index.html を公開します。
  9. アイコンを変更・追加する際は icon.js を編集します。

設置例

    public_html/
        |
        |---- bbs/     [777]  ディレクトリ
        |       |
                |---- log/         [777]   ログ・ディレクトリ ※1
                |---- backup/      [777]   ログのバックアップ用ディレクトリ
                |---- bbs.cgi      [755]   じょじょBBS本体
                |---- bbs.css      [644]   じょじょBBS用スタイルシート
                |---- bbs.js       [644]   じょじょBBS用JavaScriptファイル
                |---- icon.js      [644]   アイコン定義用JavaScriptファイル
                |---- index.log    [666]   トピック一覧画面用データ
                |---- check.log    [666]   多重投稿防止用データ
                |---- index.html   [666]   トピック一覧画面用HTMLファイル パーミッションに注意!
                |---- new.html     [644]   新規トピック作成画面用HTMLファイル
                |---- idxtmp.html  [644]   トピック一覧画面用テンプレートファイル
                |---- deltmp.html  [644]   トピック削除画面用テンプレートファイル
                |---- mestmp.html  [644]   メッセージ一覧画面用テンプレートファイル
                |---- updtmp.html  [644]   メッセージ修正画面用テンプレートファイル
                |---- srctmp.html  [644]   検索結果一覧画面用テンプレートファイル
                |---- jscm.pl      [644]   じょじょのWeb工房共通ライブラリ
                |---- jcode.pl     [644]   日本語ライブラリ(Jcode.pmが使用可能な場合は不要)
                |

   ※1 セキュリティ上、logディレクトリの名称は各自で適当な名前に変更することを強く推奨します。
       その場合、bbs.cgi内で log という名称を定義している部分をあわせて修正してください。

注意事項

  1. public_html/ は、プロバイダによっては html/ や WWW/ 、htdocs/ などの場合があります。
  2. CGIの設置できるディレクトリが cgi-bin/ などに限定されている場合は、bbs/ をその配下に作成してください。
  3. CGIのパーミッションの設定は、プロバイダによって異なる場合があります。必ず確認して、プロバイダの指示を優先してください。
  4. jcode.pl は、歌代和正氏によるフリーウェアです。ftp://ftp.iij.ad.jp/pub/IIJ/dist/utashiro/perl/

(2) スクリプトのバージョンアップ

原則として bbs.cgi と jscm.pl の置き換えだけで正常に動作しますが、設置後に必ずブラウザのURL入力欄に http://〜/~user/bbs/bbs.cgi と入力し、アクセスする作業を行ってください。


6. カスタマイズ

(1) スクリプトのカスタマイズ

必ず perl のパスだけを書き換えた状態で動作テストを行ってからカスタマイズを開始してください。最低限必要な項目以上に手を入れた状態では、設定ミスによる誤動作が起こった場合に原因を突き止めることが困難になります。

(2) テンプレートのカスタマイズ

テンプレートHTMLは、以下の要素を除き、自由に変更することが可能です。ただし、テンプレートの改造による表示のカスタマイズはHTMLやCGIについてある程度の知識を要求しますので、初心者の方は極端な変更を行うことは避けてください。

(3) アイコンのカスタマイズ

アイコンはすべて同じサイズ(ファイルサイズではなく、画像サイズ)のGIF画像のみ使用可能です。idxtmp.html、mestmp.html、updtmp.html の各テンプレートに、以下の要素を追加します。

アイコン(kirin.gif)の追加例

document.write('<select id="icon" name="icon" tabindex="10">');
document.write('<option value="">好きな動物</option>');
document.write('<option value="ahiru">アヒル</option>');
document.write('<option value="buta">ぶた</option>');

      ・・・・・・・・

document.write('<option value="kirin">キリン</option>'); 追加。value属性はファイル名から .gif を外したものを使う。
document.write('</select>');

7. 操作方法

(1) トピックを削除する(管理者または副管理者のみ)

  1. 画面下の「管理者用パスワード」欄に、bbs.cgi 中で設定したパスワードを入力し、[管理者用]ボタンをクリックします(管理者モードに移行)。
  2. 削除したいトピック名の前にあるチェックボックスをチェックします。
  3. すべてを選択したら、一覧の下にあるテキストボックスにもう一度管理者用パスワードを入力し、[削除]ボタンをクリックします。
  4. 選択したトピックが一覧画面から削除され、メッセージの閲覧ができなくなります。

削除されたトピックのログファイルは、log/ 配下から、backup/ 配下に移動されるだけです。物理的に削除されるわけではないので、古いログが溜まってディスク容量が圧迫される場合は定期的に backup/ の配下を掃除する必要があります。

(2) メッセージを修正する

  1. 修正したいメッセージのあるトピックを表示させ、修正対象メッセージの「発言No」を確認します。
  2. メッセージ一覧画面にある修正/削除フォームに削除対象メッセージの「発言No」と「管理コード」を入力し、[修正]ボタンをクリックします。
  3. 修正前のメッセージがフォーム内に表示されるので、修正を行って[修正]ボタンをクリックします。
  4. 以降、修正されたメッセージが表示されるようになります。

[管理コード]欄に管理者用パスワードを入力すると、任意のメッセージを更新することができます。逆に、管理コードが登録されていないメッセージは管理者用パスワードを使用しなければ更新することができません。

同様に、終了状態になっているトピックのメッセージは管理者用パスワードでなければ更新することができません。

(3) メッセージを削除する

  1. 削除したいメッセージのあるトピックを表示させ、削除対象メッセージの「発言No」を確認します。
  2. メッセージ一覧画面にある修正/削除フォームに削除対象メッセージの「発言No」と「管理コード」を入力し、[削除]ボタンをクリックします。
  3. 以降、該当するメッセージが表示されなくなります。

管理者または副管理者による削除

10, 12, 13カンマ区切りで複数指定
15-20範囲指定
-102〜指定した番号までのすべて(1は削除できません)
10-指定した番号以降すべて
22, 26, 30-32, 55-以上の組み合わせ

(4) キーワード検索機能を使う

複数のキーワードを指定でき、それぞれのキーワード間にANDとORの設定ができます。ANDは「&」、ORは「|」で表現し、( )で優先順位をつけることも可能です。キーワードや & | ( ) の各種の記号は、必ず前後に半角スペースを入れて区切ってください。

例) 「赤い」と「速い」を含み、かつ「車」または「飛行機」を含むメッセージの検索

赤い & 速い & ( 車 | 飛行機 )

(5) リファレンスリンク機能を使用する

発言内容に特殊な記述を行うと、同一トピック内の任意のメッセージに対するリンクに変換されます。変換規則は以下のとおりです。

>>n発言番号 n のメッセージへのリンク
>>n-発言番号 n 以降のメッセージへのリンク
>>-m発言番号 m までのメッセージへのリンク
>>n-m発言番号 n から m までのメッセージへのリンク

なお、指定された範囲に削除されたメッセージがある場合、表示はされませんが、件数にはカウントされます。

(6) 特定のメッセージのみを表示させる

URLに引数をつけることによってトピック内の特定のメッセージを表示させることができます。引数の付け方は以下のとおりです。

http://〜/~user/bbs/bbs.cgi?id=2001050100;target=n発言番号 n のメッセージを表示
http://〜/~user/bbs/bbs.cgi?id=2001050100;ln=n最近の n 件のメッセージを表示
http://〜/~user/bbs/bbs.cgi?id=2001050100;fs=m最初の m 件のメッセージを表示
http://〜/~user/bbs/bbs.cgi?id=2001050100;st=n発言番号 n 以降のメッセージを表示
http://〜/~user/bbs/bbs.cgi?id=2001050100;en=m発言番号 m までのメッセージを表示
http://〜/~user/bbs/bbs.cgi?id=2001050100;st=n;en=m発言番号 n から m までのメッセージを表示

なお、指定された範囲に削除されたメッセージがある場合、表示はされませんが、件数にはカウントされます。

(7) 偽者防止機能

偽者防止機能を「あり」に設定すると、投稿者名の右に表示される日付欄に「管理コード」から一意に生成されるIDが付加されます。このIDが同一であるということは管理コードが同一であることを意味し、「名前」が同じ別人との識別を可能にします。

なお、「管理コード」に「管理者用パスワード」を入力した場合、IPアドレスの表示が常に Admin となります。

(8) 閲覧専用モードにする

bbs.cgi と同じ位置に lock というファイル(またはディレクトリ)を置くと、書き込みをできなくすることができます。旅行などで管理ができなくなる場合に使用すると便利です。

(9) バージョンを表示する

bbs.cgi?version でアクセスすることにより、スクリプトのバージョンを表示することができます。


8. サポート

(1) うまく動かない場合

カスタマイズを行う前に、以下の項目を確認してください。

(2) それでも動かないときは

設置やカスタマイズに関する質問、不具合の報告などはじょじょのWeb工房にあるWeb相談室で行っています。特別な理由がある場合を除き、メールでの質問などはご遠慮ください。

なお、原則として大幅な改造を必要とする相談には応じられませんので、予めご了承ください。

同サイトのゲストブックでは、このスクリプトの感想や次回バージョンへのご要望なども受け付けております。


9. 謝辞

じょじょシリーズ作成にあたり、各方面の会議室などで有益な助言、提案、バグ報告を下さった方々に心から感謝いたします。


10. 更新履歴

2007/07/20  ver.8.15

2006/09/18  ver.8.14

2006/03/11  ver.8.13

2005/10/09  ver.8.12

2005/09/11  ver.8.11

2004/08/09  ver.8.10

2003/12/29  ver.8.03

2003/11/15  ver.8.02

2003/11/08  ver.8.01

2003/06/09  ver.8.00

2002/04/08  ver.7.06

2002/04/01  ver.7.05

2002/02/14  ver.7.04

2001/11/29  ver.7.03

2001/11/27  ver.7.02

2001/07/24  ver.7.01

2001/05/09  ver.7.00

バージョンアップは順次行われています。最新情報はじょじょのWeb工房にてご確認ください。また、未公開のβ版をサンプルとして公開することもあります。

以上


Presented by じょじょ♪ <webmaster@starwars.jp> (http://www.starwars.jp/web/