MTAssets
ブログのアイテム一覧のためのブロックタグです。モディファイアを指定することで、特定の条件にあてはまるアイテムだけを抜き出すことや、日付順で指定した数のアイテムを一覧することができます。
- 使い方
<mt:If name="main_index">
<mt:IfNonZero tag="AssetCount">
<mt:Assets type="image" lastn="10">
<mt:AssetsHeader>
<div class="widget-assets widget">
<h3 class="widget-header">Photos</h3>
<div class="widget-content">
<ul class="widget-list">
</mt:AssetsHeader>
<li class="item"><a class="asset-image" href="<$mt:AssetURL$>"><img src="<$mt:AssetThumbnailURL height="70"$>" class="asset-img-thumb" alt="<$mt:AssetLabel$>" title="<$mt:AssetLabel$>" /></a></li>
<mt:AssetsFooter>
</ul>
</div>
</div>
</mt:AssetsFooter>
</mt:Assets>
</mt:IfNonZero>
</mt:If>
モディファイア
- lastn="N"
-
指定した数のアイテムを表示します。N は 0 より大きな数値にしてください。
- offset="N"
-
指定した数のアイテムを除外して表示します。値に 5 を指定すると、最新 5 件のアイテムを除外してリスト表示します。lastn モディファイアと組み合わせて使ってください。詳しくは、lastn モディファイアと limit モディファイアの違いを参照してください。
- limit="N"
-
sort_by モディファイアでフィルタリングされたアイテムを、指定数表示します。詳しくは、lastn モディファイアと limit モディファイアの違いを参照してください。
- tag | tags="tag_foo"
-
指定したタグが設定されたアイテムをすべて表示します。アイテムの数を指定するときは lastn モディファイアを併用してください。複数のタグを指定するときは AND か OR を使います。特定のタグ以外を指定するときは NOT を使います。また、() でくくることで、条件判断の優先順位を指定できます。
- author="author_foo"
-
指定したユーザーがアップロードしたアイテムをすべて表示します。アイテム数を指定するときは lastn モディファイアを併用してください。
- days="N"
-
指定した日数以内にアップロードされたアイテムをすべて表示します。
- type="image | audio | video | file"
-
表示したいアイテムをアイテムの種類で絞り込むことができます。表示したいアイテムが image でも audio でも video でもない場合は、file という値を設定します。
- file_ext="extension_foo"
-
表示したいアイテムを拡張子で絞り込むことができます。
- sort_order="ascend | descend"
-
並べる順序を指定します。ascend を指定すると昇順、descend は降順になります。
- sort_by="file_name | created_by | created_on"
-
アイテムを並び替える対象を指定します。
- file_name (アイテムのファイル名)
- created_by (追加したユーザー)
- created_on (追加日)
- blog_ids="all | ID"
-
複数のブログを対象にできます。all の場合は、すべてのブログを対象とします。また、ブログ ID を列記 (カンマ区切り) すると、指定したブログのみを対象とします。
- namespace="foo"
-
スコアでソート (
sort_by="score") するとき、どのスコア名前空間を使用するかを設定します。 - blog_ids="all | children | siblings | ID"
- include_blogs="all | children | siblings | ID"
- include_with_website="1"
- include_websites="1"
- exclude_blogs="ID"
- exclude_websites="1"
-
対象のブログ、ウェブサイトを指定します。詳しくは、マルチブログ機能が利用できるテンプレートタグを参照してください。
- assets_per_row="N"
-
MTAssetIsFirstInRow, MTAssetIsLastInRow タグを使用して、画像の一覧を作成する際に、一行に表示するアイテム数 N 件を設定します。
- ignore_archive_context="0 | 1"
ignore_archive_context モディファイアに "1" を指定すると、現在のアーカイブの影響を受けずに、データをロードさせることができます。初期値は 0 です。
このモディファイアは、Movable Type 6.0.4 で追加されました。
