Schedule Board 設置方法

本CGIはイベントでの日程調整用に作成しました。

「飲み会やツーリングを開催し、できるだけ多くの人に参加してもらいたいので日程の調整をしたい。」
「誰が参加できそうなのか、他の参加予定者からも見えるようにしたい」を基本として制作。

• 日付毎に参加・未定・不参加の集計を出力
• 新規登録、修正した日付を表示
• 登録内容は後で修正可
• 参加・未定・不参加の記号と意味を任意に設定可能
• イベント設定画面からイベントデータ、スケジュールデータの全削除が可能
• イベント設定画面からスケジュールデータの個別削除が可能
• 最大参加人数の文字色が変わる
• イベント日を決定し、その日のみ表示させる。
• イベントが終了したことを知らせるイベント終了設定が可能
• 簡易BBS機能（不使用にもできる）（v1.6.0以降）
• 任意項目欄追加機能
• イベント決定日を複数設定できる。
• 最大人数のカウントを任意の記号に対して設定可能
• 日付、任意項目欄追加数の任意設定が可能
• パスワードによる入室制限機能 NEW ...(v1.6.7)
• スパム対策機能(JavaScript ON必須) NEW ...(v1.6.7)

本スクリプトは複数の人が同時にファイルに書き込まないようにする制御にflock関数を使用しています。
まず本スクリプトを利用する前に、使用しているプロバイダ（サーバ）がflock関数に対応しているかどうかの確認をしてから利用して下さい。

flock関数の対応チェック方法

ファイルの構成

  public_html (ホームディレクトリ)
      |
      +-- schedule /   schedule.cgi    [705]
            |          jcode.pl        [604] 
            |          style.css
            |          title.gif
            |          sample-key.gif(v1.6.0以降のみ)
            +-- data / evtdata.txt   [606]
                       schdata.txt   [606]
                       bbsdata.txt   [606](v1.6.0以降のみ)

ファイル修正に際しての注意

本CGIは「Shift-JIS」というほとんどの掲示板用CGIでも使われている文字コードで記述していますが、Shift-JISで書かれたperlスクリプト（CGI）をUNIXサーバーで実行させた時などに、一部の文字で発生します。

例えば「表示」のShift-JIS漢字コードは「95 5C 8E A6」ですが、この「表（95 5C）」の5Cというコードが 、メタ文字（特殊文字）「\（バックスラッシュ）」と重複しているために、二つの文字「95 5C(表)」「8E A6(示)」が「95 8E 」と「A6」と解釈され、侮ヲ（半角）という文字化けが発生します。

この問題を解決するには以下の回避策を参考にして下さい。
もっと詳しく知りたい方は「cgi 文字化け」などで検索してみてください。

回避策

例："表\示する"

$str = '表示する'

$cgi_title = 'Schedule Board';

$cgi_title = 'スケジュール調整表';

$cgi_title = 'スケジュール調整表\';

文字化けする文字一覧

ファイルの修正

schedule.cgiをエディタ開き、以下の個所を修正します。

各バージョン共通

• プロバイダで定められたPerlへのパスを指定

  #!/usr/local/bin/perl

• Schedule Boardのサイトタイトル。
  イベントのタイトルではなく、ブラウザの上部や一番上に表示されるタイトルです。

  $cgi_title = 'Schedule Board';

• 上記のタイトルに画像を使用する場合の画像の場所を指定

  $title_img = './title.gif';

• タイトル用画像を使用する場合の幅と高さ（単位：px）

  $img_width = '190px';
  $img_height = '25px';

• 外部スタイルシートの場所

  $style = "./style.css";

• イベントデータ（イベントタイトル、イベント情報、日にち設定データ）の場所

  $evtdata = "./data/evtdata.txt";

• 各人のスケジュール登録データの場所

  $schdata = "./data/schdata.txt";

• cgiの場所

  $cgi_url = "./schedule.cgi";

• ホームページのURL

  $home = "";

• 管理者用パスワード

  $admin_pass = '0123';

• 場所のタイトルの設定（「行き先」や「集合場所」などの表現）

  $place_title = '行き先';

• 各人のスケジュール登録日の表示・非表示設定
  0:非表示、1:表示

  $date_hide = 1;

• イベント日決定後もイベント設定の日付や記号の変更を可能にする
  0:不可、1:可

  $aft_fix = 0;

• 項目欄追加機能設定
  0:使用しない、1:使用する

  $add_cell = 1;

• スパム対策キー設定 NEW ...(v1.6.7)
  使用可能文字：a~z,A~Z,0~9
  設定文字数なし
  任意の文字列を設定してください
  ※スパム対策は常にONになっています。またJavaScriptがOFFだと登録・修正ができませんのでご注意ください。

  $inner_key = 'aW4oH6fD';

• 入室用パスワード設定 NEW ...(v1.6.7)
  半角英数文字
  空欄にすると入室パスワード制限はOFFになり、今までのバージョンと同じように動作します。
  他のサイトで配付されている入室制限用CGIを使用されている方はOFFにしてください。

  $enter_pass = '0123';

• cookie保存日数設定（入室パスワードが設定されている場合に有効） NEW ...(v1.6.7)
  入室を何度も行なわずに済ませるためのもので、各メンバーの名前やパスワードを記録するものではありません。
  一度入室パスワードを入力し、入室するとcookieが保存され、cookieが保存されている間、入室パスワードの入力は不要になる。
  0にすると、入室しブラウザを終了させない限り有効。ブラウザ終了時にcookieが消える。

  $cookie_save_date = 0;

