• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/get next posts link

提供: WordPress Codex 日本語版
移動先: 案内検索

この項目「関数リファレンス/get next posts link」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

現在のクエリ内で、投稿の次のセットへのリンクを取得します。

投稿クエリは日付の逆順にソートされるのが普通です。そのため通常は、get_next_posts_link() が古い投稿(セットの終わり方向)を指し、get_previous_posts_link() が新しい投稿(セットの始まり方向)を指します。

参考: もしページネーションに問題があれば Troubleshooting Broken Pagination /en を見るとよいでしょう。

使い方

<?php echo get_next_posts_link( $label, $max_page ); ?>

パラメータ

$label
文字列) (オプション) リンクのテキスト。
初期値: 'Next Page &raquo;'
$max_pages
整数) (オプション) リンクを表示するページ番号の上限。
初期値: 0 – 上限なし。

戻り値

(文字列) 
次のページへのリンク(HTML 形式)。何か異常があれば null を返す。

用例

デフォルトの使い方

<?php echo get_next_posts_link(); ?>

ラベルを変更

<?php echo get_next_posts_link( 'Go to next page' ); ?>

ラベルと投稿ページ数を変更

<?php echo get_next_posts_link( 'Go to next page', 4 ); ?>

WP_Query でループさせたとき

WP_Query を使ってループさせた場合、get_next_posts_link() 関数に $max_pages パラメータを指定してください。総ページ数を取得するにはカスタム WP_Query オブジェクトの 'max_num_pages' プロパティが使えます。

<?php
// set the "paged" parameter (use 'page' if the query is on a static front page)
$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;

// the query
$the_query = new WP_Query( 'cat=1&paged=' . $paged ); 
?>

<?php if ( $the_query->have_posts() ) : ?>

<?php
// the loop
while ( $the_query->have_posts() ) : $the_query->the_post(); 
?>
<?php the_title(); ?>
<?php endwhile; ?>

<?php

// get_next_posts_link() usage with max_num_pages
echo get_next_posts_link( 'Older Entries', $the_query->max_num_pages );
echo get_previous_posts_link( 'Newer Entries' );
?>

<?php 
// clean up after our query
wp_reset_postdata(); 
?>

<?php else:  ?>
<p><?php _e( 'Sorry, no posts matched your criteria.' ); ?></p>
<?php endif; ?>

変更履歴

2.7.0 : 新規導入

ソースファイル

get_next_posts_link()wp-includes/link-template.php にあります。

ページネーション: posts_nav_link(), next_posts_link(), previous_posts_link(), get_next_posts_link(), get_previous_posts_link(), paginate_links(), wp_link_pages(), next_post_link(), previous_post_link(), next_image_link(), previous_image_link(), the_posts_pagination(), get_the_posts_pagination()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/get_next_posts_link最新版との差分