get_next_post_link:WordPress私的マニュアル

get_next_post_link

(3.7.0以降)
get_next_post_link - 直後の投稿ページのリンクを取得する

説明

string get_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 »' 注）3.7.0では'« %link'になっているが3.8で修正予定）。
$link
リンクタイトルを指定（省略時は'%title'）。
~~$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'）。

返り値

直後の投稿ページのリンク（aタグ）を返す。

注意

next_post_link関数で出力されるリンクを取得する。
・パラメータ$formatは、'%link'を含まなければならない。
・パラメータ$linkは、投稿タイトルの'%title'、投稿日の'%date'を含めることができる。

使用例

直後の投稿ページのリンクを取得する。
<?php $url = get_next_post_link(); ?>
直後の投稿ページのリンクをフォーマットを指定して取得する。
<?php $url = get_next_post_link( '[%link]' ); ?>
直後の投稿ページのリンクをリンクタイトルを指定して取得する。
<?php $url = get_next_post_link( '[%link]', '次の記事へ' ); ?>
同カテゴリー直後の投稿ページのリンクを取得する。
<?php $url = get_next_post_link( '[%link]', '次の記事へ', true ); ?>
カテゴリーIDが1のカテゴリーを除外して直後の投稿ページのリンクを取得する。
<?php $url = get_next_post_link( '[%link]', '次の記事へ', false, '1' ); ?>
同じタグの付いた直後の投稿ページのリンクを取得する。
<?php $url = get_next_post_link( '[%link]', '次の記事へ', true, '', 'post_tag' ); ?>

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/link-template.php

参考

Code Reference: get_next_post_link