/
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_term | false | 同じターム内に限定する場合は「true」 |
excluded_terms | NULL | 除外したいタームIDを指定する。(複数指定は、配列かカンマ区切り) |
taxonomy | category | タクソノミーを指定 ( in_the_same_term がtrueの場合のみ有効 ) |
screen_reader_text | Post navigation | スクリーンリーダー用テキスト |
aria_label | NULL | navのaria-label属性の文言を指定 |
class | navigation | navに任意のクラスを追加する |