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

Template Tag Referenceテンプレートタグリファレンス

MTTags

最終更新日: 2020.06.22

記事・ウェブページ・コンテンツタイプに設定されたタグを一覧表示するためのブロックタグです。

  • 使い方
<mt:Tags top="20">
<mt:If name="__first__">
<div class="widget-tag-cloud widget">
  <h3 class="widget-header">タグクラウド</h3>
  <div class="widget-content">
    <ul>
</mt:If>
      <li class="rank-<$mt:TagRank max="10"$>"><a href="javascript:void(0)" onclick="location.href='<$mt:TagSearchLink encode_js="1"$>';return false;" rel="tag"><$mt:TagName$> (<$mt:TagCount$>)</a></li>
<mt:If name="__last__">
    </ul>
  </div>
</div>
</mt:If>
</mt:Tags>

モディファイア

type="type"

どのオブジェクトのタグを参照するかを設定できます。何も指定しない場合は、entry (記事) に付けられたタグを参照します。

  • entry - 記事に付けられたタグを参照します (初期値)
  • page - ウェブページに付けられたタグを参照します。
  • asset - アイテムに付けられたタグを参照します。
  • content_type - コンテンツタイプに付けられたタグを参照します。
content_type="content_type"

コンテンツタイプの ID、ユニーク ID、コンテンツタイプ名のいずれかを指定します。type モディファイアの値に content_type を指定したうえで、特定のコンテンツタイプのタグのみ一覧表示する場合に使用します。このモディファイアを指定しない場合は、サイトに作成されているすべてのコンテンツタイプのタグが対象になります。また、type モディファイアが未指定か、type モディファイアの値が content_type 以外の値を設定した状態でこのモディファイアを指定すると再構築エラーになります。

glue="foo"

複数のタグを並べて表示するときの、区切り文字を設定します。

sort_by="name | rank"

タグを並び替える対象を指定します。rank は利用頻度(記事などのデータに設定された数)、name は名前順です。初期値は name です。

  • id (作成順に割り当てられる ID)
  • name (タグの名前)
  • rank (利用頻度)
  • count (rank と同じく利用頻度)
sort_order="ascend | descend"

並べる順序を指定します。ascend を指定すると昇順、descend は降順になります。初期値は ascend です。

limit="N"

表示させるタグの上限数を指定します。正の整数を指定できます。デフォルト値はありません。

blog_ids="all | children | siblings | ID"
include_blogs="all | children | siblings | ID"
include_with_website="1"
exclude_blogs="ID"

詳しくは、マルチブログ機能が利用できるテンプレートタグを参照してください。

top="N"

よく付けられているタグを N 件分表示します。top モディファイアの値を 20 と設定した場合、以下の設定と同じ働きをします。

<mt:Tags limit="20" sort_by="rank"></mt:Tags>
include_private="0 | 1"
プライベートタグ(@ で始まるタグ)を対象にするか指定します。"1" を指定すると対象に含めます。初期値は 0 です。

MTTags と関連のあるテンプレートタグ (10)

  • 特定のアイテムに設定されたタグの一覧のためのブロックタグです。glue モディファイアを使うと、タグの区切り文字を指定できます。

  • 特定の記事に設定されたタグ一覧のためのブロックタグです。記事作成画面の『タグ』フィールドに入力したタグを表示します。モディファイア glue を使うと、タグの区切り文字を指定できます。

  • 特定のウェブページに設定されたタグ一覧のためのブロックタグです。ウェブページ作成画面の『タグ』フィールドに入力したタグを表示します。モディファイア glue を使うと、タグの区切り文字を指定できます。

  • 特定のブログ内で、指定したタグが設定された記事・ウェブページの数を表示します。

  • 記事・ウェブページに設定したタグの ID 番号を表示します。

  • 特定のタグの名前を表示します。機能は MTTagName と同じです (エイリアス)

  • 特定のタグの名前を表示します。

  • 特定のタグの利用頻度を表示します。数値が小さい方が頻度が高くなります。このファンクションタグは、タグクラウドを表示する際に利用します。

  • 記事・ウェブページ・コンテンツタイプに設定されたタグ一覧を表示するためのブロックタグです。

  • 特定のタグが設定された記事やウェブページを検索する URL を表示します。