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

Movable Type のページ分割によるナビゲーションの前後ページ表示を絞り込む（改）

以前公開した「Movable Type のページ分割によるナビゲーションの前後ページ表示を絞り込む」で、表示するページ数を常に一定にできるよう、機能を追加しました。

１．比較

以下、offset モディファイアに「2」を設定した場合の、機能追加前と機能追加後の表示です。offset モディファイアとは、現在表示中のページから前後に表示するページ数を指定するためのものでます。「2」を設定すれば、現在のページと前後ページ含め最大5ページ分が表示されますが、機能追加前では、末端のページのオフセットは切り捨てられます。

機能追加前

1ページ目

2ページ目

5ページ目

9ページ目

10ページ目

機能追加後

機能追加後は、切り捨てられた分のオフセットを反対側のオフセットに加えることで、常に同じページ数を表示することができます。

1ページ目

2ページ目

5ページ目

9ページ目

10ページ目

以下、カスタマイズ方法です。機能追加後の表示を行いたい場合は必ず４項の設定を行なってください。

２．MTPaginate プラグインによるページ分割の設定

下記の記事を参考にして、MTPaginate プラグインを Movable Type に設定してください。

• メインページのページ分割 for Movable Type 4
• アーカイブページのページ分割 for Movable Type 4.1

注：２項を実施する前に、必ずページ分割が正常に動作することを確認してください。すべてを一気に行うと、正常に動作しなかった場合の切り分けができなくなります。

３．プラグインファイルの修正

MTPaginate/lib/MTPaginate.pm を任意のエディタで開き、赤色部分（v1.28 では 497行～506行辺り）を削除し、青色部分を追加します。

                        $format_title = " . sprintf(' title=\"$format_title\"', \$i)" if $format_title;
                        $res .=<<PHP;
for(\$i = $start; \$i <= $end; \$i++) {
        if(\$i > $start)
                echo '$separator';
        if(\$i == \$paginate_current_page) {
                echo sprintf("$format_current", \$i);
        } else {
                echo "<a href=\\\"\$paginate_self=\$i$anchor\\\"$target" $format_title .  sprintf('>$format', \$i) . '</a>';
        }
}
PHP
                        if ($format_all && $place_all eq 'after') {

下が置き換えた後のリストです。

                        $format_title = " . sprintf(' title=\"$format_title\"', \$i)" if $format_title;
                        my $offset = $args->{offset} || 2;
                        my $fixed_offset = $args->{fixed_offset} || 0;
                        $res .=<<PHP;
if ($fixed_offset) {
  if (($end - \$paginate_current_page) <= $offset) {
    \$before_offset = $offset + ($offset - ($end - \$paginate_current_page));
    \$after_offset = $offset;
  } else if ((\$paginate_current_page - $start) <= $offset) {
    \$before_offset = $offset;
    \$after_offset = $offset + ($offset - (\$paginate_current_page - $start));
  } else {
    \$before_offset = $offset;
    \$after_offset = $offset;
  }
} else {
  \$before_offset = $offset;
  \$after_offset = $offset;
}
for (\$i = $start; \$i <= $end; \$i++) {
  if (\$paginate_current_page == 'all') {
    if(\$i > $start)
      echo '$separator';
    if(\$i == \$paginate_current_page) {
      echo sprintf("$format_current", \$i);
    } else {
      echo "<a href=\\\"\$paginate_self=\$i$anchor\\\"$target" $format_title .  sprintf('>$format', \$i) . '</a>';
    }
  } else {
    if (\$i > $start) {
      if (\$i == \$paginate_current_page && \$i != 1) {
        echo '$separator';
      } else if (\$i < \$paginate_current_page) {
        if (\$paginate_current_page - \$i < \$before_offset) {
          echo '$separator';
        }
      } else {
        if (\$i - \$paginate_current_page < (\$after_offset+1)) {
          echo '$separator';
        }
      }
    }
    if (\$i == \$paginate_current_page) {
      echo sprintf("$format_current", \$i);
    } else {
      if(\$i < \$paginate_current_page) {
        if(\$paginate_current_page - \$i < (\$before_offset+1)) {
          echo "<a href=\\\"\$paginate_self=\$i$anchor\\\"$target" $format_title .  sprintf('>$format', \$i) . '</a>';
        }
      } else {
        if(\$i - \$paginate_current_page < (\$after_offset+1)) {
          echo "<a href=\\\"\$paginate_self=\$i$anchor\\\"$target" $format_title .  sprintf('>$format', \$i) . '</a>';
        }
      }
    }
  }
}
PHP
                        if ($format_all && $place_all eq 'after') {

４．offset モディファイアの指定

テンプレートに記述している MTPaginateNavigator タグに offset モディファイアを与えれば、前後に表示するページ数を指定できます。
指定しない場合のデフォルト値は2になっているので、前後2ページを表示します。

<MTPaginateNavigator offset="3">

とすれば、表示ページの前後3ページのナビゲーションを表示します。

５．fixed_offset モディファイアの指定

テンプレートに記述している MTPaginateNavigator タグに fixed_offset="1" を与えれば、末端のページでも、offset モディファイアで設定した値になるように表示します。指定しない場合のデフォルト値は 0 です。

<MTPaginateNavigator offset="2" fixed_offset="1">

とすれば、表示中のページにかかわらず、常に5ページのナビゲーションを表示します（ページ分割数が5ページ以下の場合を除く）。