説明
パラメータ
- $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')。
返り値
パラメータ$previousで示した投稿ページのリンク(aタグ)を返す。注意
next_post_link関数で出力されるリンクを取得する。・パラメータ$formatは、'%link'を含まなければならない。
・パラメータ$linkは、投稿タイトルの'%title'、投稿日の'%date'を含めることができる。
使用例
- 直前の投稿ページのリンクを取得する。<?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 »', '%title', false, '1', false ); ?>
- 同タグ内の直前の投稿ページのリンクを取得する。<?php $url = get_adjacent_post_link( '[%link]', '前の記事へ', true, '', 'post_tag' ); ?>
フィルター
リンクテキストのタイトルを決定する前に'the_title'フィルターを呼び出す。$titleには投稿情報のタイトルが、$post_idには投稿情報IDが格納される。$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 );
アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/link-template.php最終更新 : 2015年05月28日 12:56
関連
お勧め
edit_custom_thumbnail_sizesフィルターを使ってみた(2022年5月30日 更新)
アップロード済みの画像は、トリミングや回転、反転といった編集が可能である。6.0.0で追加されたedit_custom_thumbnail_sizesフィルターは、編集された内容を反映させるサイズを拡張するものだったので、さっそく使ってみた。
WordPressと組み込まれている主なJavaScriptライブラリのバージョン一覧(2018年5月27日 更新)
WordPressの更新が遅れていたサイトを少し前に更新したところ、jQuery UI sortableを使って拡張したページに不具合が発生しました。WordPressの更新に伴って内部のjQuery UIが更新されたことに起因すると思われ、これを機にWordPressとそれに組み込まれたJavaScriptライブラリのバージョンを確認してみました。
投稿日の検索が自由自在に(2015年3月7日 更新)
WordPress 3.7.0ではWP_Date_Queryクラスが追加され、WP_Queryクラス(もちろん query_posts関数でも)で利用できるようになった。このWP_Date_Queryにより、○年○月○日以前や以降の投稿情報を取得したり、○年○月○日から○年○月○日の範囲の投稿情報を取得したりといったことが、容易に行えるようになった。
新テーマ「Twenty Twenty-Three」にはfunctions.phpがない(2022年10月6日 更新)
WordPress 6.1に同梱された新テーマ「Twenty Twenty-Three」を見てみると、そこには見慣れたfunctions.phpがない。Full Site Editing(FSE)対応テーマってこんな感じなのかと思いつつ、テーマの設定がどうなっているのか調べてみた。
WordPressのコーディングスタンダードとPSR-2がかみ合わない(2018年5月27日 更新)
先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon(4.6)」から「Oxygen(4.7)」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style(Formatter)」が「PSR-2」に設定されていることが原因だった。