next_post_link()


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

構文

next_post_link( string $format = '» %link', string $link = '%title', bool $in_same_term = false, string $excluded_terms = '', string $taxonomy = 'category' );

引数の説明:

  • $format (string) — リンク全体のフォーマット。デフォルトは » %link です。
  • $link (string) — リンクテキストのフォーマット。デフォルトは %title です。
  • $in_same_term (bool) — 同じカテゴリーまたはタクソノミー内のみを検索するかを指定します。デフォルトはfalseです。
  • $excluded_terms (string) — 除外するカテゴリーやタームIDのリストです。
  • $taxonomy (string) — 使用するタクソノミーを指定します。デフォルトは category です。

例1: 基本的な次の投稿リンクの表示

次の投稿へのリンクをデフォルトのフォーマットで表示します。

<?php next_post_link(); ?>

例2: リンクのテキストをカスタマイズ

リンクテキストをカスタマイズし、「次の記事へ」と表示します。

<?php next_post_link( '%link', '次の記事へ' ); ?>

例3: 同じカテゴリー内の投稿のみリンクする

次の投稿が同じカテゴリー内にある場合のみリンクを生成します。

<?php next_post_link( '%link', '同カテゴリー内の次の記事', true ); ?>

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

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

<?php next_post_link( '%link', '次の記事へ', false, '1,2,3' ); ?>

例5: カスタムタクソノミー内で次の投稿リンクを生成

カテゴリーではなくカスタムタクソノミーでフィルタリングします。

<?php next_post_link( '%link', '次のカスタムタクソノミー記事', true, '', 'custom_taxonomy' ); ?>

注意事項

  • next_post_link() はシングル投稿ページ内でのみ機能します。
  • 使用するフォーマットやタクソノミーに注意してください。正しい引数を指定しないと動作しないことがあります。

関連機能：