- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
関数リファレンス/get previous post
提供: WordPress Codex 日本語版
< 関数リファレンス
説明
現在の投稿に隣接している前の投稿を取得します。
使い方
<?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 (最新版との差分)