get_adjacent_post_link()


WordPressのget_adjacent_post_link()関数は、前後の投稿へのリンクを取得して表示するために使用されます。

構文

get_adjacent_post_link( string $format, string $link, bool $in_same_term = false, mixed $excluded_terms = '', string $taxonomy = 'category', bool $previous = true )

引数の説明

  • $format (string) — 出力フォーマットを指定します。
  • $link (string) — 表示するリンクテキストを設定します。
  • $in_same_term (bool) — 同じターム内の投稿を検索するか指定します。デフォルトはfalseです。
  • $excluded_terms (mixed) — 除外するタームIDのリスト。空の場合は除外しません。
  • $taxonomy (string) — タクソノミーを指定します。デフォルトはcategoryです。
  • $previous (bool) — 前の投稿か次の投稿を指定します。デフォルトはtrue（前の投稿）です。

例 1: 前の投稿へのリンクを表示

以下のコードは、前の投稿へのリンクを表示します。

<?php echo get_adjacent_post_link( '%link', '前の記事へ', true ); ?>

例 2: 次の投稿へのリンクを表示

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

<?php echo get_adjacent_post_link( '%link', '次の記事へ', true, '', 'category', false ); ?>

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

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

<?php echo get_adjacent_post_link( '%link', '← 前の記事を見る', true ); ?>

例 4: 特定のカテゴリーを除外

特定のカテゴリーIDを除外して前後のリンクを表示します。

<?php echo get_adjacent_post_link( '%link', '次の記事へ', true, '5,10' ); ?>

例 5: カスタムタクソノミーでリンクを取得

カスタムタクソノミー（例: genre）を使って前後のリンクを取得します。

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

注意事項

  • $in_same_termをtrueに設定した場合、投稿は同じターム内でのみ検索されます。
  • $excluded_termsはカンマ区切りのタームIDを受け付けます。

関連機能：