タグリスト

MTPages

ウェブページの一覧を表示するためのブロックタグです。

使い方

<mt:Pages folder="about">
<mt:PagesHeader>
<div class="content">
  <div class="content-header">
    <h1><$mt:PageTitle$></h1>
  </div>
  <div class="content-body">
</mt:PagesHeader>
    <$mt:PageBody$>
    <$mt:PageMore$>
<mt:PagesFooter>
  </div>
  <div class="content-footer">
    <address>
      <span class="vcard author">Posted by: <a class="url fn" href="<mt:PageAuthorURL>"><$mt:PageAuthorDisplayName$></a></span>&nbsp;
      <span class="updated">Last update: <abbr title="<mt:PageModifiedDate format_name="iso8601">"><$mt:PageModifiedDate format="%b %d, %Y %H:%M"$></abbr></span>
    </address>
  </div>
</div>
</mt:PagesFooter>
</mt:Pages>

モディファイア

lastn="N"

出力するウェブページの件数を制限します。lastn モディファイアは、つねに降順 (新しいものから古いものに並ぶ) で処理します。指定可能な値は 1-100 、all(最大100迄)です。

<mt:Pages lastn="5" sort_by="title" sort_order="ascend">

サンプルのように、たとえ sort_by モディファイアでタイトル順、かつ、sort_order モディファイアで ascend (昇順) を指定しても、出力する結果は、最新 5 件のウェブページです。

これは、recently_commented_on モディファイアを同時に設定しているときも同じです。これらは lastn モディファイアと同時に使用しても効果はありません。

limit="N"

lastn モディファイアがウェブページの作成日順に指定件数表示するのに対し、limit モディファイアは、指定された条件でフィルタリングした結果を指定数を最大件数として表示します。指定可能な値は 1-100 のみです。

値に auto を指定した場合、[ブログの設定] で設定した表示件数または、日数分で出力します。

paginate_by="N"

ページ送り等を行いたい場合、モディファイアの値に件数を指定することで、指定した数分の件数が表示されます。詳しくはページ送りのご紹介をご参照ください。

sort_by="foo"

ウェブページを並び替える対象を指定します。

  • authored_on (公開日・初期値)
  • blog_id (ブログID)
  • field:識別子 (カスタムフィールドで設定した識別子の値)

※ authored_on, blog_id, field:識別子 のみ対応しています。
※ created_on(作成日) を利用した場合は authored_on と同じ動作(記事の編集画面で設定した日時順)になります。

sort_order="ascend | descend"

並べる順序を指定します。ascend を指定すると昇順 (新しいものが下)descend は降順 (新しいものが上) です。初期値は descend です。

field:識別子="foo"

カスタムフィールドの値 foo を利用して出力するウェブページをフィルタリングできます。モディファイアの field:識別子 には、カスタムフィールド機能で設定した[識別子]を設定します。

例えば表示するウェブページのうち、ラジオボタンのフィールドの値が 2 のウェブページだけを表示したい場合は次のサンプルのようにします。

<MTPages field:webpage_radiobutton="2">
...
</MTPages>

また、次のサンプルは、webpage_dropdown (タイプはドロップダウンを利用) という識別子の場合で、オプション内のカンマで区切った値のうちの "foo" で指定したフィールドの値(ここでは"りんご")のみがチェックされているウェブページを新規作成順に並べ、その先頭から5件を表示します。

<mt:Pages field:webpage_dropdown="りんご" sort_by="authored_on" sort_order="descend" limit="5">

このモディファイアでは、カスタムフィールドに入力した複数の値を組み合わせたフィルタリング (AND, OR, NOT) を利用できません。

offset="N"

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

folder="folder_foo", folders="folder_foo"

このモディファイアでは、ウェブページを特定のフォルダに属するものだけにフィルタリングできます。ウェブページに設定したサブフォルダもフィルタリングの対象になります。

folder="folder_foo"、および folders="folder_foo" のどちらも、挙動は同じです。1 つのフォルダをフィルタリングする際に folders="folder_foo" と記述が可能ですし、複数フォルダのフィルタリングをする際に folder="folder_foo という記述が可能です。

次のサンプルは、ひとつのフォルダ (サンプルでは Featured フォルダ)に含まれるウェブページだけにフィルタリングします。

<mt:Pages folder="Featured">

もし、指定したいフォルダが、別の親フォルダに含まれる同じ名前の子フォルダなら、親フォルダといっしょに指定します。

<mt:Pages folder="News/Featured">

または

<mt:Pages folder="Projects/Featured">

複数のフォルダを組み合わせ、OR, NOT などを使った複雑なフィルタリングもできます。次のサンプルは、Family または Pets フォルダに含まれるウェブページをフィルタリングします。

<mt:Pages folders="Family OR Pets">

また、次のサンプルは、Family フォルダ以外のフォルダに含まれるウェブページ (どのフォルダにも含まれないウェブページも含む) をフィルタリングします。

<mt:Pages folders="NOT Family">
no_folder="0 | 1"

値が 1 の場合はフォルダに属さない、トップレベルに作成されたウェブページのみを表示します。値が 0 の場合は no_folder モディファイアを設定しないのと同じです。

include_subfolders="1 | 0"

もし、folder または folders モディファイアで設定したフォルダの、すべての子フォルダに含まれるウェブページにフィルタリングしたいときは、値に 1 を設定します。初期値は 0 です。

author="author_foo"

指定したユーザーのウェブページをすべて表示します。表示するウェブページ数を指定するときは lastn を併用してください。

days="N"

指定した日数以内のウェブページをすべて表示します。days は単独で使います。他のオプションと併用すると、days が無視されます。指定可能な値は 1-365 のみです。

include_blogs="all | children | siblings | ID | 識別子" ※blog_ids も include_blogs と全く同じ動作となります。
include_with_website="1"
exclude_blogs="ID | 識別子"

詳しくは、マルチブログ機能が利用できるテンプレートタグを参照してください。

unique="0 | 1"

値に 1 を指定すると、同じテンプレートの中ですでに MTPages を使用して出力されたウェブページを出力しません。

id="entry_id"

出力したいウェブページの id を指定します。

Movable Type.net は無料トライアルが可能です。
Web制作者の方で、デモや評価利用をご希望の場合は、制作者向け評価ライセンスをご利用ください。

無料トライアル 資料ダウンロード 制作者向け評価ライセンス