使い方の概要

　以下のテンプレートの例のように、ランダムに項目を抽出したい範囲を MTRandomize ブロックタグで囲みます。続いて、個々の項目を MTRandomizeSeparator タグで区切ります。MTRandomize ブロックタグは、MTRandomizeSeparator で区切られた項目をランダムに選択し、lastn で指定された数だけ表示します。

<ul><MTRandomize lastn="3">
  <li>Item 1</li>
<$MTRandomizeSeparator$>
  <li>Item 2</li>
<$MTRandomizeSeparator$>
  <li>Item 3</li>
<$MTRandomizeSeparator$>
  <li>Item 4</li>
  <li>Item 5</li>
<$MTRandomizeSeparator$>
  <li>Item 6</li>
<$MTRandomizeSeparator$>
</MTRandomize></ul>

　項目の区切りは MTRandomizeSeparator タグで明示されればよいので、ブログ記事やウェブページ、コメント、トラックバックなどの MT によって自動生成されるものを始め、手動で列挙したアイテムまで、あらゆる要素を表示することが可能です。

静的生成

　静的生成(スタティック)で利用した場合、項目がランダムに選択されるのは、再構築のタイミングでテンプレートタグが処理された時になります。それ以降、そのテンプレートタグが再び再構築されない限りは、同じ内容が表示され続けます。使用シーンとしては、検索結果テンプレートなどで使用する方法です^*1。

静的生成＋PHP

　静的生成(スタティック)で PHP のコードが含まれるページを生成します。ページが表示される度に PHP が動作し、項目をランダムに表示します。Randomize プラグインでは、php オプションを指定するだけで、ランダム表示を行うための PHP コードを生成します。

<ul><MTRandomize lastn="3" php="1">
　　　：
</MTRandomize></ul>

ダイナミック パブリッシング

　Randomize プラグインは、MT 標準のダイナミック パブリッシングにも対応しています。静的生成＋PHP と同様に、表示される度に異なる項目がランダムに選択され表示されます。

追加されるテンプレート タグ

MTRandomize ブロックタグ

　ブロックタグの内部のコンテンツから lastn で指定された数だけランダムに項目を選択し、それらを表示します。lastn に 0 を指定すると、全てのアイテムがシャッフルされて表示されます。

MTRandomizeSeparator 変数タグ

　MTRandomize ブロックタグの内部で使用し、アイテムの区切り箇所を宣言します。MTRandomizeSeparator　で分割された結果、空白、タブ、改行のみを含むブロックはランダム表示の候補からは外されます。

テンプレートの記述の例

　最新のブログ記事 10 件の中から、ランダムに 5 件のブログ記事を表示する例です。

<ul><MTRandomize lastn="5">
  <MTEntries lastn="10">
    <li><$MTEntryTitle$></li>
    <$MTRandomizeSeparator$>
  </MTEntries>
</MTRandomize></ul>

　任意の広告を表示する例です。

<MTRandomize lastn="1">
    <!-- 広告１ -->
    <$MTRandomizeSeparator$>
    <!-- 広告２ -->
    <$MTRandomizeSeparator$>
    <!-- 広告３ -->
    ：
</MTRandomize>

ダウンロード

• 開発版(master) ... バグ修正や機能追加など開発途中のバージョンです。開発中の新機能などをいち早く利用できますが、新しいバグが生まれていたり、テストが不十分な場合があります。
  • pirolix/mt-plugin-Randomize
  • ソースコード
• マニュアル/ドキュメント
• 不具合/要望/作業チケットの一覧
• 更新履歴

インストール

　ダウンロードしたアーカイブを展開し、plugins フォルダの下にコピーしてください。プラグインの設定項目などはありません。

いろいろ

• MovableType 4, MovableType 5 で動作確認済みです
• ライセンスは　LGPL とします