previous_post_link()


関数 WordPressprevious_post_link() は、現在の投稿の前の投稿へのリンクを表示するために使用されます。

シンタックス

previous_post_link( string $format = '%link', string $link = 'Previous Post', bool $in_same_term = false, string|array $excluded_terms = '', string $taxonomy = 'category' );

引数の説明:

  • $format (string) — リンクのHTMLフォーマット。デフォルトは%linkです。
  • $link (string) — 表示されるリンクテキスト。デフォルトは「Previous Post」です。
  • $in_same_term (bool) — 同じカテゴリーまたはタクソノミー内の投稿を表示するかどうかを指定します。デフォルトはfalseです。
  • $excluded_terms (string|array) — 除外するカテゴリーまたはタームID。
  • $taxonomy (string) — 使用するタクソノミーのスラッグ。デフォルトはcategoryです。

例1: 基本的な前の投稿へのリンク

現在の投稿の前の投稿へのリンクを表示します。

<?php previous_post_link(); ?>

例2: カスタムリンクテキストを設定する

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

<?php previous_post_link( '%link', '前の記事はこちら' ); ?>

例3: 同じカテゴリー内の投稿に限定する

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

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

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

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

<?php previous_post_link( '%link', '前の記事', false, '3, 5' ); ?>

例5: タクソノミーを指定する

カテゴリーではなく、カスタムタクソノミーを使用します。

<?php previous_post_link( '%link', '前の記事', false, '', 'genre' ); ?>

注意事項:

  • previous_post_link() 関数は単一投稿ページ（シングルページ）でのみ動作します。
  • リンクが生成されない場合、前の投稿が存在しないか、条件が満たされていない可能性があります。

関連機能：