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

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

関数リファレンス/get next post

提供: WordPress Codex 日本語版
移動先: 案内検索

説明

現在の投稿に隣接している次の投稿を取得します。

使い方

<?php get_next_post( $in_same_term, $excluded_terms, $taxonomy ) ?>

パラメータ

$in_same_term
論理値) (オプション) 同じカテゴリの投稿かどうか
初期値: false
$excluded_terms
文字列) (オプション) 除外するカテゴリーID
初期値: ''
$taxonomy
文字列) (オプション) タクソノミー、$in_same_term が true の場合に有効(WordPress 3.8 で追加)
初期値: 'category'

戻り値

  • 取得できた場合は WP_Post オブジェクト
  • グローバル $post が設定されていない場合は Null
  • 対応する投稿が存在しない場合は空の文字列

用例

<?php
$next_post = get_next_post();
if (!empty( $next_post )): ?>
  <a href="<?php echo get_permalink( $next_post->ID ); ?>"><?php echo $next_post->post_title; ?></a>
<?php endif; ?>

変更履歴

1.5.0 以降

ソースファイル

get_next_post()wp-includes/link-template.php で定義されています。

関連

get_previous_post(), get_adjacent_post()


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


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