the_post_navigation()


WordPressのthe_post_navigation()関数は、現在の投稿の前後の投稿へのナビゲーションリンクを表示するために使用されます。この関数は、投稿の前後へのリンクを簡単に表示するための便利な方法を提供します。

構文

the_post_navigation( array $args = array() );

引数の説明:

  • $args (array) — ナビゲーションリンクの表示をカスタマイズするための引数の配列。
  • 'prev_text' (string) — 前の投稿へのリンクのテキスト。
  • 'next_text' (string) — 次の投稿へのリンクのテキスト。
  • 'in_same_term' (bool) — 同じカテゴリーまたはターム内の投稿のみをリンクするかどうか。
  • 'excluded_terms' (string|array) — 除外するタームのIDまたはスラッグ。
  • 'taxonomy' (string) — タクソノミーの指定。
  • 'screen_reader_text' (string) — スクリーンリーダー用のテキスト。

例1: 基本的な使用法

この例では、前後の投稿へのナビゲーションリンクを表示します。

<?php the_post_navigation(); ?>

例2: カスタムテキストの設定

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

<?php the_post_navigation( array( 'prev_text' => '前の投稿', 'next_text' => '次の投稿' ) ); ?>

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

同じカテゴリー内の前後の投稿のみをリンクします。

<?php the_post_navigation( array( 'in_same_term' => true, 'taxonomy' => 'category' ) ); ?>

例4: 除外するタームの指定

特定のタームを除外して前後の投稿をリンクします。

<?php the_post_navigation( array( 'excluded_terms' => array( 1, 2 ), 'taxonomy' => 'category' ) ); ?>

例5: スクリーンリーダーテキストの変更

スクリーンリーダー用のテキストを変更します。

<?php the_post_navigation( array( 'screen_reader_text' => '投稿ナビゲーション' ) ); ?>

例6: カスタムタクソノミーの指定

カスタムタクソノミーを使用して前後の投稿をリンクします。

<?php the_post_navigation( array( 'taxonomy' => 'custom_taxonomy' ) ); ?>

例7: 前の投稿のみを表示

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

<?php the_post_navigation( array( 'next_text' => false ) ); ?>

例8: 次の投稿のみを表示

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

<?php the_post_navigation( array( 'prev_text' => false ) ); ?>

注意点

  • the_post_navigation()は、投稿ページでのみ使用することを推奨します。
  • カスタムタクソノミーを使用する場合、正しいタクソノミー名を指定してください。
  • 除外するタームのIDまたはスラッグを正しく指定しないと、意図しない結果になることがあります。

関連機能：