アイテム管理機能で追加された Movable Type テンプレートタグ
Movable Type 4 ではこれまで FTP ソフトなどでサーバにアクセスして削除などを行っていたファイルやフォルダの管理も、管理画面からおこなうことができるようになりました。こうしてほとんどのデータが Movable Type 4 上で管理できるようになり、先日ご紹介したバックアップ機能を利用して、環境 (データベースやサーバ) の移行などが簡単におこなえるようになりました。
今回はその新しく加わったアイテム管理機能に関する Movable Type テンプレートタグを実際の出力例等と合わせてご紹介します。Movable Type テンプレートタグの出力結果には、以下の画像をアップロードした場合のデータを利用します。
<MTAssets></MTAssets>
ブログのアイテム一覧のためのブロックタグです。アトリビュート (属性) を指定することで、特定のアイテムを抜き出すことや、並べ替えなどが行えます。ブロックタグ <MTENtries></MTENtries> が、ブログ記事の一覧を表示するのと同じような役割を持っています
- type="file_type"
-
- image
- file
指定した形式のファイルタイプに属するアイテムのみを出力
- file_ext="file_ext"
-
- jpg
- png
- mp3
- doc
- e.t.c....
指定した拡張子を持つアイテムのみを出力
- lastn="n"
-
指定した数字 n のアイテムを表示します。n は 0 より大きな数字になります
- days="n"
-
指定した n 日数以内に追加されたアイテムをすべて表示します。days は単独で使います。他のアトリビュートと併用すると、days が無視されます
- author="author name"
-
指定したファイル追加ユーザー author name のアイテムをすべて表示します。表示するアイテム数を指定するときは lastn を併用します
- offset="n"
-
指定した n 個のアイテムを除外して表示します。値に 5 を指定すると、最新 5 件のアイテムを除外してリスト表示します。lastn アトリビュートと組み合わせて使います
- sort_by="sort_type"
-
- file_name
- created_by
- created_on
アイテムを並び替える対象を指定します。file_name (名前), created_by (追加ユーザー), created_on (追加日) が指定できます
- sort_order="sort_order_type"
-
- ascend
- descend
アイテムを並べる順序を指定します。ascend を指定すると昇順、descend は降順になります。
<MTAsset></MTAsset>
id アトリビュート (属性) を指定し、特定の ID 番号のアイテムを出力する為のブロックタグ。
- id="id"
-
指定した id 番号を持つアイテムを出力
<MTAssetTags></MTAssetTags>
アイテムに設定したタグを表示するためのブロックタグ。<MTEntryTags></MTEntryTags>と同じように以下のファンクションタグが利用できます
- <$MTTagName$>
- <$MTTagLabel$>
- <$MTTagID$>
- <$MTTagCount$>
- <$MTTagRank$>
- <$MTTagSearchLink$>
<$MTAssetID$>
アイテムの ID 番号を表示するファンクションタグ
3
<$MTAssetFileName$>
アップロードしたアイテムの名前を表示するファンクションタグ
boots.jpg
<$MTAssetURL$>
アップロードしたアイテムの URL を表示するファンクションタグ
http://localhost/mt4/my-third-blog/images/boots.jpg
<$MTAssetType$>
アイテムの種類を表示するファンクションタグ
画像
<$MTAssetMimeType$>
アイテムの MIME Type を表示するファンクションタグ
image/jpeg
<$MTAssetFilePath$>
アイテムまでの相対パスを表示するファンクションタグ
/Library/WebServer/Documents/mt4/my-third-blog/images/boots.jpg
<$MTAssetDateAdded$>
アイテムを Movable Type 4 でアップロードした日時を表示するファンクションタグ
2007年7月 6日 17:17
- format="format"
-
指定した format で日付を出力します。例えば format="%Y-%m-%dT%H:%M:%S" とした場合のサンプルは以下のようになります
2007-07-06T17:17:55
- language="language"
-
日付の形式を指定した language のもので出力します。例えば language="en" (英語) とした場合のサンプルは以下のようになります
July 6, 2007 5:17 PM
<$MTAssetAddedBy$>
Melody
アイテムをアップロード (追加) したユーザー名を表示するファンクションタグ
<$MTAssetProperty$>
アイテムの詳細データを表示するファンクションタグ。property アトリビュート (属性) に表示したいデータを設定します
- property="file_size"
-
アイテムのサイズを表示する。format アトリビュートと合わせて、表示形式を選択できます。format を指定しない場合は KB 形式で表示します
240.7 KB
- format="0"
-
単位の無いバイト数をそのまま表示する
246453
- format="1"
-
KB でアイテムのサイズを表示する
240.7 KB
- format="k"
-
キロバイト形式でファイルのサイズを数値のみ表示する
240.7
- format="m"
-
メガバイト形式でアイテムのサイズを数値のみ表示する
0.2
- property="image_width"
-
横幅を表示する (アイテムの種類が画像の場合)
500
- property="image_height"
-
高さを表示する (アイテムの種類が画像の場合)
332
- property="label"
-
アップロード時に設定したアイテムのラベルを表示する
ながぐつにお花
- property="description"
-
アップロード時に設定したアイテムの概要を表示する
長靴の中からお花が!木のまわりを囲んでとってもキャワウィイィです。
<$MTAssetFileExt$>
アイテムの拡張子を表示するファンクションタグ
jpg
<$MTAssetThumbnailURL$>
アイテムの種類が画像の場合、サムネイルの URL を表示する
http://localhost/mt4/my-third-blog/assets_c/17.b983083188bc05bb753163d31fe33de7a32f3692.jpg
<$MTAssetLink$>
アイテムのオリジナルファイルへのリンクを表示するファンクションタグ
<a href="http://localhost/mt4/my-third-blog/images/boots.jpg">boots.jpg</a>
<$MTAssetThumbnailLink$>
アイテムの種類が画像の場合、オリジナルファイルへのリンク付きのサムネイルを表示する XHTML タグを表示するファンクションタグ
<a href="http://localhost/mt4/my-third-blog/images/boots.jpg"><img src="http://localhost/mt4/my-third-blog/assets_c/17.b983083188bc05bb753163d31fe33de7a32f3692.jpg" width="500" height="332"></a>
- width="value"
-
画像のサムネイルの幅を value で出力する。width アトリビュート (属性) のみ指定の場合、高さは比率を保ち自動算出されます (以下は width="150" と指定したサンプル)
<a href="http://localhost/mt4/my-third-blog/images/boots.jpg"><img src="http://localhost/mt4/my-third-blog/assets_c/17.62a6e7e04c74969fdefd18b6e19cf50e71101d02.jpg" width="150" height="99"></a>
- height="value"
-
画像のサムネイルの高さを value で出力する。height アトリビュート (属性) のみ指定の場合、幅は比率を保ち自動算出されます (以下は height="50" と指定したサンプル)
<a href="http://localhost/mt4/my-third-blog/images/boots.jpg"><img src="http://localhost/mt4/my-third-blog/assets_c/17.f3919cb1e62fab6bf2ff88ac996c35c48058333e.jpg" width="75" height="50"></a>
- scale="scale"
-
画像のサムネイルを実際サイズの scale % 縮小して出力します (以下は scale="50" と指定したサンプル)
<a href="http://localhost/mt4/my-third-blog/images/boots.jpg"><img src="http://localhost/mt4/my-third-blog/assets_c/17.04a61a0bd17bb3d85491cc83d4114c4b5deebd93.jpg" width="250" height="166"></a>
今回ご紹介した Movable Type 4 の新機能、アイテム管理機能で追加されたテンプレートタグで、Movable Type 4 で管理しているアイテムを表示したり、情報を出力できるようになりました。次回は、管理しているアイテムをうまく表示するために追加されたテンプレートタグを、簡単な画像ギャラリーのサンプルを元にご紹介したいと思います。
- 前の記事: ブログ記事の書き方もお好みで
- 次の記事: Movable Type Hack-a-thon が開催されます