イベント案内モジュール


概要

イベント案内モジュールは、催し物などの案内を掲載するとともに フォームによる受付を行うためのモジュールである。 主な機能としては次のものがある。

概略手順

  1. モジュールの導入
  2. [管理メニュー - モジュール管理] にて「イベント案内」モジュールをインストールする。
    必要に応じてイベント案内の動作設定を行う。 [管理メニュー - イベント案内 - 一般設定]
  3. イベント案内の掲載
  4. イベント案内の文章を登録する。 受付フォームの指定は、後からでも変更できるので文書だけ掲載してもよい。
  5. イベント申込の受付
  6. 受付状況に付いては、メールによる通知かログインして [予約受付] で閲覧できる。

機能一覧

イベント掲載機能

  1. 一覧表示 (要約表示)
  2. ブロック表示 (タイトル一覧)
  3. 詳細表示 (申込みフォーム付き)
  4. 掲載者または管理者としてログインしていると、 機能への編集機能へのリンクが表示される。

イベント編集機能

  1. 新規イベント案内の投稿 - グループでアクセス権限を与える
  2. 受付処理
  3. 申込情報の編集
  4. 申込フォームの追加項目は、データ構造を決定するため 後から変更する場合は注意を要する。 項目名の削除や挿入、順番変更は行うと一貫性が崩れてデータが保証できない。 変更は、後への追加と選択項目 (checkbox, radio, select) の要素の追加に 制限するとデータの一貫性が崩れない。
  5. 削除
  6. イベント案内の掲載者による削除は、表示しない状態に変更することで 行われる。このため、掲載内容自体は保存されている。 データベース上からの削除は管理者権限で行い、管理者権限での削除は 受付データを始めとして全てのデータを削除する。

管理者機能

  1. 一般設定 - イベント案内の動作の設定
  2. イベント案内の操作 - 掲載の承認/削除/状態変更
  3. 新規登録のメール通知 - メール通知希望者の一覧と削除

モジュール設定

イベント案内モジュールの一般設定項目は次の通り
項目説明
イベント登録ができるグループ グループ (登録ユーザ) 新規にイベント案内の掲載を許可するグループを指定する
イベント管理者にメールで通知 いいえ/はい/常に通知 イベントが登録/変更された場合、管理者にメールで通知する。 いいえ=メール通知しない。はい=登録者以外へ通知を行う。 常に通知=登録者を含め通知を行う。
イベント管理者グループ グループ (サイト管理者) 管理通知メールを受け取るグループを指定する
新規登録イベントには承認が必要 はい/いいえ 新規登録されたイベント案内の掲載は管理者が承認してから行う
一覧で表示する追加項目数 列数 (3) 申し込み一覧で表示するフォームの追加項目の数
一覧表示の表示行数 行数 (50) 一覧形式で表示する場合の最大表示行数
トップページに掲載するイベント 個数 (10) イベント案内のトップページに並べて表示するイベントの数
複数掲載日を個別表示する はい/いいえ) 複数日指定のイベントを重複して表示を行う。「いいえ」を指定した場合、直近の日付のみ表示する
新規イベントを希望者に通知する はい/いいえ 新規のイベント案内が登録されたとき登録している通知希望者へメールで通知する
ログインによる認証に限定 はい/いいえ 申し込みをログインユーザに限定する。(申し込みにメールアドレスを使わない)
予約時の確認画面を表示 はい/いいえ 予約処理時に入力値の確認用の画面を表示する
人数指定の追加項目 指定なし 予約人数を指定を許可する場合の項目の名前を指定する

追加項目のラベル名称で指定する。「参加 人数」とするなら追加項目として、"参加人数,select,1,2,3,4" のように、必ず数値が選ばれる項目とするとよい

受付〆切時間 分数 (60==1時間) 申込受付を開始時間の何分前に予約受付を締め切るかを指定する
掲載終了時間 分数 (1440==1日) イベントの時間以降の何分後にトップページの掲載を終了するかの既定値を指定する
予約人数の初期値 人数 (10) イベントを作成するフォームの申し込み人数の既定値を指定する
日付表示の形式 (Y-m-d (D)) イベントの開催日(時)を表示する形式を PHP の date 関数形式で指定する
他のモジュールと内部連係する はい/いいえ イベントの申込制御に、他のモジュールからの介入を行うプ ラグインを有効にする

plugins ディレクトリに対応モジュール名と、 同じ名前 (xxxx.php) のファイルを置きハンドラ関数を定義す る。予約フォーム、予約動作前にハンドラを呼び出すので予約 に必要な条件の検査などを行う。

