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

この項目「テンプレートタグ/next post link」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

説明

このテンプレートタグは、現在の投稿から見て日付順で次の投稿へのリンクを表示します。個別投稿のパーマリンクページで使用します。

標準の使い方（デフォルトの設定変更していないループ内）では、next_post_link は現在の投稿より新しい投稿へのリンクを表示します。これは似た名前の next_posts_link が現在の複数投稿ページより古いページへリンクするのと反対方向です。

このタグはループ内で使用しなければなりません。

使い方

<?php next_post_link( $format, $link, $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ); ?>

パラメータ

$format

（文字列） （オプション） リンクの文字列の書式。リンクの前後に追加する文字を設定できます。「%link」と文字列内に表記すると「$link」（次のパラメータ）に置き換えられます。「Go to %link」とすると「Go to <a href=...」となります。スタイルをつけるには HTML タグを入れます。

初期値： '%link &raquo;'

$link

（文字列） （オプション） 表示するリンクのテキスト。

初期値： %title – 次の投稿のタイトル

$in_same_term

（真偽値） （オプション） 現在の投稿と同じタクソノミー・ターム（例：カテゴリー）の投稿に限定するかどうか。'true' にすると現在のタクソノミー・タームがついた投稿だけを表示します。

初期値： false

注意: 現在の投稿に 2 つ以上のターム（例：親と子の両方）がついていた場合、どのタームがついた投稿へリンクするかは選べません。

$excluded_terms

（文字列/配列） （オプション） 表示させたくない投稿のターム ID（例：カテゴリー ID）。複数のタームを除外するには配列にするか、コンマで区切ってください（例：array(1, 5) または '1,5'）。

初期値： ''

$taxonomy

（文字列） （オプション） タクソノミー。これは $in_same_term が true の場合に有効です。（WordPress 3.8 で追加）

初期値： 'category'

用例

初期設定での使用

次の投稿（投稿の作成日順）へのリンクを、そのタイトルと右アンギュラークォート（»）として表示します。

Next Post Title »

<?php next_post_link(); ?>

リンクのタイトルを太字にする

作成日順で次の投稿のタイトルを「strong」タグで囲んで表示します（ふつうは太字になって強調されます）。

Next Post Title

<?php next_post_link( '<strong>%link</strong>' ); ?>

同じカテゴリー内で、リンクテキストに投稿タイトルを使わず任意の文字にする

現在の投稿と同じカテゴリー内の次の投稿へのリンクを、テキストをカスタマイズして表示します。投稿タイトルは入れません。「Next post in category」というテキストはあなたの希望にあわせてカスタマイズできます。

Next post in category

<?php next_post_link( '%link', 'Next post in category', TRUE ); ?>

同じカテゴリー内だが特定のカテゴリーを除外する

13 番（カテゴリー ID の数値）のカテゴリーだけを除外して、同じカテゴリーの次の投稿へのリンクを表示します。除外したいカテゴリーの番号は自由に変えられます。複数のカテゴリーを除外するには「,」で区切ってください。

Next post in category

<?php next_post_link( '%link', 'Next post in category', TRUE, '13' ); ?>

同じタクソノミー内

同じタクソノミー・ターム内の次の投稿へのリンクを表示します。投稿フォーマットはタクソノミーのひとつなので、下記の例は同じ投稿フォーマットの次の投稿へリンクします。

Next post in taxonomy

<?php next_post_link( '%link', 'Next post in taxonomy', TRUE, ' ', 'post_format' ); ?>

外部リソース

• Digging into Wordpress - Definitive Guide to WordPress Page Navigation
• Forum discussion on using a image with next_post_link

変更履歴

1.5.0 : 新規導入

ソースファイル

next_post_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()

投稿タグ: 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_post_link （最新版との差分）