概要
get_next_post_link関数は、直後の投稿ページのリンクを取得するために使用されます。この関数は、ブログやサイトにおいて、ユーザーが次の投稿に簡単にアクセスできるようにするためによく使われます。具体的には、以下のようなシナリオで役立ちます。
- 記事ページから次の記事へのリンクを表示する。
- シングルポストテンプレートでのナビゲーションを強化する。
- 投稿一覧ページで次の日付の投稿を表示する。
- ランディングページで関連のある次の投稿を薦める。
- カスタム投稿タイプでのナビゲーションを提供する。
- アーカイブページでの次の投稿へのリンクを作成する。
- カテゴリーページで次の投稿への誘導リンクを作る。
- ショートコードで次の投稿リンクを動的に生成する。
構文
get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
パラメータ
$format(string) – リンクの書式。デフォルトは<a href="%link%" rel="next">%title%</a>。$link(string) – リンクのテキストをカスタマイズ。$in_same_term(bool) – 同じタクソノミーでの投稿を取得するかどうか（デフォルトはfalse）。$excluded_terms(string|array) – 除外するタクソノミーのターム。$taxonomy(string) – タクソノミーのスラッグ（デフォルトはcategory）。
戻り値
- 取得したリンクのHTML。次の投稿が存在しない場合は、空文字列を返します。
関連する関数
使用可能なバージョン
get_next_post_link関数は、WordPress 2.5.0以上で使用可能です。
コアファイルのパス
wp-includes/link-template.php
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | 〇 |
| template_redirect | |
| get_header | |
| wp_head |
この関数は、特定のWordPressバージョンで非推奨または削除されたことはありません。