get_next_posts_page_link()


WordPressのget_next_posts_page_link()関数は、ページネーションにおいて次のページのURLを取得するために使用されます。この関数は、現在のクエリに基づいて次のページのリンクを生成します。

構文

get_next_posts_page_link( string $label = null, int $max_page = 0 );

引数の説明:

  • $label (string) — リンクテキスト。デフォルトはnullで、次のページのURLのみを返します。
  • $max_page (int) — 最大ページ数。デフォルトは0で、現在のクエリに基づいて自動的に計算されます。

例1: 次のページのリンクを表示

次のページのリンクを表示する基本的な例です。

<?php echo get_next_posts_page_link(); ?>

例2: カスタムテキスト付きのリンクを表示

リンクテキストをカスタマイズして表示する例です。

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

例3: 最大ページ数を指定

最大ページ数を指定して次のページのリンクを取得する例です。

<?php echo get_next_posts_page_link( null, 5 ); ?>

例4: リンクをボタンとして表示

次のページのリンクをボタンとして表示する例です。

<a href="<?php echo get_next_posts_page_link(); ?>" class="button">次のページ</a>

例5: 次のページが存在するか確認

次のページが存在するかどうかを確認し、リンクを表示する例です。

<?php if ( get_next_posts_page_link() ) : ?>
    <a href="<?php echo get_next_posts_page_link(); ?>">次のページへ</a>
<?php endif; ?>

例6: カスタムクエリでの使用

カスタムクエリを使用して次のページのリンクを取得する例です。

<?php
$custom_query = new WP_Query( array( 'posts_per_page' => 5 ) );
if ( $custom_query->have_posts() ) {
    while ( $custom_query->have_posts() ) {
        $custom_query->the_post();
        the_title();
    }
    echo get_next_posts_page_link( '次のページへ', $custom_query->max_num_pages );
}
wp_reset_postdata();
?>

例7: ページネーションループ内での使用

ページネーションループ内で次のページのリンクを表示する例です。

<?php
if ( get_next_posts_page_link() ) {
    echo '<a href="' . get_next_posts_page_link() . '">次のページ</a>';
}
?>

注意点

  • この関数は、ページネーションが有効な場合にのみ使用できます。
  • カスタムクエリを使用する場合は、wp_reset_postdata()を忘れずに呼び出してください。
  • リンクテキストを指定しない場合、デフォルトでURLのみが返されます。

関連機能：