ブログ記事が属するカテゴリをツリー形式で出力するプラグイン(その1)

Movable Typeでは、ブログ記事が属するカテゴリを出力するブロックタグとして、MTEntryCategoriesがあります。
ただ、このタグはカテゴリの階層構造に関係なく、ブログ記事が属するカテゴリを単純に順に出力するだけです。

そこで、MTSubCategoriesタグのように、カテゴリの階層関係を考慮した上で、ブログ記事が属するカテゴリを出力するプラグインを作りました。
今日は、基本的な使い方を解説します。

1.このプラグインでできること

このプラグインは、ブログ記事が属するカテゴリを、MTSubCategoriesタグでのカテゴリ表示と同様に、カテゴリの階層を考慮して表示することができます。

例えば、ブログに以下のようなカテゴリがあるとします。

  • 地域
    • 東京
    • 神奈川
    • 埼玉
    • 千葉
  • 部屋のタイプ
    • シングル
    • ダブル
    • ツイン
  • 設備
    • 無線LAN
    • 大浴場

また、あるブログ記事が、上記の「東京」「シングル」「ダブル」のカテゴリに属しているとします。
このときに、このプラグインを使うと、以下のような出力を得ることができます。

  • 地域
    • 東京
  • 部屋のタイプ
    • シングル
    • ダブル

また、ブログ記事が属するカテゴリの中で、特定のカテゴリから下の階層のカテゴリだけを、階層を考慮して出力することができます。
例えば、ブログ記事が属するカテゴリの中で、「部屋のタイプ」のカテゴリから下の階層のカテゴリだけを取り出して、以下のように出力することができます。

  • シングル
  • ダブル

また、特定のカテゴリから下の階層のカテゴリを出力する場合、その「特定のカテゴリ」も含めて出力することもできます。
例えば、ブログ記事が属するカテゴリの中で、「部屋のタイプ」のカテゴリと、その下の階層のカテゴリを取り出して、以下のように出力することができます。

  • 部屋のタイプ
    • シングル
    • ダブル

3.プラグインのインストール

プラグインは以下からダウンロードします。

Movable Type 5.0x用(EntrySubCategories_1_00.zip)
Movable Type 5.1x用(EntrySubCategories_1_10.zip)

プラグインの継続的な開発やサポートのために、プラグインをご利用された方は、ドネーション(寄付)を行っていただけると幸いです。
ドネーションの方法は、こちらのページをご参照ください。

また、このプラグインの他にも、いくつかのプラグインを配布しています。
配布中のプラグインは、Movable Type Plugin Directoryのページをご参照ください。

Movable Typeのプラグイン開発等のドキュメント「Movable Type Developer's Guide Volume 1」も販売しています。
ご自分でプラグインを作ってみたい方に、ぜひお勧めしたい一冊です。
詳細は特設ページをご覧ください。

ダウンロードしたファイルを解凍すると、「EntrySubCategories」というフォルダができます。
このフォルダを、Movable Typeの「plugins」ディレクトリにアップロードします。

4.テンプレートタグの書き方の例

ブログ記事が属するすべてのカテゴリを、階層を考慮して出力するには、以下のようにタグを組みます。

<mt:EntryTopLevelCategories>
  <mt:SubCatIsFirst><ul></mt:SubCatIsFirst>
    <li><$mt:CategoryLabel$>
    <$mt:EntrySubCatsRecurse$>
    </li>
  <mt:SubCatIsLast></ul></mt:SubCatIsLast>
</mt:EntryTopLevelCategories>

ブログ記事が属するカテゴリのうち、特定のカテゴリから下の階層のカテゴリだけを出力するには、上記の<mt:EntryTopLevelCategories>タグを以下のよう変えます。

<mt:EntrySubCategories category="カテゴリ名">

例えば、「部屋のタイプ」カテゴリから下の階層のカテゴリだけを出力したい場合は、<mt:EntryTopLevelCategories>タグを以下のように変えます。

<mt:EntrySubCategories category="部屋のタイプ">

また、特定のカテゴリも含めて、その下の階層のカテゴリを出力するには、<mt:EntryTopLevelCategories>タグを以下のよう変えます。

<mt:EntrySubCategories category="カテゴリ名" include_current="1">

例えば、「部屋のタイプ」カテゴリとその下の階層のカテゴリだけを出力したい場合は、<mt:EntryTopLevelCategories>タグを以下のように変えます。

<mt:EntrySubCategories category="部屋のタイプ" include_current="1">

さらに、拙作のSortCatFldプラグインまたはSuperSortプラグインをインストールしている場合、設定した並び順に沿ってカテゴリを出力することができます。
その場合、MTEntryTopLevelCategories/MTEntrySubCategoriesタグを、それぞれMTEntrySortedTopLevelCategories/MTEntrySortedSubCategoriesに書き換えます。

MT Cloud Starter Kit
Movable Typeのプラグイン集「MT Cloud Starter Kit」をぜひご利用ください