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

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

「テンプレートタグ/next posts link」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/next_posts_link 17:55, 19 December 2014 Pietergoosen 版を反映して和訳。)
({{CheckTrans}})
1行目: 1行目:
{{CheckTrans}}
 
 
 
<div id="Description">
 
<div id="Description">
 
== 説明 ==
 
== 説明 ==

2015年6月16日 (火) 11:32時点における版

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

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

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

使い方

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

パラメータ

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

用例

デフォルトの使い方

<?php next_posts_link(); ?>

パラメータを指定する例

<?php next_posts_link( 'Older Entries »', 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 にあります。


投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


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


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