Not a developer? Go to MovableType.com

Documentation

Assets

A container tag which iterates (loops) over a list of Assets from one or more blogs.

<mt:Assets>
    <mt:AssetLabel>: <mt:AssetDescription>
</mt:Assets>

This container tag may contain any Asset function template tags.

Similarly, the EntryAssets and PageAssets tags will list all assets with the respective entry or page.

Modifiers


assets_per_row

This attribute sets how many iterations the Assets tag publishes before setting the state that enables the AssetIsLastInRow AssetIsFirstInRow tags.

</mt:AssetIsLastInRow>

Supported values:

  • intergers less than or equal to “100”
  • auto - which selects the most aesthetically pleasing number of items per row based on the total number of assets. For example, if you had 18 total assets, three rows of six would publish, but for 16 assets, four rows of four would publish.

author

Selects assets uploaded by a single author.

Specify author’s username.

<mt:Assets author="beau">
    <!-- tags here -->
</mt:Assets>

days

Selects assets created in the last number of days specified.

<mt:Assets days="3">
    <!-- tags here -->
</mt:Assets>

file_ext

Selects assets by file extension.

Supports a comma-delimited list of file extensions.

<mt:Assets file_ext="gif, mp3, pdf">
    <!-- tags here -->
</mt:Assets>

type

Selects assets by asset type.

<mt:Assets file_ext="image">
    <!-- tags here -->
</mt:Assets>

Supports a comma-delimited list of asset types:

  • image
  • audio
  • video
  • file (new in MT5)

lastn

Limits the selection of assets to the specified number.

<mt:Assets lastn="3">
    <!-- tags here -->
</mt:Assets>

limit

A positive integer to limit results.

<mt:Assets limit="3">
    <!-- tags here -->
</mt:Assets>

namespace

Used in conjunction with the sort_by attribute when sorting by “score”. The namespace identifies the method of scoring to use in sorting assets.

offset

Used in coordination with lastn, starts N assets from the start of the list. N is a positive integer.

<mt:Assets lastn="1">
    <!-- special treatment for first asset -->
</mt:Assets>
<mt:Assets lastn="9" offset="1">
    <!-- alternate treatment for next 9 assets -->
</mt:Assets>

sort_by

Sort assets by value.

<mt:Assets sort_by="label">
    <!-- asset tags -->
</mt:Assets>

Supported values:

  • blog_id
  • created_by
  • created_on
  • description
  • file_ext
  • file_name
  • file_path
  • id
  • label
  • mime_type
  • parent
  • score
  • url

sort_order

Supported values:

  • ascend
  • descend

tag

Selects assets with particular tags.

Supports expressions such as “interesting AND featured”).

<mt:Assets tag="foo AND bar">
    <!-- tags here -->
</mt:Assets>

ignore_archive_context

If the ignore_archive_context modifier is set to 1, assets are loaded without regard for the current archive in context. This modifier was added to Movable Type 6.0.4.

Examples

This container tag loop lists all assets in the current blog that have the favorite tag.

<mt:Assets lastn="10" type="image" tag="favorite">
   <a href="<mt:AssetURL>">
      <img src="<mt:AssetThumbnailURL height="70">"
           alt="<mt:AssetLabel escape="html">"
           title="<mt:AssetLabel escape="html">" />
   </a>
</mt:Assets>

This container tag loop lists all assets associated with a Movable Type 5.x or 6.x website or any one of the blogs that is owned by that website.

<mt:Assets include_blogs="children" include_with_website="1">
 <mt:AssetLabel>: <mt:AssetFilePath><br />
</mt:Assets>
Back

Leave a Comment