get_adjacent_post_link

パラメータ

• $format
  フォーマットを指定。
• $link
  リンクタイトルを指定。
• $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を文字列または配列で指定。
• $previous
  直前の投稿ページの場合はtrueを、直後の場合はfalseを指定（省略時はtrue）。
• $taxonomy
  [3.8.0]$in_same_termがtrueの場合に同一判定するタクソノミー名を指定（省略時は'category'）。

返り値

注意

使用例

• 直前の投稿ページのリンクを取得する。
  <?php $url = get_adjacent_post_link( '[%link]', '前の記事へ' ); ?>
• 同カテゴリー内の直前の投稿ページのリンクを取得する。
  <?php $url = get_adjacent_post_link( '[%link]', '前の記事へ', true ); ?>
• カテゴリーIDが1のカテゴリーを除外して直前の投稿ページのリンクを取得する。
  <?php $url = get_adjacent_post_link( '[%link]', '前の記事へ', false, '1' ); ?>
• カテゴリーIDが1のカテゴリーを除外して直後の投稿ページのリンクを取得する。
  <?php $url = get_adjacent_post_link( '%link &raquo;', '%title', false, '1', false ); ?>
• 同タグ内の直前の投稿ページのリンクを取得する。
  <?php $url = get_adjacent_post_link( '[%link]', '前の記事へ', true, '', 'post_tag' ); ?>

フィルター

$title = apply_filters( 'the_title', $title, $post_id );

return apply_filters( 'previous_post_link', $output, $format, $link, $post, $adjacent );

return apply_filters( 'next_post_link', $output, $format, $link, $post, $adjacent );

アクション

ソースファイル