Multi Schedule Board 設置方法

本CGIはイベント日程調整用CGI「Schedule Board」をベースにイベントを複数登録できるようにしたものです。
Multi Schedule Boardへ移行したい方はその他：Schedule Boardからのデータ移行についてを参照してください。
「Schedule Board」とではデータ削除の処理が違う部分がありますので、以下の表を参考にしてください。
詳しい機能については使用マニュアルを参照ください。

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

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

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

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

ファイルの構成

  public_html (ホームディレクトリ)
      |
      +-- schedule /   mulsche.cgi   [705]
            |          jcode.pl      [604] 
            |          style.css
            |          title.gif
            |          sample-key.gif 
            +-- data / evtdata.txt   [606]

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

本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 = 'Multi Schedule Board';

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

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

文字化けする文字一覧

ファイルの修正

mulsche.cgiをエディタ開き、赤字の個所を修正します。

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

  #!/usr/local/bin/perl

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

  $cgi_title = 'Multi Schedule Board';

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

  $title_img = './title.gif';

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

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

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

  $style = "./style.css";

• データファイル格納ディレクトリ
  evtdata.txtとスケジュールデータファイルを格納するディレクトリ

  $filedir = "./data";

• イベントデータ（イベントタイトル、イベント情報、日にち設定データなどを保存するファイル）の場所
  赤字の部分だけ変更してください。
  $filedirは上のデータファイルディレクトリで設定した変数

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

• メンバーのスケジュールデータファイルの名前
  この名前の後にイベント番号が付加され、ファイルが作成される
  例：$schdata = "sch" → sch-evt1.txt,sch-evt2.txt・・・

  $schname = "sch";

• cgiの場所

  $cgi_url = "./mulsche.cgi";

• ホームページ

  $home = "http://";

• 管理者用パスワード

  $admin_pass = '0123';

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

  $place_title = '場所';

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

  $date_hide = 1;

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

  $aft_fix = 0;

• 新規イベント作成時のイベント番号のナンバリング最大数
  設定した数までは無条件に+1でナンバリングしていき、それを越えると空いた番号をイベント番号として使用
  設定値を大きくすることで、メンバーがイベント後しばらく経って削除されたイベントのURLにアクセスした時、
  その削除したイベント番号を使った新しいイベントが表示されるのをある程度防ぎます。
  0：無限に番号をナンバリング
  設定した数までに空き番号がない場合は、今まで作成したイベントの最大番号+1を使用します。

  $max_evt = 20;

• ここで指定した値分だけイベント設定画面のイベント情報部分を抜き出して、イベントリスト画面に表示します。
  半角英数字一文字で1文字、日本語一文字で2文字分、改行は6文字分、1行空けが12文字分

  $info_summary_number = 200;

• イベントリスト上部に表示する欄のコメント。ここは空でも構いません。
  htmlタグも使用可能です。

  $list_comment = '目的のイベントにスケジュール登録してください。
  下のイベント一覧の右側リンク、またはイベント名をクリック後表示されるイベント画面の「スケジュール登録」「スケジュール修正」から登録・修正可能です。<br /><a href="#">リンク</a>';
  

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

  $add_cell = 1;

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

  $inner_key = 'aW4oH6fD';

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

  $enter_pass = '0123';

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

  $cookie_save_date = 0;

以下で日付、項目欄追加の入力項目数を設定します。以下の注意を守って設定してください。 New ... v1.1.5
※あまり数を多く設定するとサーバーやブラウザに負荷がかかってしまうので必要最低限で設定してください。
※入力項目自体が多いと、とくにブラウザ側で処理スピードの低下が見られます。（ブラウザによる）
$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.1.0以降のみ

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

  $use_bbs = 1;

• 簡易BBSのタイトル

  $bbs_name = 'イベントBBS';

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

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

• BBSデータファイルの名前
  この名前の後にイベント番号が付加され、ファイルが作成されます
  例：$bbsdata = "bbs" → bbs-evt1.txt,bbs-evt2.txt・・・

  $bbsname = "bbs";

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

  $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へのリンク

Schedule Boardからのデータ移行について

累計イベント番号改行

イベント番号（例：evt1）<>イベントタイトル<>決定イベント日値（日付の番号に対応）(※1)<>イベント終了設定値<>イベント日決定後のスケジュール登録・修正の許可、不許可値<>イベント情報<>場所名<>場所URL<>記号1,記号2,記号3,記号4,記号5<>意味1,意味2,意味3,意味4,意味5<>(最大人数チェック)記号1用,記号2用,記号3用,記号4用,記号5用::日付値(※2)::追加項目セレクトメニュー(※3)::追加項目1行入力タイプ(※4)改行

各ファイルについて

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

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

	print "</div>\n";
	print << "EOM";
<script type="text/javascript">
//<![CDATA[
var doc = document;
var resPass = doc.getElementById("rpas");
function setValue(){
	resPass.value = "";
}
//]]>
</script>
EOM
&footer;

	print "</div>\n";
	print << "EOM";
<script type="text/javascript">
//<![CDATA[
var doc = document;
var resPass = doc.getElementById("rpas");
function setValue(){
	resPass.value = "";
}
//]]>
</script>
EOM
&footer;

my(@FILE_DATA,$evt_no,$bbs_file,$data,$sch,$name,$pass,$comment,$date,$nc);

($sec,$min,$hour,$day,$month,$year,$youbi) = localtime(time + 1*24*60*60);

5. 更新内容