以下で日付、項目欄追加の入力項目数を設定します。以下の注意を守って設定してください。
※あまり数を多く設定するとサーバーやブラウザに負荷がかかってしまうので必要最低限で設定してください。
※入力項目自体が多いと、とくにブラウザ側で処理スピードの低下が見られます。（ブラウザによる）
$add_cell_num = 15、$select_num = 40とした場合、Mac版Firefox2で確実にブラウザ側で処理スピードの低下が見られたが、それ以外のブラウザではあまり変わらない。(サーバー側の処理もそれほど気にならない)

• 入力日付数
  2列で表示しているので偶数で設定してください。
  奇数を入れた場合は、2で割った時の整数値が適用されます。

  $date_number = 14;

• 項目欄追加セレクトメニュー数

  $add_cell_num = 2;

• 項目欄追加セレクトメニューに表示する選択項目数
  2列で表示しているので偶数で設定してください。
  奇数を入れた場合は、2で割った時の整数値が適用されます。

  $select_num = 8;

• 項目欄追加1行入力数
  2列で表示しているので偶数で設定してください。
  奇数を入れた場合は、2で割った時の整数値が適用されます。

  $add_ipt_num = 2;

• 表改行不可設定数
  イベント画面で表の横幅が伸びた時に、表内が自動改行されないようにする。
  イベント画面で表示される日付数と追加項目タイトル数の合計が以下の設定値を越えた場合、自動改行されなくなる。

  $nowrap = 18;

以下v1.6.0以降のみ

• 簡易BBS機能使用設定
  0:使用しない、1:使用する

  $use_bbs = 1;

• 簡易BBSのタイトル<

  $bbs_name = 'イベントBBS';

• イベント情報欄下部に表示されるBBSへのリンク用コメント

  $bbs_comment = 'イベントBBSへ';

• BBSデータの場所

  $bbsdata = "./data/bbsdata.txt";

• 投稿キーの設定（日本語、英数字）
  英字の大文字小文字も区別されます。文字数制限なし。

  $entry_key = '4mJ8';

• 投稿キー画像表示設定
  個別にメンバーに投稿キーを連絡する場合など、「表示しない」を設定などして活用してください。
  0:表示しない、1:表示する

  $show_key_image = 1;

• 投稿キー入力部下に表示するコメント
  ここに投稿キーのヒントなどを記載して、投稿キー画像は「表示しない」に設定する使い方もできます。
  例：
  $comment_entry_keyに「みんなが卒業した高校名を漢字で入力してください」を設定
  $entry_keyに高校名を設定、$show_key_imageを0に設定

  $comment_entry_key = '右の投稿キーを入力して下さい';

• 投稿キー画像の場所とサイズ
  添付されている画像はサンプルですので、画像は各自用意しサーバーにアップしてください。
  投稿キー画像表示設定で「表示しない」にした場合、設定不要

  $entry_key_image = './sample-key.gif';
  $ek_image_width = '50px';
  $ek_image_height = '23px';

• 1ページに表示する投稿数。新しい投稿から順に表示します。
  ※JavaScriptで表示する数をコントロールしていますので、ここで表示数を設定しても、JavaScriptがOFFの人にはすべて表示されます。
  0：無制限に表示、0以外:指定した数分だけ表示

  $show_max = 10;

項目欄追加機能設定の動作 ...重要

日付、追加項目数の変更について

ファイルの設置

以上の設定が終了したら、各ファイルを所定のディレクトリにアップし、以下のとおりにパーミッションを設定して下さい。
サーバーによっては推奨値が違う場合がありますので、その場合はサーバー側の推奨値を優先してください。
特に接続プロバイダーがユーザーに提供しているホームページサービスには制限が多いです。

CGIへのリンク

各ファイルについて

• evtdata.txt、schdata.txt、bbsdata.txtは上記の設定さえしっかりしていれば、ファイル名や設置場所を変更しても問題ありません。
• またjcode.plの設置場所についてもschedule.cgi39行目付近の「require "./jcode.pl";」で設置場所さえ修正しておけば問題ありません。
• evtdata.txt、schdata.txt、bbsdata.txtを誤って削除してしまった場合は、内容に何も入力せずテキストエディタで作成してください。

バージョンアップに際して

v1.6.6 → v1.6.7 NEW ...(v1.6.7)

schedule.cgiを入れ替えて下さい。
schedule.cgiを運用中でもデータはそのまま使用できます。

v1.5.5 or v1.6.5→v1.6.6

schedule.cgi、style.cssを入れ替えて下さい。
schedule.cgiを運用中にバージョンアップする場合は、データファイルの以下の部分を修正してください。

evtdata.txt

schdata.txt

bbsdata.txt

v1.5.4 or 1.6.4→v1.5.5 or v1.6.5

schedule.cgiのみのアップロードでOKです。

v1.5.3 or 1.6.2→v1.5.4 or v1.6.4

schedule.cgi, style.cssを入れ替えて下さい。
evtdata.txtは新機能導入に合わせデータ区切り文字等を変えていますので、新しいイベントを設定するタイミングなどでバージョンアップすることをお勧めします。
どうしても現在のイベントからバージョンアップしたい方は、以下を参照にデータ修正してください。

schdata.txt, bbsdata.txt

evtdata.txt

schedule.cgiの制作環境およびデバッグ方法

schedule.cgiの制作環境

schedule.cgiのデバッグ方法

• コマンドラインから「perl -wc schedule.cgi」でチェック。
• Kawa.net xpにて配付されている、KCatch.pmにてデバッグ。常にこのモジュールを通して制作していたので、非常に重宝しました。（問題あるCGIを動かすとすぐにエラー内容と発生行数を表示してくれるので）