FiscalYearlyArchivesプラグイン

年度別アーカイブを生成するためのプラグイン。MT4専用。

FiscalYearlyArchives-0.03.zip

FiscalYearlyArchives-0.10.zip (MT 4.15以降用)

本ソフトウェアは個人用・商用を問わず無償で提供されています。継続的な開発をご支援くださる方はご寄付をご考慮ください。

更新履歴

  • 0.01 (2007-08-24 19:00:32 +0900):
    • 公開。
  • 0.02 (2007-08-26 17:48:43 +0900):
    • 年度の開始月を設定できるようにしました。
  • 0.03 (2007-09-18 14:12:14 +0900):
    • バグフィックスリリース。
  • 0.10 (2008-05-21 17:25:21 +0900):
    • MT 4.15以降で動作するようにしました。
    • Author-FiscalYearly?, Category-FiscalYearly?アーカイブに対応しました。

概要

FiscalYearlyArchivesは、通常の年別・月別・週別に加えて、4月1日を開始日とする年度別アーカイブを実現するプラグインです。

Movable Type 4.0の機能を利用して実現しているため、3.xでは動作しません。

/!\ 0.10以降では、ユーザ-年度別アーカイブ、カテゴリー-年度別アーカイブも使えます。設定方法は年度別アーカイブと共通なので以下の説明を適宜読み替えてください。

使い方

プラグインをインストールするには、パッケージに含まれるFiscalYearlyArchivesディレクトリをMovable Typeのプラグインディレクトリ内にアップロードもしくはコピーしてください。正しくインストールできていれば、Movable Typeのメインメニューにプラグインが新規にリストアップされます。

プラグインをインストールしただけでは、年度別アーカイブは生成されませんし、年度別アーカイブにアクセスするために必要なアーカイブリストも生成されません。以下ではその方法を説明します。

アーカイブマッピングの設定

年度別アーカイブを生成するようにするためには、アーカイブマッピングを追加する必要があります。

具体的には以下の手順で行います。

  • 各ブログの「ダッシュボード」画面から「デザイン>テンプレート」を選択し、「ブログのテンプレート」を表示します。
  • 次に「ブログのテンプレート」画面の右側の「クイックフィルタ」から「アーカイブテンプレート」を選択します。
  • 続いて「アーカイブテンプレート」の「ブログ記事リスト」を選択して、「ブログ記事リスト」のアーカイブテンプレートの編集画面を表示します。
  • 編集画面の下方の「アーカイブマッピング」の部分で「新しいアーカイブマッピングを作成」をクリックし、「種類」に「年度別」を選択して「追加」します。
  • お疲れ様でした。アーカイブマッピングの追加はこれで終了です。

デフォルトの設定では年度別アーカイブは、

http://<hostname>/<blog directory>/fiscal/2007/index.html (2007年度)
http://<hostname>/<blog directory>/fiscal/2006/index.html (2006年度)
http://<hostname>/<blog directory>/fiscal/2005/index.html (2005年度)

という名前で生成されます。年度別アーカイブが生成される場所を変更する場合には、アーカイブマッピングの追加時に「パス」を変更することで実現できます。デフォルトのパスは、

fiscal/<$MTArchiveFiscalYear$>/%i

のように設定されており、例えば以下のように書き換えればブログのディレクトリの直下の「nendo」ディレクトリに年度別アーカイブを生成することができます。

nendo/<$MTArchiveFiscalYear$>/%i

この設定が正しく終われば、再構築時に年度別アーカイブが自動的に生成されるようになります。

年度別アーカイブリストを生成するための設定

年度別アーカイブリストは以下のようなテンプレート片で生成できます。

<MTIfArchiveTypeEnabled archive_type="FiscalYearly">
    <MTArchiveList archive_type="FiscalYearly">
        <MTArchiveListHeader>
    <div class="widget-archives widget">
        <h3 class="widget-header"><$MTArchiveLabel$> アーカイブ</h3>
        <div class="widget-content">
            <ul class="widget-list">
        </MTArchiveListHeader>
                <li class="widget-list-item"><a href="<$MTArchiveLink$>"><$MTArchiveTitle$> (<$MTArchiveCount$>)</a></li>
        <MTArchiveListFooter>
            </ul>
        </div>
    </div>
        </MTArchiveListFooter>
    </MTArchiveList>
</MTIfArchiveTypeEnabled>

要は、MTArchiveListコンテナのarchive_typeオプションをMonthlyにすれば月別、Yearlyにすれば年別、FiscalYearly?にすれば年度別アーカイブリストがそれぞれ生成されるということです。

このテンプレート片を年度別アーカイブリストを生成したいテンプレートに追加するとよいでしょう。

Adavancedな機能

年度の開始月を変更する

FiscalYearlyArchivesは、デフォルトでは4月を開始月とする年度ごとのアーカイブを生成します。バージョン0.02以降ではこの年度の開始月を変更することができます。具体的には以下の手順で変更することができます。

  • まず、ダッシュボード画面・最上段の「システムメニュー>プラグイン」を選択し、「システムプラグイン設定」画面を表示します。
  • 次にプラグイン一覧の中からFiscalYearlyArchivesを選択し、「設定」タブを開きます。
  • 「年度の開始月」を選択して「変更を保存」します。

以降は、選択した開始月の初日から翌年の開始月の前月の末日までを一つの年度とする年度別アーカイブが生成されるようになります。

テンプレートタグ

プラグインをインストールすると以下のテンプレートタグが利用可能になります。

MTArchiveFiscalYear変数タグ

現在のアーカイブの年度を返します。オプションなどはありません。アーカイブマッピングの指定用に導入されたテンプレートタグです。

TODO

  • ダイナミックパブリッシングに対応する。
  • 年度の開始を月で指定しているのを月日で指定できるようにする(おそらく不要)。

See Also

License

This code is released under the Artistic License. The terms of the Artistic License are described at http://www.perl.com/language/misc/Artistic.html.

Author & Copyright

Copyright 2007, Hirotaka Ogawa (hirotaka.ogawa at gmail.com)