PowerCMS™

MTTags

MTTags

タグ一覧を表示するためのブロックタグです。

使い方

<ul>
    <MTTags top="20">
    <li class="rank-<$MTTagRank max="10"$>">
        <a href="<$MTTagSearchLink$>"><$MTTagName$></a>
    </li>
    </MTTags>
</ul>

モディファイア

type="type"

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

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

複数のタグを並べて表示するときの、区切り文字を設定します。区切り文字には ' (シングル・クォーテーション) や " (ダブル・クォーテーション) は使えません。

sort_by="name | rank"

記事を並び替える対象を指定します。rank は使用頻度、name は名前順です。初期値は name です。

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

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

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 と設定した場合、以下の設定と同じ働きをします。

<MTTags limit="20" sort_by="rank"></MTTags>