Mill's Note

【Wordpress関数】the_post_navigation( )

/

the_post_navigation() は、投稿ページに「前の記事」「次の記事」リンク(ページネーション)を簡単に設置できる、Wordpressテンプレートタグ。

htmlタグ、リンクなどまとめて書き出してくれます。パラメータでカスタマイズも簡単^^

the_post_navigation( ) の設置方法

single.php など投稿用テンプレートの任意の位置に設置します。

パラメータでカスタマイズ可能ですが、カスタマイズ不要なら、パラメータ無しで設置OKです^^

設置コード

PHP
/*  カスタマイズなし (パラメータ不要)  */
<?php the_post_navigation(); ?>
/*  カスタマイズあり (パラメータ指定)  */
<?php
  the_post_navigation( array(
    'prev_text'          => '前の記事', 
    'next_text'          => '次の記事', 
    'in_same_term'       => true,
    'excluded_terms'     => '1, 5',
    'taxonomy'           => 'term',
    'screen_reader_text' => __( '投稿リンク', 'textdomain'),
  ) );
?>

出力結果 (パラメータなし)

HTML code
<nav class="navigation" aria-label="投稿">
  <h2 class="screen-reader-text">投稿ナビゲーション</h2>
  <div class="nav-links">
    <div class="nav-previous"><a href="https://millmi.com/wp/〇〇" rel="prev">前タイトル</a></div>
    <div class="nav-next"><a href="https://millmi.com/wp/〇〇" rel="next">次タイトル</a></div>
  </div>
</nav>

the_post_navigation( ) のパラメータ

カスタマイズする際は、必要なパラメータのみ記載してください。( 変えない部分は記載不要 )

パラメータ初期値
prev_text%title前の記事のリンクテキスト ( 初期値は記事タイトル )
next_text%title次の記事のリンクテキスト ( 初期値は記事タイトル )
in_same_termfalse同じターム内に限定する場合は「true」
excluded_termsNULL除外したいタームIDを指定する。(複数指定は、配列かカンマ区切り)
taxonomycategoryタクソノミーを指定 ( in_the_same_term がtrueの場合のみ有効 )
screen_reader_textPost navigationスクリーンリーダー用テキスト
aria_labelNULLnavのaria-label属性の文言を指定
classnavigationnavに任意のクラスを追加する

参考サイト