get_previous_post_link()


WordPress関数get_previous_post_link()は、現在の投稿から前の投稿へのリンクを生成するために使用されます。

シンタックス

get_previous_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) — 同じタクソノミー内の投稿のみを検索するか。デフォルトはfalse。
  • $excluded_terms (string|array) — 除外するタームID。デフォルトは''。
  • $taxonomy (string) — タクソノミー名。デフォルトは'category'。

例 1: デフォルトの前の投稿リンクを表示

以下のコードはデフォルトの設定で前の投稿リンクを表示します。

<?php echo get_previous_post_link(); ?>

例 2: カスタムテキストを指定してリンクを表示

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

<?php echo get_previous_post_link( '%link', '← 前の投稿: %title' ); ?>

例 3: 同じカテゴリー内でリンクを生成

同じカテゴリー内の前の投稿のみリンクとして表示します。

<?php echo get_previous_post_link( '%link', '← %title', true ); ?>

例 4: 特定のタクソノミーを指定してリンクを生成

カテゴリー以外のタクソノミー（例: タグ）内の前の投稿へのリンクを生成します。

<?php echo get_previous_post_link( '%link', '« %title', false, '', 'post_tag' ); ?>

例 5: 除外するタームIDを指定してリンクを表示

特定のタームIDを除外してリンクを生成します。

<?php echo get_previous_post_link( '%link', '« %title', false, array( 10, 12 ) ); ?>

注意事項

  • この関数はget_previous_post()を使用して投稿を取得します。
  • リンクが存在しない場合は何も表示されません。
  • タクソノミーを指定する場合、$in_same_term引数が考慮されます。

関連機能：