繰返し登録・削除機能、週表示機能を含んだ
カレンダー(squirrelmail-1.4.0付属SQCalendar)のPostgreSQL-DB化

概要(feature)

• squirrelmail-1.4.0付属SQCalendarがベース
• 週表示
• 繰返し登録(イベント重複チェック付)
• 繰返し削除(同一タイトルで検索)
• 編集時のイベント重複チェック
• グローバルカレンダー(いわゆる祝祭日)設定・表示

未チェック・未対応

• GET・POSTデータの妥当性チェック
• 特殊文字をHTMLエンティティに変換する部分(htmlspecialchars(),nl2br()など)
• 国際化(現行テスト版は、日本語EUC直接表示です)

追加したいなと考えている機能

• リマインダー(reminder)
• アラーム(リフレッシュと連動)
  
• カレンダーデータの検索
• 過去イベントのダウンロードと削除
• 繰返し編集
  
• カレンダーコンフィグレーション(管理者セットアップの簡便化)
• カレンダーオプション設定(ユーザ自身によるカレンダープロパティ変更)

テスト版プラグインパッケージ

SQcalendar-1.4.0-pjpdb-sawa-20030505.tar.gz

すべてsquirrelmail-1.4.0付属SQCalendarを上書き
機能	モジュール名・ファイル名	内容
SQ_SetUp	plugins/calendar/setup.php	プラグインセットアップ
関数群	plugins/calendar/functions.php	カレンダー用関数群
RDB I/F	plugins/calendar/calendar_data.php	DBハンドリングモジュール(重要)
表示 本体	plugins/calendar/calendar.php	月表示
	plugins/calendar/week.php	週表示
	plugins/calendar/day.php	日表示
イベント 新規登録	plugins/calendar/event_create.php	新規イベント作成制御本体
	plugins/calendar/event_create_event_form.php	新規イベント登録用フォーム
	plugins/calendar/event_create_confirm.php	新規イベント登録確認
	plugins/calendar/event_create_save_result.php	新規イベントDB保存
イベント 削除	plugins/calendar/event_delete.php	イベント削除制御本体
	plugins/calendar/event_delete_event_form.php	イベント削除用フォーム
	plugins/calendar/event_delete_confirm.php	イベント削除確認
	plugins/calendar/event_delete_delete_result.php	イベントDB削除
イベント 修正	plugins/calendar/event_edit.php	イベント修正制御本体
SQL関連	plugins/calendar/sq_scheduler.sql	PostgreSQL用
	plugins/calendar/holyday_update.php	2003年と2004年の グローバルカレンダー(祝祭日)一括登録 (PHP-CLI版で動作)
Docs	plugins/calendar/README	準備中
	plugins/calendar/INSTALL	準備中(このドキュメントで代用)
画像	plugins/calendar/risu*.png	画像

Postgresの準備(DBの作成・ユーザの作成)

• DB-backendで、解説・作成したDB(squirrelmail)内に カレンダー用テーブルを作成します。

カレンダー(SQCalendar)用テーブル定義SQLの読み込み

パッケージ内のSQL( plugins/calendar/sq_scheduler.sql)ファイルから、テーブルを作成


# su - postgres $ psql -U squirreluser squirrelmail < sq_scheduler.sql $ psql -U squirreluser squirrelmail squirrelmail=# \dt List of relations Schema | Name | Type | Owner --------+-------------+-------+-------------- public | address | table | squirreluser public | notes | table | squirreluser public | sq_scheduler| table | squirreluser public | userprefs | table | squirreluser

DBハンドリングモジュール( plugins/calendar/calendar_data.php)を編集

• 45〜47行目のDSNとtable名を設定したPostgreSQLのユーザ名、パスワード DB名、サーバホスト名、テーブル名にしてください。 グローバルカレンダー用ユーザ(global)を設定してください。
• 設定例(DB-backendで解説したもの)

  $sqcalender_dsn = 'pgsql://squirreluser:sqpassword@localhost/squirrelmail' ; $sqcalender_table = 'sq_scheduler' ; $sq_global_calendar_user = 'global' ;

グローバルカレンダー(いわゆる祝祭日データ)の登録

• ユーザー名 global で登録します。
• 2003年と2004年のデータが用意されています。
• PHP-CLIで一括登録します。PHPのデフォルトPATHは /usr/local/bin/php
• 設定例

  cd plugins/calendar ./holyday_update.php # あるいは、 /usr/local/bin/php holyday_update.php

SquirrelMailの Plugins-configure で calendar を有効にする

• ./configure で、8. Plugins を設定する。

  $ ./configure SquirrelMail Configuration : Read: config.php (1.4.0) --------------------------------------------------------- Main Menu -- .............................. 8. Plugins 9. Database .............................. C. Turn color on S Save data Q Quit Command >> 8 SquirrelMail Configuration : Read: config.php (1.4.0) --------------------------------------------------------- Plugins Installed Plugins 1. calendar 2. filters 3. notes Command >> s

使ってみる

• データ・ベースにカレンダーで作られたデータが、格納されます。
• これにより、data/*.calのテキストファイルは使われなくなります。

DBメンテナンス

• 定期的(cronなどで)に、DBバックアップ(pgdump)、 DBの不要領域の回収と解析(vacuumdb)をしておくと良いでしょう。