小粋空間  -  a cheap joke and a play on words site

Flash カレンダープラグイン for Serene Bach

Serene Bach で、Kinarie&May さんが配布されている Movable Type 用の Flash カレンダー（通常版／横型）を使えるようにするためのプラグインです。

注：このプラグインは 2.0x までの対応です。フラッシュカレンダー 3.00 をご利用の場合は「Flash カレンダープラグイン（3.00 対応版） for Serene Bach」をご覧ください。

１．プラグインのダウンロード

下記のリンク先にある FlashCalendarHandler.zip または FlashCalendarHandler.lzh をクリックして、プラグインのアーカイブをダウンロードしてください。

FlashCalendarHandler.zip / FlashCalendarHandler.lzh

2006.09.14 Ver 1.00
2006.09.21 Ver 1.01 EUC-JP版対応
2006.09.26 Ver 1.02 文字コード変換を sb::Language 使用に変更
2006.09.28 Ver 1.03 calendar.xml に相対パス指定

２．プラグインのアップロード

ダウンロードしたアーカイブを解凍し、中にある FlashCalendarHandler.pm を plugins ディレクトリ直下に、resource/ja/flashcalendarhandler.txt を、同じディレクトリの構成があると思いますので、flashcalendarhandler.txt のみを ja 配下にアップロードしてください。

アップロードの後、Serene Bach の管理画面を起動し、「環境設定」→「プラグイン」をクリックし、プラグイン一覧に FlashCalendarHandler.pm が表示されていることを確認し、一番右のチェックボックスをチェックして右下の「利用する」をクリックしてください。

３．テンプレートの設定

３．１ フラッシュカレンダー表示用 object タグの作成

Kinarie&May さんのサイトにある「MT用通常版flashカレンダー」または「MT用横型flashカレンダー」のページを参考に、フラッシュカレンダー表示用 object タグを作成します。そして作成した object タグを、HTMLテンプレートのカレンダーを表示したい部分に貼り付けてください。

1. swf ファイルのダウンロード（解説ページの１項）
2. swf ファイルのアップロード（解説ページの２項）
3. Object タグの作成（解説ページの３項）

3.の「Object タグの作成」で、「XMLファイルアドレス」を入力する項目があります。このアドレスには index.html までのURL（例：http://user-domain/）と

http://user-domain/calendar.xml

と、青色で示したファイル名 calendar.xml を加えた内容を入力してください。

また、その下のラジオボタンは「通常使用」を選択してください。デザイン・カラーはお好みに合わせて修正してください。

３．２ フラッシュカレンダー用XML出力の独自ブロック

下記の独自ブロック（青色）をベースHTMLテンプレートの任意の位置に貼り付けてください。例は </body> の直前に設定した場合です。
注：個別記事用HTMLテンプレートを利用されている場合も、ベースHTMLテンプレートのみに設定してください。

<!-- BEGIN flash_calendar -->
<!-- END flash_calendar -->
 
</body>
</html>

これは、３．１項で設定した calendar.xml を出力するためのタグです。calendar.xml は swf ファイルが読み込む XML ファイルです。ページ上には何も表示されません。

４．ページの再構築

タグを貼り付けた後、インデックス（または全体）のページ再構築を行います。ブログに Flash カレンダーが表示されればOKです。スタイルは適宜設定してください。

表示されない場合、index.html があるディレクトリに calendar.xml というファイルが作成されていることを確認してください。ファイルの有無で下記のいずれかの原因が考えられます。

• 作成されている場合：３．１項の「3.Object タグの作成」で設定内容に誤りがある可能性があります。
• 作成されていない場合：プラグインの設定または独自ブロックの設定に誤りがある可能性があります。

calendar.xml が生成されていれば、Object タグで swf ファイルおよび calendar.xml を読み込む動作はブログの動作と関係ありませんので、簡素な HTMLページ を作り、そこに Object タグを貼り付けて Flash が表示されるかどうか確認してみてください。

５．swf ファイルのキャッシュについて

エントリー投稿や再構築によって calendar.xml が更新されることは確認済ですが、ブラウザを更新してもカレンダー表示が更新されない場合があります。この原因は、calendar.xml を取得する swf ファイル自体がキャッシュから取得されてしまうようです。
これは利用しているレンタルサーバやブラウザの設定に依存するようです。

毎回最新の情報を取得するのであれば「ブラウザのキャッシュをクリアする」を参考にしてみてください。

６．参考：動作の仕組み

Flashカレンダーは、記事タイトル一覧と投稿日が記述された XML を Flash が読み込む元データとしてカレンダーを表示します。
Movable Type ではカレンダー表示用のタグとユーザが作成できるテンプレートを利用すればXMLを簡単に出力できますが、Serene Bach にはユーザがテンプレートやXMLファイルを出力する機能がないためプラグインで実現しました。

2006.12.20 追記
「独自タグ」は誤記でしたので、「独自ブロック」に修正しました。

2007.04.10 追記
２項の flashcalendarhandler.txt というファイル名が誤ってましたので修正しました。また 3.00 版へのリンクを追加しました。