next_post_link

（1.5.0以降）
next_post_link - 次の投稿ページのリンクを表示する

説明

void next_post_link( [ string $format = '%link »' [ , string $link = '%title' [ , bool ~~$in_same_cat~~$in_same_term = false [ , mixed ~~$excluded_categories~~$excluded_terms = '' [ , string $taxonomy = 'category' ] ] ] ] ] )

次の投稿ページのリンクを表示する。

パラメータ

$format
リンク文字列の書式。省略時は'%link »'（%linkは実際のaタグに置き換わる）。
$link
リンクに表示されるラベル。省略時は'%title'（'%title'は、投稿データのタイトルに置き換わる。また'%date'を指定した場合は、投稿データの投稿日に置き換わる）。
~~$in_same_cat~~$in_same_term
同じターム（[3.8.0]より前のバージョンはカテゴリー、[3.8.0]以降のバージョンは$taxonomyで指定されたタクソノミー）内の投稿ページに限定する場合はtrue、限定しない場合はfalseを指定。省略時はfalseが適用される。
~~$excluded_categories~~$excluded_terms
除外するターム（[3.8.0]より前のバージョンはカテゴリー、[3.8.0]以降のバージョンは$taxonomyで指定されたタクソノミー）を指定する場合は、そのカテゴリーIDを文字列または配列で指定。
$taxonomy
[3.8.0]$in_same_termがtrueの場合に同一判定するタクソノミー名を指定（省略時は'category'）。

返り値

返り値はありません。

注意

次の投稿ページがない場合は、何も表示されない。

使用例

次の投稿ページのリンクを表示する。
<?php next_post_link( ); ?>
同一カテゴリー内の次の投稿ページのリンクを表示する。
<?php next_post_link( '%link »', '%title', true ); ?>
同一タグ内の次の投稿ページのリンクを表示する。
<?php next_post_link( '%link »', '%title', true, '', 'post_tag' ); ?>