get_next_post_link()


関数WordPressget_next_post_link()は、現在の投稿の次の投稿へのリンクを生成します。

シンタックス

get_next_post_link( string $format = '« %link', string $link = '%title', bool $in_same_term = false, string|array $excluded_terms = '', string $taxonomy = 'category' );

引数の説明:

  • $format (string) — リンクのフォーマットを指定します。デフォルトは« %linkです。
  • $link (string) — リンクのテキストを指定します。デフォルトは%titleです。
  • $in_same_term (bool) — 同じカテゴリーやタクソノミー内の投稿に限定するかどうかを指定します。
  • $excluded_terms (string|array) — 除外するタームIDを指定します。
  • $taxonomy (string) — 使用するタクソノミーを指定します。デフォルトはcategoryです。

例1: シンプルな次の投稿リンクの表示

次の投稿へのリンクを表示します。

<?php echo get_next_post_link(); ?>

例2: カスタムテキストでリンクを表示

リンクのテキストをカスタマイズして表示します。

<?php echo get_next_post_link( '%link', '次の記事はこちら »' ); ?>

例3: 同じカテゴリー内での次の投稿リンク

同じカテゴリー内で次の投稿へのリンクを表示します。

<?php echo get_next_post_link( '%link', '次の投稿', true ); ?>

例4: 特定のカテゴリーを除外してリンクを表示

指定したカテゴリーを除外して次の投稿リンクを生成します。

<?php echo get_next_post_link( '%link', '次の投稿へ', false, '3,5' ); ?>

例5: カスタムタクソノミーを指定してリンクを表示

カスタムタクソノミーのタームに基づいて次の投稿へのリンクを表示します。

<?php echo get_next_post_link( '%link', '次の記事はこちら', true, '', 'custom_taxonomy' ); ?>

注意事項

  • get_next_post_link()関数は、現在の投稿が存在しない場合には何も返しません。
  • リンクフォーマットの%linkおよび%titleは、リンクとタイトルを挿入するプレースホルダーです。

関連機能：