WordPressでブログ等を制作する際、ページャーを用意する必要があります。

例）Googleのページャー

昔は結構めんどくさい作り方をしていたのですが、the_posts_pagination関数を用いることで、極簡単にページャーを出力することが可能です。（※WordPress 4.1.0以降）

PHPコード

<?php the_posts_pagination() ?>

出力されるHTML

<nav class="navigation pagination" role="navigation">
  <h2 class="screen-reader-text">投稿ナビゲーション</h2>
  <div class="nav-links">
    <span class="page-numbers current">1</span>
    <a class="page-numbers" href="http://sample.magicword.jp/diary/?page=2">2</a>
    <a class="next page-numbers" href="http://sample.magicword.jp/diary/?page=2">次へ</a>
  </div>
</nav>

ただしちょっとだけ問題がありまして、この関数、とても便利なのはいいのですけれど、設定できる引数がとても少ないのです。
たった４つしかありません。

今回、リンク先にハッシュ(/?page=2#hashname)を付与したかったのでソースを調べてみたところ、内部的には paginate_links関数 を呼び出していました。その際の引数は the_posts_pagination関数に渡したものをそのまま paginate_links関数に渡すようです。

引数の初期値を見てみると、’format’ => ‘?page=%#%’ となっていますから、どうも %#% というのがページ番号になるようですね。ということで、下記のようにしてハッシュを付けてみました。

PHPコード

<?php the_posts_pagination(array('format' => '?page=%#%#hashname')) ?>

出力されるHTML

<nav class="navigation pagination" role="navigation">
  <h2 class="screen-reader-text">投稿ナビゲーション</h2>
  <div class="nav-links">
    <span class="page-numbers current">1</span>
    <a class="page-numbers" href="http://sample.magicword.jp/diary/?page=2#hashname">2</a>
    <a class="next page-numbers" href="http://sample.magicword.jp/diary/?page=2#hashname">次へ</a>
  </div>
</nav>

これでちょっとカスタムしたページャーが簡単に作れますね。

追記

どうもうまくいかないケースがあるようです。その場合は format の値を　page/%#%#sub-contents　のようにしてみてください。