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

Counter プラグイン

Movable Type のエントリーリストやコメントリスト、あるいはアーカイブリスト等で、例えば「リストの 3 番目からスタイルを変更したい」とか「偶数・奇数で色を変更したい」ということがあると思いますが、Movable Type で用意されているタグには残念ながらそのような機能はありません。*1

この「カウントする」という機能が必要な質問をひとつ頂いており、思案していたところ、有難いことにエムロジック株式会社様より下記のプラグインが公開されました。

エムロジック放課後プロジェクト：MovableType用Counter Plugin

これを使えば、リストでカウンタを必要とするカスタマイズ類はほぼ全て満足できるのではないかと思います。

2009.05.28 追記
Movable Type 4.1 以降であれば、標準テンプレートタグで実現できます（関連記事「Movable Type 4.1 / MTOS における変数での算術演算子の利用方法」）。

配布サイトのドキュメントで利用方法が説明されていますが、ここでもタグの基本的な設定方法とサンプルをいくつか紹介しておきます。ドキュメントに掲載されている、エントリータイトルだけを表示するというシンプルなリストを例にアレンジしていきます。
プラグインの導入方法は配布サイトをご覧ください。

基本は、カウントしたいリスト全体を MTCounter タグで括ります。

リスト1.1　MTCounter タグ

<MTCounter>
  <MTEntries> 
    <$MTEntryTitle$><br />
  </MTEntries> 
</MTCounter>

このプラグインは自律的にカウントアップする訳ではないので、リスト1.2 のように、カウンタ値を +1 更新したい場所に MTCounterPlus タグを挿入します。なおこのリストではまだ何も表示されません。

リスト1.2　MTCounterPlus タグ

<MTCounter>
  <MTEntries> 
    <$MTCounterPlus$>
    <$MTEntryTitle$><br />
  </MTEntries> 
</MTCounter>

カウンタ値を -1 更新したい場合は MTCounterMinus タグを挿入します。この場合は初期値を MTCounterSetValue タグで設定すると良いでしょう。
リスト1.3 はカウンタの初期値10でエントリータイトルを表示する毎にカウンタを -1 します（これもまだ何も表示されません）。

リスト1.3　MTCounterMinus / MTCounterSetValue タグ

<MTCounter>
  <$MTCounterSetValue value="10"$>
  <MTEntries> 
    <$MTCounterMinus$>
    <$MTEntryTitle$><br />
  </MTEntries> 
</MTCounter>

カウンタ値を表示する場合は MTCounterValue タグを用います。MTCounterSetValue タグを使わない場合のカウンタ初期値は 0 です。
リスト1.4 はエントリータイトルの後にカウンタ値を表示します。

リスト1.4　MTCounterValue タグ

<MTCounter>
  <MTEntries> 
    <$MTCounterPlus$>
    <$MTEntryTitle$>[<$MTCounterValue$>]<br />
  </MTEntries> 
</MTCounter>

リスト1.4 を実行（再構築）すると、MTCounterValue の部分に "1,2,3,4,5 ..." と表示されます。MTCounterValue の後方に MTCounterPlus が置かれていれば、"0,1,2,3,4 ..." と表示されます。

現在のカウンタ値と比較する場合は、MTCounterIfEqual タグで判定します。このタグに記述した value 属性の値とカウンタ値を比較します。
リスト1.5 は5番目のリスト表示の後に hr 要素を挿入します。

リスト1.5　MTCounterIfEqual タグ

<MTCounter>
  <MTEntries> 
    <$MTCounterPlus$>
    <$MTEntryTitle$><br />
    <MTCounterIfEqual value="5"><hr /></MTCounterIfEqual>
  </MTEntries> 
</MTCounter>

さらにカウンタ値との大小を比較する場合は MTCounterIfLess タグおよび MTCounterIfMore タグを用います。
リスト1.6 は、1-4番目のリスト、5番目のリスト、5番目以降のリストに、それぞれ異なる class 属性を与えています（分かりやすくするために span 要素全体を括っていますが class 属性あるいは class 属性値部分のみを括るという方法もあります）。

リスト1.6　MTCounterIfLess / MTCounterIfMore タグ

<MTCounter>
  <MTEntries>
    <$MTCounterPlus$>
    <MTCounterIfLess value="5"><span class="a"></MTCounterIfLess>
    <MTCounterIfEqual value="5"><span class="b"></MTCounterIfEqual>
    <MTCounterIfMore value="5"><span class="c"></MTCounterIfMore>
    <$MTEntryTitle$></span><br />
  </MTEntries>
</MTCounter>

カウンタ値の偶数・奇数によって表示を変える方法、および カウンタを n で割った余りが value 属性値と等しい時に表示する場合は、MTCounterIfOdd / MTCounterIfEven / MTCounterIfMod タグを利用します。サンプルは Counter プラグイン ドキュメントを参照してください。

---

*1：これに近い機能として、MTEntries タグの lastn 属性と offset 属性の組み合わせによる実現があります。