当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2014年5月25日 (日) 18:03時点におけるKITE (トーク | 投稿記録)による版 (パラメータ)

移動先: 案内検索

個別記事で他のページへのパーマリンクを表示するのに使う、このテンプレートタグは日付順で表示している記事からみてひとつ前の記事へのリンクを表示します。

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

使い方

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

用例

初期設定での使用

前の記事 (記事の作成日順) へのリンクとそのタイトルをアンギュラークウォート («) を使って表示します。

<?php previous_post_link(); ?>

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

ひとつ前の記事のタイトルを「strong」タグを使って表示します (太字になって強調されます)。

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

同じカテゴリー内で、リンクテキストに記事名を使わず、任意の文字にする

表示している記事と同じカテゴリー内のひとつ前の記事へのリンクのテキストをカスタマイズして表示します。記事名はここでは表示されません。「Previous in category」というテキストはあなたの要求にあわせて自由にカスタマイズできます。

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

同一カテゴリー内で、特定のカテゴリーを除外する

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

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

パラメータ

$format
文字列) (オプション) リンクの文字列の書式。リンクの前後に追加する文字を設定できます。「%link」と文字列内に表記すると「link」 (下のパラメータ) に置き換えられます。「Go to %link」とすると「Go to <a href=...」となります。
初期値: « %link
$link
文字列) (オプション) 表示するリンクのテキスト。デフォルトは次の記事のタイトル。
初期値: %title
$in_same_cat
論理値) (オプション) 同じカテゴリーの記事に限定するかどうか。
初期値: false
$excluded_terms
配列/文字列) (オプション) 表示させたくない記事のカテゴリー ID の番号。複数のカテゴリーを除外する場合は配列にするか、コンマで区切ってください (例: '1, 5, 15')。
初期値: ''
$taxonomy
文字列) (オプション) タクソノミー、$in_same_cat が true の場合に有効。(WordPress 3.8. で追加)
初期値: 'category'

参照: next_post_link()


投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Template Tags/previous_post_link最新版との差分