Movable Type CMSプラットフォーム Movable Type
ドキュメントサイト

Blogブログ

グローバル・モディファイアを使いこなそう

グローバル・モディファイアとは

Movable Type には「グローバル・モディファイア」という仕組みがあります。グローバル・モディファイアとは、MTタグと合わせて記述を行うことで、MTタグの出力結果を様々な形で加工・修正する仕組みのことです。

「モディファイア」という言葉が耳慣れない方もいると思いますが、これは英語の「modifier」から付けられています。「modifier」という言葉には「修正するもの、修飾語句」という意味があります。

今回は、使いこなすとMovable Type が便利になるグローバル・モディファイアをいくつかピックアップしてご紹介していきます。

文字列の置換を行える [replace]

[replace] は、MTタグの出力結果から、任意の文字列を別な文字列に置換するグローバル・モディファイアです。実際の使用例をご紹介しましょう。

サンプルシナリオ:

最新記事5件のタイトルを表示する際に、「Movable Type」という文字を「MT」という文字に変える

元のコード:

      <ul>
        <MTEntries limit="5">
          <li><$MTEntryTitle$></li>
        </MTEntries>
      </ul>      

元の出力結果例:

      ・MT チーム、沖縄に上陸します!
      ・Movable Type for AWS バージョン 6.0.4-0 がリリースされました
      ・Movable Type 6.0.4 の提供を開始します
      ・Movable Type のSEO対策を強化する
      ・HVM インスタンスに対応した Movable Type for AWS (HVM) をリリースしました      

上記の出力結果を、[replace] モディファイアをつかって修正します。

修正後のコード:

      <ul>
        <MTEntries limit="5">
          <li><$MTEntryTitle replace="Movable Type","MT"$></li>
        </MTEntries>
      </ul>      

修正後の出力結果例:

      ・MT チーム、沖縄に上陸します!
      ・MT for AWS バージョン 6.0.4-0 がリリースされました
      ・MT 6.0.4 の提供を開始します
      ・MT のSEO対策を強化する
      ・HVM インスタンスに対応した MT for AWS (HVM) をリリースしました      

このように、[replace] を使って、文字列を変換した結果が出力できました。

同じ文字列置換型のグローバル・モディファイアとして、[regex_replace] というモディファイアもあります。[regex_replace] を利用すると、正規表現を使った文字列の置換が可能です。

出力結果が空のときに指定値を出力する [_default]

[_default] は、MTタグの評価結果が空だった場合、[_default] で指定した値を出力するグローバル・モディファイアです。これも、例を見てみましょう。

サンプルシナリオ:

最新記事5件のタイトルを表示する。タイトルが存在しない記事には 「タイトル無し」 という文字を表示する

元のコード:

      <ul>
        <MTEntries limit="5">
          <li><$MTEntryTitle$></li>
        </MTEntries>
      </ul>      

元の出力結果例:

      ・MT チーム、沖縄に上陸します!
      ・
      ・Movable Type 6.0.4 の提供を開始します
      ・
      ・HVM インスタンスに対応した Movable Type for AWS (HVM) をリリースしました      

修正したコード:

      <ul>
        <MTEntries limit="5">
          <li><$<MTEntryTitle _default="タイトル無し"$></li>
        </MTEntries>
      </ul>      

修正後の出力結果例:

      ・MT チーム、沖縄に上陸します!
      ・タイトル無し
      ・Movable Type 6.0.4 の提供を開始します
      ・タイトル無し
      ・HVM インスタンスに対応した Movable Type for AWS (HVM) をリリースしました      

元の記事では空欄だった箇所に、「タイトル無し」の文字が出力されていることが分かります。

文字数を数える [count_characters]、htmlタグを除去する [remove_html]

[count_characters] は、そのMTタグの結果に含まれる文字数を計算するグローバルモディファイアです。引数に[1]を設定して使います。[remove_html] は、MTタグに含まれるhtmlタグを除去するモディファイアで、引数に[1]を設定して使います。

このモディファイアを使い、少し複雑なロジックを作ってみましょう。

サンプルシナリオ:

記事の本文、続きに含まれる文字数から、htmlタグを含まない「文字数」を計算して、変数「total_count」に代入する。

変数「total_count」の値を調べ、300文字未満の場合は「この記事を読むのにかかる時間 1分以内」、300文字以上の場合は「1分以上」と表示を行う。

以下が実際のコードになります。

      <MTSetVars>
      body_count=<$MTEntryBody remove_html="1" count_characters="1"$>
      more_count=<$MTEntryMore remove_html="1" count_characters="1"$>
      </MTSetVars>

      <MTSetVar name="total_count" value="$body_count">
      <MTSetVar name="total_count" value="$more_count" op="+">
      <MTVar name="total_count">
      <MTIf name="$total_count" lt="300">
      この記事を読むのにかかる時間:1分以内
      <MTElse>
      この記事を読むのにかかる時間:1分以上
      </MTIf>      

まず、記事の [本文] から、htmlタグを除去した純粋な文字数を変数 [body_count] に、同じく [続き] から、htmlタグを除去した純粋な文字数を変数 [more_count] に代入します。

その後、変数 [total_count] に、[body_count]、[more_count] の順番に数値を加算していきます。

最後に、[total_count] の文字数の値で条件分岐します。300文字未満の場合は「この記事を読むのにかかる時間:1分以内」、300文字以上の場合は「この記事を読むのにかかる時間:1分以上」と表示を行います。

「body_count」,「more_count」の値は、ブロックタグ <MTSetrVars> でまとめて指定しています。<MTSetVars>の使い方については、以下の記事を参照ください。

いろいろなグローバル・モディファイアと開発方法

今回ご紹介した以外にも、さまざまなグローバル・モディファイアが存在します。詳しくは、以下のドキュメントをご覧ください。

また、プラグイン開発を行うことで、新しいグローバル・モディファイアを追加することもできます。グローバル・モディファイアの開発方法については、以下のドキュメントをご覧ください。

  • このエントリーをはてなブックマークに追加