小粋空間  -  a cheap joke and a play on words site

アーカイブページのページ分割 for Movable Type 4.1

Movable Type 4.1 で、MTPaginate プラグインを用いたアーカイブページ（カテゴリーアーカイブ・月別アーカイブ等）のページ分割方法をご紹介します。
4.15でテンプレート構成が変わりそうなので、4.1（厳密には4.0～4.1）限定にしておきます。

このエントリーは「カテゴリーアーカイブと月別アーカイブのページ分割」を MT4.1 用に書き直したものです。

カスタマイズ手順には、PHP化の設定を含んでいます。PHP化の設定を行っていない場合は手順１～手順３を行った後、PHP化したメインページが正常に表示されることを確認してから、手順４以降のページ分割の設定を行ってください。

すでにPHP化が済んでいる場合は、手順５から開始してください。

１．ファイル・ディレクトリのパーミッションを変更

ファイルのパーミッションを変更するために、以下の作業を行ってください。
この作業を行うと、他のアーカイブページのファイルも同じパーミッションになるので、すべてのアーカイブのPHP化（拡張子を.phpにする）が必要です。

まず、mt-config.cgi を FTP ツールでダウンロードし、任意のエディタで開き、行末に以下の内容を追加してください。mt-config.cgi はアプリケーションディレクトリにあります。アプリケーションディレクトリとは、Movable Type をインストールしたディレクトリで、mt.cgi があるところです。

HTMLUmask 0072
DirUmask 0072
HTMLPerms 0777

修正後、mt-config.cgi を保存して、元のディレクトリにアップロードし、メインページを再構築してください。

この設定を行っておけば、出力されるメインページや他のHTMLファイルおよびディレクトリのパーミッションを常に705にします。パーミッションを 775 にする場合は、

HTMLUmask 0022
DirUmask 0022
HTMLPerms 0777

としてください。

２．拡張子の変更

ブログ管理画面の「設定」→「ブログの設定」→「公開」の一番下にある「アーカイブの拡張子」を html から php に変更して「変更を保存」をクリックします。

３．XML宣言の修正

ページを XHTML文書、例えば XHTML1.0 として適合させている場合、前項と同じ画面の「テンプレートの内容」の1行目、またはテンプレートモジュールの「ヘッダー」の1行目（またはどこか）に、

<?xml version="1.0" encoding="<$MTPublishCharset$>"?>

という XML 宣言が記述されているケースがあります（記述されていなければこの項目はスキップしてください）。

PHP化を行うと、サーバではこのXML宣言の行をPHPスクリプトとして誤認識してしまい、次のようなPHPエラー

Parse error: parse error, unexpected T_STRING in ～（省略）～index.php on line 1

となるか、500エラーが発生するか、真っ白なページが表示される可能性があります。

このような場合、前述のXML宣言を下記の内容に置き換えてください（ご利用になる際、リストに含まれる改行はすべて除去してください。）。
なお、他のアーカイブページ等も PHP 化されていることを前提にしています。