予約状況の分類マーク
0,[終]
50,
100,[混]
101,[満]
予約量に応じて表示するマークを %で指定する。 (xx,yy で xx%未満なら yy を表示、ただし 0,yy は受付終了時のマークを指定)

マークに画像などを指定する場合は HTML タグを使う

時間枠指定 指定なし 定員一括画面で使う時間枠を指定する。例: 08:00,14:00,16:00
予約のファイルで出力項目 項目並び (*) フィールド名または、フィールド番号をカンマ区切りで並べて指定する。"*" は残りを表す。例: 3,4,0,2,*
イベント案内にコメントできる はい/いいえ イベント案内に対するコメント機能を有効にする

以下XOOPS の標準のコメント機能に対する設定

フォームの追加項目

予約処理 における追加項目は、申込時のフォームで入力する 項目を指定できる。指定の書式は次通り。
行 ::= ["!"]項目名["*"][,タイプ[,引数...]]

タイプ ::= {text|checkbox|radio|textarea|select|hidden}
引数 ::= [値 ["+"] "="] ラベル

例:

表記フォーム形態
名前*名前*
名前*,size=5名前*
名前*,size=10,規定値,#コメント文名前* コメント文
選択,radio,項目1+,項目2,項目3選択 項目1   項目2   項目3  
選択,checkbox,項目1+,項目2,項目3選択 項目1   項目2   項目3  
選択,select,項目1,項目2,項目3選択
ラベル,hidden,値(フォームには表示されません - 入力値として現れる)
#コメント文コメント文

複数掲載日の取扱い

イベント案内 2.0 から、同一イベント内容に対して、複数の時間 枠を指定することが可能になった。この設定には、登録フォームの 「繰り返し開催」で掲載期間の間で開催する間隔を指定する。

終了日時を細かく指定したり、休催日がある場合、一度プレビュー を行うと個別に指定を変更できる。

さらに細かな指定を行いたい場合、一度イベントを登録し「開 催日の編集」画面で設定を行う。

複数掲載日指定に関する注意事項

変更履歴

2007/03/03 イベント案内モジュール 2.3 リリース
2007/03/03 通知に投稿者自身を含める設定を追加
2007/02/09 掲載イベントに変更があった場合に管理者と担当者に通知する
2007/01/22 管理者グループへの予約メールを管理者メール設定を従うように修正
2006/12/29 登録者へのメール通知での障害を修正
2006/11/30 イベント案内モジュール 2.24 リリース
2006/11/30 PHP5/MySQL5で生じる不具合の修正 (mylist.php の不具合など)
2006/11/20 checkbox/radio の複雑な値で生じる障害の修正
2006/11/14 tchinese リソースの改定 (thanks jax)
2006/11/02 追加項目で checkbox/radio の値が設定された場合、項目間の空白を抑制する
2006/10/24 イベント案内モジュール 2.23 リリース
2006/10/24 言語リソース (japanese/german/tchinese) 月名の間違いを修正
2006/10/14 イベント案内モジュール 2.21 リリース
2006/10/14 言語リソースの小修正
2006/10/14 中国語 (tchinese) リソースの追加 (twpug.net の jimmy9522 による)
2006/09/30 イベントの集計 CSV 出力のユーザ名の誤りを修正
2006/08/29 イベント案内モジュール 2.2 リリース
2006/08/29 CSV 形式で出力されるユーザ名を単純な形式にする
2006/08/29 ブロックにカテゴリ絞り込みを追加
2006/08/24 イベント案内ブロックに予約状況マークを追加表示
2006/08/24 新着ブロックには直近の複数日開催も表示する
2006/08/22 テンプレート: 予約受付がないとき「予約はこちら」を出さない
2006/08/22 ドイツ語のリソース追加 (Jens Havelberg 氏より)
2006/08/17 イベント案内モジュール 2.1 リリース
2006/08/16 申し込み後のリダイレクト先指定を追加
2006/08/16 追加項目のエスケープ処理を改善とprop= 属性の拡張 (Craig Taylorより)
2006/08/14 テンプレート: 予約受付がない場合の〆切時間を表示しない
2006/08/13 イベント案内モジュール 2.01 リリース
2006/08/13 ログインユーザのキャンセルに失敗する障害を修正
2006/08/03 イベント案内モジュール 2.0 リリース

2.0以前の変更履歴

安富 伸浩 <nobuhiro.yasutomi@nifty.ne.jp>
マイサイト ユーザーズ http://mysite.ddo.jp/
$Id: help.html,v 1.42 2007/03/03 14:01:38 nobu Exp $