posts_nav_link()

posts_nav_link() は、複数ページに分かれた投稿一覧のページナビゲーションリンクを表示するためのテンプレートタグです。

前後のページへのリンクを簡単に出力するため、アーカイブページやカテゴリー一覧ページでよく使用されます。

機能の説明

posts_nav_link() は、投稿一覧やアーカイブページで「前のページ」「次のページ」へのリンクを生成します。この関数は、ページネーションを表示するための最もシンプルな方法の1つです。

引数

• 第1引数：リンク間に表示する区切り文字 (例: |)
• 第2引数：次のページへのリンクの文字列 (例: 次へ)
• 第3引数：前のページへのリンクの文字列 (例: 前へ)

シンプルなコード例

<?php posts_nav_link(' | ', '前へ', '次へ'); ?>

この例では、リンクの間に区切り文字「|」を挿入し、次のページには「次へ」、前のページには「前へ」という文字列が表示されます。

使い方の解説

posts_nav_link() は、index.php や archive.php などの投稿一覧ページで使用され、複数ページにわたるコンテンツのナビゲーションを提供します。ページが1ページのみの場合、リンクは表示されません。

表示例

前へ | 次へ

posts_nav_link() は、リンクが必要なページで自動的に適切なリンク先を判断してくれるため、簡単にページ遷移を設定できます。

区切り文字を変更した例

<?php posts_nav_link(' -- ', '過去の投稿', '新しい投稿'); ?>

この例では、区切り文字として「--」を使用し、リンクのテキストを「過去の投稿」「新しい投稿」に変更しています。

前後のリンクをHTMLでラップする例

<nav class="posts-navigation">
    <?php posts_nav_link(' | ', '<span class="prev">前へ</span>', '<span class="next">次へ</span>'); ?>
</nav>

リンクのテキストを <span> タグでラップし、CSSでスタイルを適用できるようにしています。

一緒に使うことが多い関連タグ

paginate_links()

paginate_links() は、ページネーションリンクをカスタマイズして生成するためのタグです。posts_nav_link() よりも柔軟にページのリンクを制御できます。

echo paginate_links( array(
    'total' => $wp_query->max_num_pages,
    'prev_text' => '前へ',
    'next_text' => '次へ'
) ); 

この例では、paginate_links() を使ってより詳細なページネーションを表示しています。

next_posts_link() と previous_posts_link()

これらのテンプレートタグは、それぞれ次のページと前のページへのリンクを表示するために使われます。

<nav class="pagination">
    <?php next_posts_link('次のページへ'); ?>
    <?php previous_posts_link('前のページへ'); ?>
</nav>

next_posts_link() と previous_posts_link() を使い、前後のページリンクをそれぞれ表示します。

追加情報を取得したい場合

posts_nav_link() では、前後のページが存在しない場合に空白を返します。そのため、ページが複数存在するかどうかを確認するには is_paged() などの条件タグと組み合わせると便利です。

使用例

<?php if ( is_paged() ) : ?>
    <?php posts_nav_link(' | ', '前へ', '次へ'); ?>
<?php endif; ?>

このコードは、現在のページが2ページ目以降の場合のみナビゲーションリンクを表示します。

get_query_var() でページ情報を取得

$current_page = get_query_var('paged') ? get_query_var('paged') : 1;
echo '現在のページ: ' . $current_page;

get_query_var() を使って、現在のページ番号を取得します。

出力できる情報

• paged: 現在のページ番号
• max_num_pages: 総ページ数

想定されるトラブル

ページネーションが正しく表示されない

query_posts() などでカスタムクエリを使用している場合、ページネーションが崩れることがあります。

解決策

クエリをカスタマイズする際は、WP_Query クラスを使用し、pagination の設定を忘れずに行います。

シングルページにリンクが表示される

投稿が1ページのみの場合にも posts_nav_link() が実行されてしまうことがあります。

解決策

is_paged() を使って、2ページ目以降の場合のみリンクを表示するようにします。

Q&A

まとめ

posts_nav_link() は、複数ページにわたる投稿やアーカイブのナビゲーションを簡単に実装するための便利なテンプレートタグです。

前後のページリンクをシンプルに表示でき、next_posts_link() や paginate_links() といった他のページナビゲーションタグと組み合わせることで、柔軟なカスタマイズが可能です。