WordPressに搭載されているページネーションの使い方とプラグインでの実装方法まとめです。
慣れて自分用のパターンができたら、プラグインよりも簡単なのでプラグイン無しで使いこなせるようになろう!
序
一通り紹介できたので、基本編のまとめです。
WP_Queryによるサブループでの使い方や、動かない場合の対処方法などは、いずれ記事にします。
アーカイブ系
複数ページ
- the_posts_pagination()
- get_the_posts_pagination()
前後ページ
- posts_nav_link()
- previous_posts_link(), next_posts_link()
- get_previous_posts_link(), get_next_posts_link()
- the_posts_navigation()
投稿ページ
- the_post_navigation()
- get_the_post_navigation()
- previous_post_link(), next_post_link()
- get_previous_post(), get_next_post()
ページ分割
- wp_link_pages()
コメント
- paginate_comments_links()
- the_comments_navigation()
- the_comments_pagination()
- previous_comments_link(),next_comments_link()
プラグイン
- WP-PageNavi
豆知識
sに注意
postsとpostの違いに注意が必要です。
アーカイブ系は、postsとsが付きます。
シングル系は、postでsが付きません。
次へ・前へ 逆じゃない?
国産の一部ASP系ブログでは逆になってる事がありますが、WordPress公式にはこのようになっています。
投稿クエリは日付の逆順にソートされるのが普通です。そのため通常は、next(次へ) が古い投稿を指し、previous(前へ) が新しい投稿を指します。
なぜかthe_posts_navigation()だけは、nextクラス側が新しい記事リストへのリンクになります。
スペルミスに注意
ページネーション / Pagination
Pagenationじゃないでのでクラス名を付ける時などに注意が必要です。
ページャー / Pager
海外では一般的に、ポケベルの事を指す。