説明

現在のブログコンテキストに属する記事またはウェブページを出力するブロックタグです。

既定値

<MTEntries> は、ブログごとの「最近のブログ記事の表示設定」の内容に依存して出力を変えます。ただし、<MTEntries offset="10"> のように、（既定で lastn が設定されることを考慮して、）offset だけを指定することはできません。

日付アーカイブ/カテゴリーアーカイブ内では、それぞれの条件にあった記事のすべてを出力します。

<MTEntries limit="NN">
は、
<MTEntries limit="NN" sort_by="created_on" sort_order="descend">
を指定したのと同じです。
これはつまり、
<MTEntries lastn="NN">
と同じです。

<MTEntries sort_by="COLUMN">
は、
<MTEntries sort_by="COLUMN" limit="20" sort_order="descend">
と同じです。

<MTEntries sort_order="ASC_OR_DESC">
は、
<MTEntries sort_order="ASC_OR_DESC" sort_by="created_on" limit="20">
と同じです。

その他の値（およびその組み合わせ）の省略はできません。指定した場合その結果は不定です。不定とは、（エラーも含め）何が出力されるかを定義しないという意味です。

属性

いずれの属性についても、設定できる値に含まれない値を指定した場合の結果は不定です。

lastn

設定できる値 1 - 50までの整数値
既定値 10

出力する記事の件数を制御します。最新のものから過去に向かって順番に N 件の記事を出力します。lastn を指定した場合、offset 以外の属性は指定できません（指定しても結果は不定です）。日付アーカイブ/カテゴリーアーカイブ内でも動作は同じです（N 件の記事を出力）

days

設定できる値 1 - 365までの整数値
既定値 なし

出力する記事の件数を制御します。最新のものから過去に向かって順番に N 日分の記事を出力します。記事の件数に制限はありません（指定された範囲の記事をすべて出力します）。 days を指定した場合、他の属性は一切指定できません（指定しても結果は不定です）。

limit

設定できる値 1 - 50までの整数値
既定値 10

出力する記事の件数を制御します。lastn と異なり、他の属性を指定して出力範囲を絞り込んだり、並べ替えを行うことができます。
日付アーカイブ/カテゴリーアーカイブ内では limit の値は無視されます（limit と併記した offset も無視されます）。

offset

設定できる値 1 - 65535までの整数値
既定値 なし

lastn または limit（と sort_by）を指定した場合に、出力する記事の範囲を設定します。例えば lastn="10" offset="1" を指定すると、最新記事よりも1つ古いものから10件の記事を出力します。

sort_by

設定できる値 title、status、created_on、modified_on、author_id、excerptのいずれか
既定値 created_on

出力する記事の並べ替えを行うフィールドの名前を指定します。並べ替えは、limit、offset と関連して行われます。

例 sort_by="title" sort_order="ascend" limit="10" offset="10"
記事一覧を記事のタイトルの昇順で並べ替えた結果の、11件目から10件を出力します。

sort_order

設定できる値 ascend、descendのいずれか
既定値 descend

出力する記事の並べ替え順序（昇順または降順）を指定します。並べ替えは、limit、offset と関連して行われます。

例 sort_by="title" sort_order="ascend" limit="10" offset="10"
記事一覧を記事のタイトルの昇順で並べ替えた結果の、11件目から10件を出力します。

category、categories

設定できる値 コンテキスト内で有効なカテゴリーの名前
既定値 なし

出力する記事を、指定された名前のカテゴリーに含まれるものだけに制限します。limit や sort_by などと関連してフィルタリングを行います。category と categories の動作は全く同じ（別名）です。

例 category="お知らせ" limit="10" offset="10" sort_by="title" sort_order="ascend"
「お知らせ」カテゴリーに属している記事一覧を、記事のタイトルで昇順に並べ替えた結果の、11件目から10件を出力します。
AND、OR、NOT および （） を使って、複数のカテゴリーを組み合わせた複雑なフィルタリングもできます。

例 categories="(Family OR Pets) AND Featured"
Family または Pets カテゴリーと、Featured カテゴリーに含まれる (複数のカテゴリーに含まれる) 記事を出力します。

例 categories="NOT Family"
Family カテゴリ以外のカテゴリに含まれる記事 (どのカテゴリにも含まれない記事も含む) を出力します。

author

設定できる値 コンテキストに対して権限をもっている投稿者のユーザー名またはメールアドレス
既定値 なし

出力する記事を、指定されたユーザー名またはメールアドレスの投稿者が投稿したものだけに制限します。limit や sort_by などと関連してフィルタリングを行います。

例 author="Lekumo ビジネスブログ @example.com" limit="10" offset="10" sort_by="title" sort_order="ascend"
「Lekumo ビジネスブログ @example.com」というメールアドレスを持つ投稿者が投稿した記事一覧を、記事のタイトルで昇順に並べ替えた結果の、11件目から10件を出力します。

id

設定できる値 コンテキストに対して有効な記事の ID
既定値 なし

指定された記事IDを持つ記事を出力します。
※注意 指定されたIDが現在のコンテキストのブログに属していない場合には記事は出力されません。

glue

設定できる値 任意の文字列
既定値 なし

出力される記事と記事の間の文字を指定します。

例 <MTEntries glue=","><$MTEntryID$></MTEntries>
記事 ID を, (カンマ) で区切って出力します。

ページ送りの制限

1 テンプレート内に複数の MTEntries を複数記述していて、かつページネーションを有効にした場合、2 ページ目移行の 1 件目の記事は「最初に記述されている MTEntries の表示件数 x ページ番号 + 1」件目の記事となる。
例：以下のようなテンプレートの場合、2 ページ目は最新記事から 4 件目の記事から始まる（1 ページ目の 2 つ目の MTEntries と同じ記事から始まる）

<MTEntries lastn="3">...</MTEntries>
<MTEntries lastn="3" offset="3">...</MTEntries>

ループ変数

特殊なループ変数 をすべて実装します。