<MTUnless name="system_template">
<? php echo('
</MTUnless>
<?xml version="1.0" encoding="utf-8"?>
<MTUnless name="system_template">
'); ? >
</MTUnless>

よく分からない場合や、ページが表示されない場合は、このカスタマイズを行う代わりに、XML宣言自体を削除してください。

４．プラグインのダウンロード

MT Extensions より MTPaginate をダウンロード（ページ上の方にある「Download」をクリック）。ファイルは任意のフォルダ（デスクトップ等）に保存します。

５．プラグインのインストール

注：この情報はバージョン1.28のものです。
ダウンロードしたファイルを解凍し、その中の MTPaginate ディレクトリを下記のディレクトリ構成になるように plugins ディレクトリに丸ごとアップロードします。

plugins/MTPaginate/lib/MTPaginate.pm
plugins/MTPaginate/MTPaginate.pl

ブログ管理画面の「システム」→「プラグイン」で MTPaginate が表示されれば、プラグインのインストールは完了です。

６．ページ分割の設定

ブログ管理画面より、「デザイン」→「テンプレート」→「アーカイブテンプレート」→「ブログ記事リスト」を選択し、青色部分のページ分割用タグを設定します。デフォルトテンプレート／配布テンプレート共通です。

一見複雑にみえますが <MTEntries> の直前と </MTEntries> の前後に加えるだけです。

すべてのアーカイブにページ分割を設定する場合

　　　　：
<MTIf name="datebased_archive">
  <MTPaginate>
    <MTPaginateContent max_sections="5">
    <MTEntries>
<$MTEntryTrackbackData$>
<$MTInclude module="ブログ記事の概要"$>
<$MTPaginateSectionBreak$>
    </MTEntries>
    </MTPaginateContent>
    <MTPaginateIfMultiplePages>
    <p class="paginate">
      <MTPaginateIfPreviousPage_>
      <a href="<$MTPaginatePreviousPageLink$>">&#65308;</a>
      </MTPaginateIfPreviousPage_>
      <$MTPaginateNavigator style="links" format_all="All pages" place_all="after" separator=" | ">
      <MTPaginateIfNextPage_>
      <a href="<$MTPaginateNextPageLink$>">&#65310;</a>
      </MTPaginateIfNextPage_>
    </p>
    </MTPaginateIfMultiplePages>
  </MTPaginate>
<MTElse>
  <MTPaginate>
    <MTPaginateContent max_sections="5">
    <MTEntries limit="auto">
<$MTEntryTrackbackData$>
<$MTInclude module="ブログ記事の概要"$>
<$MTPaginateSectionBreak$>
    </MTEntries>
    </MTPaginateContent>
    <MTPaginateIfMultiplePages>
    <p class="paginate">
      <MTPaginateIfPreviousPage_>
      <a href="<$MTPaginatePreviousPageLink$>">&#65308;</a>
      </MTPaginateIfPreviousPage_>
      <$MTPaginateNavigator style="links" format_all="All pages" place_all="after" separator=" | ">
      <MTPaginateIfNextPage_>
      <a href="<$MTPaginateNextPageLink$>">&#65310;</a>
      </MTPaginateIfNextPage_>
    </p>
    </MTPaginateIfMultiplePages>
  </MTPaginate>
</MTIf>
　　　　：

日付ベースのアーカイブのみページ分割を設定する場合

　　　　：
<MTIf name="datebased_archive">
  <MTPaginate>
    <MTPaginateContent max_sections="5">
    <MTEntries>
<$MTEntryTrackbackData$>
<$MTInclude module="ブログ記事の概要"$>
<$MTPaginateSectionBreak$>
    </MTEntries>
    </MTPaginateContent>
    <MTPaginateIfMultiplePages>
    <p class="paginate">
      <MTPaginateIfPreviousPage_>
      <a href="<$MTPaginatePreviousPageLink$>">&#65308;</a>
      </MTPaginateIfPreviousPage_>
      <$MTPaginateNavigator style="links" format_all="All pages" place_all="after" separator=" | ">
      <MTPaginateIfNextPage_>
      <a href="<$MTPaginateNextPageLink$>">&#65310;</a>
      </MTPaginateIfNextPage_>
    </p>
    </MTPaginateIfMultiplePages>
  </MTPaginate>
<MTElse>
    <MTEntries limit="auto">
<$MTEntryTrackbackData$>
<$MTInclude module="ブログ記事の概要"$>
    </MTEntries>
</MTIf>
　　　　：

日付ベース以外のアーカイブのみページ分割を設定する場合

　　　　：
<MTIf name="datebased_archive">
    <MTEntries>
<$MTEntryTrackbackData$>
<$MTInclude module="ブログ記事の概要"$>
    </MTEntries>
<MTElse>
  <MTPaginate>
    <MTPaginateContent max_sections="5">
    <MTEntries limit="auto">
<$MTEntryTrackbackData$>
<$MTInclude module="ブログ記事の概要"$>
<$MTPaginateSectionBreak$>
    </MTEntries>
    </MTPaginateContent>
    <MTPaginateIfMultiplePages>
    <p class="paginate">
      <MTPaginateIfPreviousPage_>
      <a href="<$MTPaginatePreviousPageLink$>">&#65308;</a>
      </MTPaginateIfPreviousPage_>
      <$MTPaginateNavigator style="links" format_all="All pages" place_all="after" separator=" | ">
      <MTPaginateIfNextPage_>
      <a href="<$MTPaginateNextPageLink$>">&#65310;</a>
      </MTPaginateIfNextPage_>
    </p>
    </MTPaginateIfMultiplePages>
  </MTPaginate>
</MTIf>
　　　　：

日付ベース以外のアーカイブのみページ分割を設定する場合、MTEntries タグにある

limit="auto"

は削除した方がいいでしょう。
limit モディファイアに auto を設定した場合、表示するブログ記事数を、「設定」→「ブログの設定」→「ブログ記事」→「ブログ記事の表示数」にあわせます。

７．表示ブログ記事数の設定

リスト中の、

<MTPaginateContent max_sections="5">
<MTEntries>

にある

max_sections="5"

は、1ページに表示する最大ブログ記事数を設定します。ここでは5つのブログ記事表示する設定にしています。

ブログ記事数が30ある場合、max_sections が1ページに5ブログ記事ずつ表示する設定になっているので、ページは計6ページに分割して表示することになります。

８．スタイルの設定

赤色の p 要素はスタイルを設定するために付与しています。必要に応じて下記のようなCSSをスタイルシートに追加してください。

.paginate {
    text-align: center;
    font-size: 9px;
}

設定が完了したら保存し、再構築します。
これで各アーカイブページがページ分割されていることを確認してください。

９．ページリンクの設定

ページリンクは冒頭のスクリーンショットのように表示され、各ページへのリンクと現在のページから前後のページへジャンプするのリンク、および全ページを一括表示するリンクがあります。

各ページのリンクの現在のページはテキスト表示になります。また一番最初のページは「＜」を表示せず、最後のページは「＞」を表示しません。

上のサンプルではページリンクをページの一番下に表示するように配置していますが、ページの上に表示したい場合は、

　　　　　：
<MTPaginate>
<MTPaginateIfMultiplePages>
<p class="paginate">
<MTPaginateIfPreviousPage_>
<a href="<$MTPaginatePreviousPageLink$>">&#65308;</a>
</MTPaginateIfPreviousPage_>
<$MTPaginateNavigator style="links" format_all="All pages" place_all="after" separator=" | ">
<MTPaginateIfNextPage_>
<a href="<$MTPaginateNextPageLink$>">&#65310;</a>
</MTPaginateIfNextPage_>
</p>
</MTPaginateIfMultiplePages>
    <MTPaginateContent max_sections="5">
    <MTEntries>
<$MTEntryTrackbackData$>
<$MTInclude module="ブログ記事の概要"$>
<$MTPaginateSectionBreak$>
    </MTEntries>
    </MTPaginateContent>
  </MTPaginate>
　　　　　：

と、青色部分を追加してください（すべてのアーカイブに適用させる場合は、上のリストを日付アーカイブベースのサブテンプレートと、それ以外のサブテンプレートの2ヶ所に設定してください）。上下両方にページリンクを付与することも可能です。

注意点としては、ページリンクを必ず MTPaginate タグと MTPaginateContent タグの間に設定してください。誤って MTPaginate の上に設定すると再構築エラーになり、MTPaginateContent の下に貼り付けると再構築はできますが、何も表示されなくなりますのでご注意ください。

2008.04.25
カスタマイズ手順に PHP 化の手順を追加し、手順の順番を見直しました。