【WordPressテンプレートタグ】previous_post_link():前の投稿ページへのリンクを表示
公開日: : 最終更新日:2016/03/24 テンプレートタグ
概要
表示している記事より公開日が1つ前(古い)の記事へのリンクを表示する。
書式
パラメーター
- format
- リンクの前後に追加する文字を設定(初期値:« %link)
「%link」と文字列内に表記すると「link」パラメータに置き換えらる。
- link
- 表示するリンクのテキスト(初期値:%title) ←前の記事のタイトル
- in_same_term
- 同じカテゴリーの記事に限定するかどうか
- true/同じカテゴリーの記事のみ表示
- false/カテゴリーを無視する(初期値)
- excluded_terms
- 表示させたくない記事のカテゴリー IDの番号(初期値:なし)
※複数のカテゴリーを除外する場合は配列にするか、コンマで区切る(例:'1,2,3')
- taxonomy
- タクソノミー名。
「in_same_term」パラメーターがtrueの場合に有効(初期値:'category')
位置
ループ内
使用例
初期設定での使用
前の記事へのリンクとそのタイトルを「«」と一緒に表示する。
<?php previous_post_link(); ?>
表示例
パラメーターを指定して使用
太字の「< 前の記事へ」という表記で、前の記事へのリンクとそのタイトルを表示する。
<?php previous_post_link('<strong>%link</strong>', '< 前の記事へ','true'); ?>
表示例
タクソノミー名を指定して、特定のカテゴリーを除外する
タクソノミー名「taxonomy」のカテゴリーID「2」と「3」を除外して、「< 前の記事を読む」という表記で、前の記事へのリンクとそのタイトルを表示する。
<ul>
<?php previous_post_link('<li class="prev">%link</li>', '< 前の記事を読む', true,'2,3','taxonomy'); ?>
<?php next_post_link('<li class="next">%link</li>', '次の記事を読む >', true,'2,3','taxonomy'); ?>
</ul>
<ul> <li class="prev"><a href="#">< 前の記事を読む</a></li> <li class="next"><a href="#">次の記事を読む ></a></li> </ul>
表示例
MEMO
previous_post_link()は、前のシングルページ(日付の古い記事)へのリンクを表示するのに対し、previous_posts_link()は前の記事一覧(日付の新しいアーカイブ)へのリンクを表示する。
「taxonomy」パラメーター
WordPress3.8.より追加
関連
関連記事
-
-
【WordPressインクルードタグ】get_template_part():テンプレートパーツを読み込む
概要 パラメーターで指定したテンプレートパーツ(ヘッダー、サイドバー、フッター以外) を読み込む。...
-
-
【WordPressテンプレートタグ】single_cat_title():カテゴリーアーカイブのタイトルを表示または取得
概要 カテゴリーアーカイブページでのカテゴリータイトルを表示または取得する。 書式 <?php...
-
-
【WordPressテンプレートタグ】edit_post_link():記事やページの管理画面へのリンクを表示
概要 現在の記事やページの編集画面へのリンクを表示する。wordpressにログインしていない場合は...
-
-
【WordPressテンプレートタグ】has_post_thumbnail():アイキャッチ画像が登録されているかを判別
概要 アイキャッチ画像が登録されているかどうかを判別する。 書式 <?php has_post...
-
-
【WordPressテンプレートタグ】comments_number():記事へのコメント数を表示
概要 サイト閲覧者からコメントがあった場合、承認されたコメント数を表示する。 書式 <?php...
-
-
【WordPressテンプレートタグ】the_excerpt():記事の抜粋を表示
概要 記事の抜粋を表示する。 抜粋の文末には (角括弧+三点リーダー)をリンクなしで表...
-
-
【WordPressテンプレートタグ】the_date_xml():フィード向けにY-m-d形式で記事の投稿日を表示
概要 フィード向けにY-m-d形式 (例 2015-07-10)で記事の投稿日を表示する 書式 &l...
-
-
【WordPressテンプレートタグ】the_permalink():記事のパーマリンクのURLを表示
概要 投稿や固定ページなど記事詳細ページへのURLを表示する 書式 <?php the_per...
-
-
【WordPressテンプレートタグ】single_tag_title():タグアーカイブのタイトルを表示または取得
概要 現在のページのタグアーカイブのタイトルを表示または取得する。 書式 <?php sing...
-
-
【WordPressテンプレートタグ】the_author_posts_link():作成者別アーカイブへのリンクを表示
概要 投稿の作成者別アーカイブへのリンクを表示する。 「ユーザー」>「あなたのプロフィール」>「ブロ...