movabletype.jp
検索

MTSubCategories BLOCK

現在のカテゴリの子カテゴリを階層化して一覧表示するためのブロックタグです。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 のメソッド名を使って並び替えます。

glue="foo"

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

Updated on 2016-11-28, 11:56 .
MTDDC MEETUP TOKYO 2016

Movable Type 関連書籍