ホーム > PowerCMS > ドキュメント > スタンダード版 > テンプレート >

リスト系アーカイブページの静的ファイル分割

インデックステンプレート、リスト系アーカイブのページを一定の件数でページ分割して出力することができます。

ページ分割の設定

ページ分割したいテンプレートの編集画面を開き、下記の記述と設定を行います。

テンプレートの記述

MTEntries タグに limit モディファイア (分割したい単位の数字※変数は利用できません) および offset モディファイアを指定します。offset モディファイアは必ず 0 にしてください。

<MTEntries limit="20" offset="0">
  例: 1ページ20件で一覧ページを分割出力します。
</MTEntries>

MTEntries タグはインデックステンプレートかアーカイブテンプレートに記述してください。テンプレートモジュールおよび MTIncludeBlock タグの内側に記載するとページの分割が行えません。

MTEntries タグでは、field:foo モディファイアや category モディファイアによる絞り込みが可能です。ただし、unique モディファイアには対応していません。また、ブロックタグの処理を途中で終了させる break_var モディファイアは意図通り機能しません。

テンプレートの設定

「このアーカイブを分割する」チェックボックスにチェックを入れて、保存します。

テンプレートに「ファイルへのリンク」が設定されている場合、正常に動作しなくなります。その場合は「ファイルへのリンク」を設定しないようにしてください。

ページ送りナビゲーションの作成

MTPager 関連のタグを利用して、ページ送りナビゲーションを生成することができます。

<$MTTemplateNote value="記事たち"$>
<MTEntries offset="0" limit="20">
  例: 1ページ20件で一覧ページを分割出力します。
</MTEntries>

<$MTTemplateNote value="ページ送り"$>
<MTPager>
  <MTIfPagerHeader>
    Page <$MTPagerCurrent$> of <$MTPagerTotal$> <MTIfPagerPrev><a href="<$MTPagerPrevLink$>">Prev</a></MTIfPagerPrev>
  </MTIfPagerHeader>
  [<a href="<$MTPagerLink$>"><$MTPagerCounter$></a>]
  <MTIfPagerFooter>
    <MTIfPagerNext><a href="<$MTPagerNextLink$>">Next</a></MTIfPagerNext>
  </MTIfPagerFooter>
</MTPager>

MTEntries タグと MTPager タグはインデックステンプレートかアーカイブテンプレートに記述してください。MTEntries タグと MTPager タグをテンプレートモジュールに記載するとページの分割が行えません。

ページ送りを出力する MTPager タグはページ分割の基準となる MTEntries タグより後に記述する必要があります。