• v1.1.7.3(2009/01/29)
  • イベントリスト画面からの「イベント削除」が機能しない問題を修正
• v1.1.7.2(2009/01/15)
  • BBS個別削除が機能しない問題を修正
• v1.1.7.1(2009/01/11)
  • 都合登録日、BBS投稿日が1日先の日付になる問題を修正
• v1.1.7(2008/12/07)
  • パスワードによる入室制限機能を追加
  • スパム対策機能を追加
  • データファイル読み込みエラーが発生した場合のメッセージ表示を修正
  • その他細かい部分を修正
• v1.1.6(2008/08/20)
  • CGIの設定で「イベント日決定後もイベント設定の日付や記号の変更を可能にする」を可に設定し、イベント日を決定後、イベント設定の「設定」ボタンを押すとイベント日決定データが消えイベント日が決定していない状態になる問題を修正。
  • その他細かい部分を修正
• v1.1.5(2008/08/14)
  • 日付、任意項目追加欄の入力できる数をユーザーが設定できるようにした。
  • イベント画面の表示データが多くなり横が長くなると自動改行しないよう設定できるようにした。
  • 日付、任意項目追加欄に<br />タグを入力可とし、強制改行できるようにした。
  • イベント設定の処理とデータ一括削除関連の処理を分けた。
    それに伴い、スケジュールデータ削除時にイベント内容の変更も反映可能な仕様は廃止。
    今まではデータ一括削除時にもイベント設定データをサーバーに送信していたが、入力項目が増えてきたため。
  • 日付と任意項目追加欄セレクトメニューの入力部並び順を、縦から横に変更。
    入力項目が増えた場合、画面スクロールの手間を少なくする為。
  • その他細かい部分を修正
• v1.0.4およびv1.1.4(2008/06/21)
  • 記号の設定項目欄を3個から5個に増やした。
  • イベント決定日を1日から複数設定可能にした。（登録してある全ての日付を決定日に設定可能）
  • 決定イベント日の解除方法を変更した。
  • 最大人数のカウントをすべての記号に対して可能にした。
  • 記号01、意味01を入力必須項目から外した。
  • 前バージョンで導入したスペース入力の制限に問題があったので以下のように修正。
    スケジュール登録・BBSの名前欄の頭にスペースの入力、スケジュール登録・BBSの名前欄・BBSのコメント欄にスペースのみの入力、名前の間に連続してスペースの入力を禁止した。
  • 日付を一つだけ設定した時点でイベント決定日としていた仕様を廃止。
  • イベント設定画面に「イベントデータ削除」を追加し、イベント枠（番号）は残しておき、データのみクリアする機能を追加。
    以下の「名前、パスワード以外のスケジュールデータを削除」を使う場合に便利。
  • イベント設定画面に「名前、パスワード以外のスケジュールデータを削除」を追加し、登録されているメンバーの名前・パスワード以外をクリアする機能を追加。同じメンバーで新しいイベントを作成する時新しくメンバーにスケジュールを登録してもらう手間を省略。
  • 日付を一つも設定していない時、スケジュール登録画面で表示が崩れていた問題を修正。
  • イベント番号のナンバリング方法を若干変更。
  • イベントリストの表示順を新しいイベント順に変更。
    また登録したイベント順でも表示可能とした。
  • v1.0.xの末尾をBBSなしバージョンに合わせv1.1.4とした。
  • その他細かい部分を修正
  • BBSなしバージョン（v1.0.x）のバージョンアップは今回で最後とする。
    BBSありバージョンでもBBS機能を使用しない設定にすることで同様の表示ができるし、ファイルサイズの差は12KBくらいなのでBBSありだけでもOKと判断した。
• v1.0.3およびv1.1.1(2008/03/20)
  • 管理者による任意項目欄追加機能を追加
  • スケジュール登録の名前とBBSの名前およびコメント部(v1.1.0以降のみ)に、半角・全角スペースのみ、または半角・全角スペースを連続しての入力は不可とした。
  • その他細かい部分を修正
  • v1.0.3とv1.1.1の差はBBS機能の有無(ファイルサイズの差は約10KB)
• v1.1.0(2008/01/26)
  • 簡易BBS機能追加
  • イベント日が決定している場合、それを知らせるコメントを表示
  • Windows Firefox、Netscapeでフォーム内に入力部のフォントが小さいのを修正
  • イベント設定でスケジュールデータを削除にチェックを入れていると、他の項目を変更しても反映されなかったのを、スケジュールデータまたはBBSデータを削除にチェックを入れている場合に限り、他の変更項目を反映させるようにした。
  • その他細かい部分を修正
• v1.0.2(2007/09/03)
  • 第3者によってイベント設定内容などを書き換えられてしまう可能性がある不具合を修正
• v1.0.1(2007/08/19)
  • スケジュール修正で、ごく稀に自分以外のデータを開いてしまう問題を修正
  • スケジュール登録で、すでに名前に使用している文字のうち一文字使い名前を登録しようとすると、「既に名前が使用されている」とのメッセージが出る問題を修正
  • イベント設定、スケジュール登録の入力必須項目に「0(ゼロ)」のみを入力すると、未入力と扱われ、エラーが表示される問題を修正
    その他入力項目で「0(ゼロ)」を入力すると、その項目が何も表示されない問題を修正
  • イベント終了設定時、イベント設定画面内イベント情報欄の内容が改行等されず表示される問題を修正
  • その他スクリプトの記述を若干修正
• v1.0(2007/08/15)
  • 公開開始

ページトップへ戻る