• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

テンプレートタグ/previous post link

提供: WordPress Codex 日本語版
移動先: 案内検索

この項目「テンプレートタグ/previous post link」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

このテンプレートタグは、現在の投稿から見て日付順でひとつ前の投稿へのリンクを表示します。個別投稿のパーマリンクページで使用します。

標準の使い方(デフォルトの設定変更していないループ内)では、previous_post_link は現在の投稿より古い投稿へのリンクを表示します。これは似た名前の previous_posts_link が現在の複数投稿ページより新しいページへリンクするのと反対方向です。

このタグはループ内で使用しなければなりません。

使い方

<?php previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy ); ?>

パラメータ

$format
文字列) (オプション) リンクの文字列の書式。リンクの前後に追加する文字を設定できます。「%link」と文字列内に表記すると「$link」(次のパラメータ)に置き換えられます。「Go to %link」とすると「Go to <a href=...」となります。スタイルをつけるには HTML タグを入れます。
初期値: '&laquo; %link'
$link
文字列) (オプション) 表示するリンクのテキスト。
初期値: %title – ひとつ前の投稿のタイトル
$in_same_term
真偽値) (オプション) 現在の投稿と同じタクソノミー・ターム(例:カテゴリー)の投稿に限定するかどうか。'true' にすると現在のタクソノミー・タームがついた投稿だけを表示します。
初期値: false

注意: 現在の投稿に 2 つ以上のターム(例:親と子の両方)がついていた場合、どのタームがついた投稿へリンクするかは選べません。

$excluded_terms
文字列/配列) (オプション) 表示させたくない投稿のターム ID(例:カテゴリー ID)。複数のタームを除外するには配列にするか、コンマで区切ってください(例:array(1, 5) または '1,5')。
初期値: ''
$taxonomy
文字列) (オプション) タクソノミー。これは $in_same_term が true の場合に有効です。(WordPress 3.8 で追加)
初期値: 'category'

用例

初期設定での使用

ひとつ前の投稿(投稿の作成日順)へのリンクを、左アンギュラークォート(«)と投稿タイトルとして表示します。

« Previous Post Title
<?php previous_post_link(); ?>

リンクのタイトルを太字にする

作成日順でひとつ前の投稿のタイトルを「strong」タグで囲んで表示します(ふつうは太字になって強調されます)。

Previous Post Title
<?php previous_post_link('<strong>%link</strong>'); ?>

同じカテゴリー内で、リンクテキストに投稿タイトルを使わず任意の文字にする

現在の投稿と同じカテゴリー内のひとつ前の投稿へのリンクを、テキストをカスタマイズして表示します。投稿タイトルは入れません。「Previous in category」というテキストはあなたの希望にあわせてカスタマイズできます。

Previous in category
<?php previous_post_link('%link', 'Previous in category', TRUE); ?>

同じカテゴリー内だが特定のカテゴリーを除外する

13 番(カテゴリー ID の数値)のカテゴリーだけを除外して、同じカテゴリーのひとつ前の投稿へのリンクを表示します。除外したいカテゴリーの番号は自由に変えられます。複数のカテゴリーを除外するには「,」で区切るか配列で指定してください。

Previous in category
<?php previous_post_link('%link', 'Previous in category', TRUE, '13'); ?>

同じタクソノミー内

同じタクソノミー・ターム内のひとつ前の投稿へのリンクを表示します。投稿フォーマットはタクソノミーのひとつなので、下記の例は同じ投稿フォーマットの次の投稿へリンクします。

Previous post in taxonomy
<?php previous_post_link( '%link', 'Previous post in category', TRUE, ' ', 'post_format' ); ?>


外部リソース

変更履歴

1.5.0 : 新規導入

ソースファイル

previous_post_link()wp-includes/link-template.php にあります。

ページネーション: posts_nav_link(), next_posts_link(), previous_posts_link(), get_next_posts_link(), get_previous_posts_link(), paginate_links(), wp_link_pages(), next_post_link(), previous_post_link(), next_image_link(), previous_image_link(), the_posts_pagination(), get_the_posts_pagination()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/previous_post_link最新版との差分