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

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

MTSubCategories

最終更新日: 2017.10.04

現在のカテゴリの子カテゴリを階層化して一覧表示するためのブロックタグです。MTSubCatsRecurse ファンクションタグと組み合わせることで子孫カテゴリを表示します。

  • 使い方
<mt:TopLevelCategories>
<div class="archive">
    <h2 class="primary-category"><$mt:CategoryLabel$></h2>
    <mt:SubCategories>
        <mt:if tag="CategoryCount">
    <h3 class="archive-header"><a href="<$mt:CategoryArchiveLink$>"><$mt:CategoryLabel$></a></h3>
    <div class="archive-content">
        <mt:ArchiveList archive_type="Category-Monthly" sort_order="descend">
            <mt:ArchiveListHeader>
        <ul>
            </mt:ArchiveListHeader>
            <li><a href="<$mt:ArchiveLink$>"><$mt:ArchiveDate format="%B %Y"$> (<$mt:ArchiveCount$>)</a></li>
            <mt:ArchiveListFooter>
        </ul>
            </mt:ArchiveListFooter>
        </mt:ArchiveList>
    </div>
        </mt:if>
    </mt:SubCategories>
</div>
</mt:TopLevelCategories>

モディファイア

include_current="0 | 1"

値に 1 を指定すると、現在のカテゴリを含めて表示します。初期値は 0 です。

top="0 | 1"

値に 1 を指定すると、最上位のトップレベルカテゴリの一覧を表示します。MTTopLevelCategories ブロックタグと同様の挙動となります。初期値は 0 です。

category="category_foo"

特定のカテゴリの子カテゴリを表示したいときに使用します。

<mt:SubCategories category="Italian">
  <$mt:CategoryLabel$>
</mt:SubCategories>

同じ名前のカテゴリが別の階層にある場合は、親カテゴリ/子カテゴリと記述して、異なるカテゴリを指定します。

<mt:SubCategories category="Restaurants/Italian">
  <$mt:CategoryLabel$>
</mt:SubCategories>
<mt:SubCategories category="Recipes/Italian">
  <$mt:CategoryLabel$>
</mt:SubCategories>

カテゴリ名のなかに / が含まれる場合は、[] で囲みます。

<mt:SubCategories category="Restaurants/[Indian/Pakistani]">
  <$mt:CategoryLabel$>
</mt:SubCategories>
sort_by="user_custom"

Movable Type 5.1 で追加されました。管理画面で並び替えた順番でカテゴリの一覧を出力します。初期値は user_custom です。user_custom 以外にも、次の値を指定することができます。この場合、管理画面で設定した並び順を無視し、指定した値で並び替えます。

  • label : 「カテゴリ名」
  • description : 「説明」
  • basename : 「出力ファイル/フォルダ名」
  • created_on : 「作成日」
  • modified_on : 「更新日」
  • user_custom : 管理画面の並びかえ順(初期値)
sort_order="ascend | descend"

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

<mt:SubCategories sort_by="label" sort_order="descend">
  <$mt:CategoryLabel$>
</mt:SubCategories>

このブロックタグ内で、MTCategoryPrevious タグ、および MTCategoryNext タグを利用した場合は、sort_by モディファイアで指定した順番で、前と次のカテゴリを表示します。

sort_method="sub_foo"

