アドオン・プラグイン
インデックステンプレート、記事リストアーカイブのページを一定の件数で分割することができます。
テンプレート分割の設定
分割したいアーカイブのテンプレートを編集画面を開き、MTEntries タグに limit モディファイア (分割したい単位の数字※変数は利用できません) および offset モディファイアを指定します。offset モディファイアは必ず 0 にしてください。 「このアーカイブを分割する」チェックボックスにチェックを入れて、保存します。
<MTEntries limit="20" offset="0">
...
</MTEntries>
- MTEntries タグはインデックステンプレートかアーカイブテンプレートに記述してください。MTEntries タグと MTPager タグをテンプレートモジュールおよび MTIncludeBlock タグの内側に記載するとページの分割が行えません。
- 例のように limit モディファイアと offset モディファイアはなるべくタグ名 MTEntries の直後に記述し、ほかのモディファイアよりも先に書くようにしてください。
MTEntries に付加された絞り込みを行うためのモディファイアは無視されるため、ページ数が一致しなくなりますので注意してください。PowerCMS 5.21 よりカテゴリやカスタムフィールドなどのフィルタを指定したまま分割ができるようになりました。- テンプレートに「ファイルへのリンク」が設定されている場合、正常に動作しなくなります。その場合は「ファイルへのリンク」を設定しないようにしてください。
ページ送りナビゲーションの作成
MTPager 関連のタグを利用して、ページ送りナビゲーションを生成することができます。
<MTEntries offset="0" limit="20">
<$MTTemplateNote value="Some teplate tags here."$>
</MTEntries>
<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 タグをテンプレートモジュールおよび MTIncludeBlock タグの内側に記載するとページの分割が行えません。
MTEntries に付加された絞り込みを行うためのモディファイアは無視されるため、ページ数が一致しなくなりますので注意してください。PowerCMS 5.21 よりカテゴリやカスタムフィールドによる絞り込みが可能になりました- ページ送りを出力する MTPager タグはページ分割の基準となる MTEntries タグより後に記述する必要があります。