next_posts_link()

Q: ページネーションリンクが動作しないのはなぜですか？

パーマリンク設定やクエリの不整合が原因の可能性があります。permalink 設定を再保存するか、WP_Query での正しい使用を確認してください。

Q: 「次のページ」が存在しない場合、エラーメッセージを表示できますか？

はい、条件分岐を使うことで「次のページがありません」というメッセージを表示できます。 <?php if (get_query_var('paged') < $wp_query->max_num_pages) : ?> <?php next_posts_link('次のページへ'); ?><?php else : ?> <p>これ以上のページはありません。</p><?php endif; ?>

Function

2025/4/22 Tuesday

next_posts_link() は、ページネーションの「次ページ」リンクを生成するテンプレートタグです。複数ページにまたがる投稿一覧で、次のページの投稿リストへのリンクを表示します。

機能の説明

next_posts_link() は、アーカイブページや投稿一覧ページで使われ、ページネーションの「次のページ」へのリンクを表示します。これにより、ユーザーが古い投稿にアクセスできるようになります。

投稿が多い場合にページネーションを実装する際に使われます。
クエリに基づいた結果に応じて、次ページのリンクが表示されます。

シンプルなコード例

<?php next_posts_link('次のページへ'); ?>

「次のページへ」というテキストのリンクを生成します。次のページが存在しない場合、このリンクは表示されません。

使い方の解説

next_posts_link() は、index.php や archive.php など、投稿一覧を表示するページで使用されます。
このテンプレートタグは query_posts() や WP_Query でカスタムクエリを作成した際にも有効です。

シンプルな「次ページ」リンクする例

<?php next_posts_link('次のページへ'); ?>

次のページが存在する場合に、「次のページへ」というリンクが表示されます。

HTMLでスタイリングしたリンク

<?php next_posts_link('<span class="next-page">次ページ →</span>'); ?>

<span> タグを使うことで、CSSでリンクのデザインを調整できます。

`max_num_pages` と連携した例

<?php if (get_query_var('paged') < $wp_query->max_num_pages) : ?>
    <?php next_posts_link('さらに読み込む'); ?>
<?php endif; ?>

現在のページ番号が最大ページ数に達していない場合のみ、「さらに読み込む」リンクを表示します。

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

`previous_posts_link()`

previous_posts_link() は、「前のページ」へのリンクを表示するテンプレートタグです。next_posts_link() と組み合わせて、前後のページ間での移動を可能にします。

<?php previous_posts_link('← 前のページ'); ?>

このコードは、現在のページの前にある投稿一覧ページへのリンクを生成します。

前後リンクをまとめた例

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

<div> タグでリンクを囲むことで、前後のページへのリンクを横並びで表示し、CSSでスタイリングしやすくします。

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

next_posts_link() はリンクのHTMLのみを生成するため、より詳細なページ情報を取得したい場合は、get_query_var() や $wp_query を使います。

`get_query_var()` でページ番号を取得

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

現在のページ番号を取得して表示します。

出力できる情報

paged：現在のページ番号
max_num_pages：最大ページ数
found_posts：検索結果の投稿数
post_count：現在のページに表示されている投稿数

想定されるトラブル

リンクが表示されない

投稿数が1ページに収まっている場合、次ページリンクは表示されません。

解決策

投稿数が多いこと、posts_per_page の設定が適切であることを確認します。

if ($wp_query->max_num_pages > 1) :
    next_posts_link('次のページへ');
endif;

ページ番号がリセットされる

query_posts() を使うと、ページネーションが正常に機能しないことがあります。

解決策

query_posts() の代わりに WP_Query を使いましょう。

Q&A

ページネーションリンクが動作しないのはなぜですか？

パーマリンク設定やクエリの不整合が原因の可能性があります。permalink 設定を再保存するか、WP_Query での正しい使用を確認してください。

「次のページ」が存在しない場合、エラーメッセージを表示できますか？

はい、条件分岐を使うことで「次のページがありません」というメッセージを表示できます。

<?php if (get_query_var('paged') < $wp_query->max_num_pages) : ?>
    <?php next_posts_link('次のページへ'); ?>
<?php else : ?>
    <p>これ以上のページはありません。</p>
<?php endif; ?>