Perl のメソッド名を使って並び替えます。

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

  • このタグは現在、非推奨です。MTCategoryLabel タグを使用してください。

    カテゴリ名を表示します。

    このタグは MTCategoryLabel ファンクションタグと同じ働きをします。

  • ブログの総カテゴリ数を表示します。複数のブログを運用しているとき、下記のモディファイアを指定すると、複数のブログに登録されているカテゴリの数を表示します。

  • カテゴリの一覧を表示するためのブロックタグです。このタグは、メインカテゴリもサブカテゴリも区別せずに表示します。階層的に表示したいときは、MTSubCategories タグを利用します。

  • カテゴリアーカイブの URL を表示します。

  • カテゴリの編集画面の『出力ファイル/フォルダ名』に設定された値(ベースネーム)を表示します。

  • 特定のカテゴリに含まれる記事に投稿されたコメントの総数を表示します。

  • カテゴリに含まれる記事の件数を表示します。未公開の記事は含みません。

  • カテゴリの編集画面に追加されたカスタムフィールドの『説明』を表示するファンクションタグです。

    このタグは MTCategoryCustomFields タグのコンテキストで使用します。

  • カテゴリの編集画面に追加されたカスタムフィールドの『名前』を表示するファンクションタグです。

    このタグは MTCategoryCustomFields タグのコンテキストで使用します。

  • カテゴリに関するカスタムフィールドの情報を表示するためのブロックタグです。カテゴリの編集画面に追加されたすべてのカスタムフィールドの情報を表示します。

    include モディファイアを使用すると、名前を指定したカスタムフィールドのみを対象にできます。exclude モディファイアに名前を指定したカスタムフィールドは対象から除外されます。

    特定のカスタムフィールドだけを表示したいときは、個別のテンプレートタグを使用してください。

  • カテゴリの編集画面に追加されたフィールドの値を表示するファンクションタグです。

    このタグは MTCategoryCustomFields タグのコンテキストで使用します。

  • カテゴリの編集画面で入力した『説明』を表示します。

  • カテゴリの ID 番号を表示します。

  • カテゴリへのトラックバックを受け付ける設定のときに実行する条件タグです。

  • カテゴリ名を表示します。

  • 現在のカテゴリの次のカテゴリの内容を表示するためのブロックタグです。このタグの中の MTCategoryLabel タグは、次のカテゴリのタイトルを表示します。

  • 現在のカテゴリの前のカテゴリの内容を表示するためのブロックタグです。このタグの中の MTCategoryLabel は、前のカテゴリのタイトルを表示します。

  • カテゴリで受け付けたトラックバックの数を表示します。

  • カテゴリについてトラックバックを受け付ける設定になっているとき、そのカテゴリへのトラックバック URL を表示します。このタグは、カテゴリアーカイブか MTCategories タグの中で利用できます。また、モディファイア category を指定すると、どこでも利用できます。

  • 記事を一覧するためのブロックタグです。MTEntries ブロックタグで include_subcategories="1" を指定した場合と同じ動作になります。

    MTEntries ブロックタグでカテゴリを指定した場合、そのカテゴリに属する記事のみが対象になるのに対し、このタグでカテゴリを指定した場合は、指定したカテゴリとすべての子カテゴリに属する記事が対象になります。

  • 記事に指定したカテゴリの一覧のためのブロックタグです。この一覧には、メインカテゴリは含みません。また、このブロックタグの中では <$MTCategory...$> タグを利用できます。モディファイア glue を使うと、カテゴリの区切り文字を指定できます。

  • 記事に指定したカテゴリの一覧のためのブロックタグです。この一覧にはメインカテゴリも含みます。また、このブロックタグの中では <$MTCategory...$> ファンクションタグを利用できます。glue モディファイアを使うと、カテゴリの区切り文字を指定できます。

  • 記事に指定したメインカテゴリを表示します。

  • プライマリカテゴリ(メインカテゴリ)の情報を取得するためのブロックタグです。MTEntryCategories タグに type="primary" を指定した場合と同じ働きをします。

  • 現在のカテゴリに親カテゴリが存在しないときだけ実行する条件タグです。

  • 現在のカテゴリに子カテゴリが存在しないときだけ実行する条件タグです。

  • 現在のカテゴリに親カテゴリが存在しているときだけ実行する条件タグです。

  • 現在のカテゴリにサブカテゴリが存在しているときだけ実行する条件タグです。

  • コンテキスト内に指定されたカテゴリが含まれる、または、対象となる記事が指定されたカテゴリに属している場合に実行する条件タグです。

  • child モディファイアで指定したカテゴリが、現在のカテゴリの子(子孫)カテゴリにあたる場合に実行する条件タグです。

  • parent モディファイアで指定したカテゴリが、現在のカテゴリの親(祖先)カテゴリにあたる場合に実行する条件タグです。

  • 最上位のカテゴリから現在のカテゴリまでを繰り返して表示するブロックタグです。

    glue モディファイアにより、カテゴリをつなげる文字を指定できます。また、exclude_current モディファイアを指定することで、現在のカテゴリを除外できます。

  • 現在のカテゴリの親カテゴリを表示します。

  • 現在のカテゴリの子カテゴリを階層化して一覧表示するためのブロックタグです。MTSubCatsRecurse ファンクションタグと組み合わせることで子孫カテゴリを表示します。

  • 最上位のトップレベルカテゴリから現在のカテゴリまでのディレクトリパスを表示します。パスは各カテゴリの『出力ファイル/フォルダ名』(ベースネーム)をもとに生成されます。例えば、foo というカテゴリに bar という子カテゴリがある場合は foo/bar と表示します。

  • カテゴリ一覧を出力するループの中で最初のときだけ実行する条件タグです。サブカテゴリを含む一覧を <ul> タグで階層化するときなどに、MTSubCatIsLast タグと組み合わせて利用します。

  • カテゴリ一覧を出力するループの中で最後のときだけ実行する条件タグです。サブカテゴリを含む一覧を <ul> タグで階層化するときなどに、MTSubCatIsFirst タグと組み合わせて利用します。

  • 現在のカテゴリに属するカテゴリの MTSubCategories ブロックを再帰的に表示します。max_depth モディファイアで再帰的に表示する深さを指定できます。max_depth="1" と指定すると、現在のカテゴリの直下の子カテゴリまでを表示します。

  • 現在のカテゴリに関わりなく、最上位のカテゴリを一覧するためのブロックタグです。

    <mt:SubCategories top="1"> と記述することと同じ動作になります。

    詳しくは MTSubCategories タグを参照してください。

  • 現在のカテゴリの最上位カテゴリを表示するブロックタグです。