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

説明

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

使い方

<?php get_previous_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
$previous_post = get_previous_post();
if (!empty( $previous_post )): ?>
  <a href="<?php echo get_permalink( $previous_post->ID ); ?>"><?php echo $previous_post->post_title; ?></a>
<?php endif; ?>

注

• 使用関数： get_adjacent_post()

変更履歴

1.5.0 以降

ソースファイル

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

関連

get_next_post(), get_adjacent_post()

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

最新英語版： WordPress Codex » Function Reference/get previous post （最新版との差分）