movabletype.jp
検索

MTAssets block tag

ブログのアイテム一覧のためのブロックタグです。モディファイアを指定することで、特定の条件にあてはまるアイテムだけを抜き出すことや、日付順で指定した数のアイテムを一覧することができます。

使い方

<MTIf name="main_index">
    <MTIfNonZero tag="AssetCount">
        <MTAssets type="image" lastn="10">
            <MTAssetsHeader>
        <div class="widget-assets widget">
            <h3 class="widget-header">Photos</h3>
            <div class="widget-content">
                <ul class="widget-list"></MTAssetsHeader>
                <li class="item"><a class="asset-image" href="<$MTAssetURL$>"><img src="<$MTAssetThumbnailURL height="70"$>" class="asset-img-thumb" alt="<$MTAssetLabel$>" title="<$MTAssetLabel$>" /></a></li>
            <MTAssetsFooter></ul>
            </div>
        </div>
            </MTAssetsFooter>
        </MTAssets>
    </MTIfNonZero>
</MTIf>

モディファイア

lastn="N"

指定した数字のアイテムを表示します。N0 より大きな数字にしてください。

offset="N"

指定した数のアイテムを除外して表示します。値に 5 を指定すると、最新5件のアイテムを除外してリスト表示します。lastn モディファイアと組み合わせて使ってください。

tag | tags="tag_foo"

指定したタグが設定されたアイテムをすべて表示します。アイテムの数を指定するときは lastn を併用してください。複数のタグを指定するときは AND か OR を使います。特定のタグ以外を指定するときは NOT を使います。また、() でくくることで、条件判断の優先順位を指定できます。

author="author_foo"

指定した筆者の記事をすべて表示します。記事数を指定するときは lastn を併用してください。

days="N"

指定した日数以内の記事をすべて表示します。days は単独で使います。他のオプションと併用すると、days が無視されます。

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 を列記 (カンマ区切り) すると、指定したブログのみを対象とします。

blog_ids="all | children | siblings | ID"
include_blogs="all | children | siblings | ID"

複数のブログを対象にできます。ブログ ID を列記 (カンマ区切り) して、対象のブログを指定します。all を指定すると、Movable Typeのすべてのブログを対象にします。childrenおよびsiblings を指定すると、そのブログが属するウェブサイト内のブログを対象にします。children はウェブサイトのコンテキストでウェブサイト内のブログを対象にし、siblings は、ブログのコンテキストで同一ウェブサイト内のブログを対象にします。ウェブサイトで include_with_website="1" を同時に指定すると、ブログに加えて所属するウェブサイトを対象にします。

include_with_website="1"

ウェブサイトのみで利用できます。include_blogsにchildren あるいは siblingsを指定したときに、include_with_website="1" を同時に指定すると、ブログに加えてウェブサイトも対象にします。

exclude_blogs="ID"

複数のブログを対象にできます。ブログ ID を列記 (カンマ区切り) すると、指定したブログ以外を対象とします。

assets_per_row="N"

MTAssetIsFirstInRow, MTAssetIsLastInRow タグを使用して、画像の一覧を作成する際に、一行に表示するアイテム数 N 件を設定します。

Updated on 2009-12-22, 11:57 .

Movable Type 関連書籍