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

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

テンプレートタグ/next posts link

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

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

PHP で使用するために値が必要なら、get_next_posts_link() を使ってください。

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

使い方

<?php next_posts_link( $label, $max_pages ); ?>

パラメータ

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

用例

デフォルトの使い方

<?php next_posts_link(); ?>

パラメータを指定する例

<?php next_posts_link( 'Older Entries &raquo;', 0 ); ?>

WP_Query でループさせたとき

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

<?php
// "paged" パラメータを決定(静的フロントページ内のクエリなら 'page' を使う)
$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;

// クエリ
$the_query = new WP_Query( 'cat=1&paged=' . $paged ); 
?>

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

<?php
// ループ
while ( $the_query->have_posts() ) : $the_query->the_post(); 
?>
<?php the_title(); ?>
<?php endwhile; ?>

<?php
// next_posts_link() に max_num_pages を指定して使う
next_posts_link( 'Older Entries', $the_query->max_num_pages );
previous_posts_link( 'Newer Entries' );
?>

<?php 
// クエリとページネーションをクリーンアップ(メインクエリを再設定)
wp_reset_postdata(); 
?>

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

参考

  • もし php.ini ファイル内で mysql.trace_mode が有効なら、この関数は動作しません(黙って失敗します)。もしファイルを編集できなければ、テーマの functions.phpini_set( 'mysql.trace_mode', 0 ); を追加してみましょう。

変更履歴

0.71 : 新規導入

ソースファイル

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/next_posts_link最新版との差分