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

説明

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

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

使い方

<?php next_post_link('format', 'link', in_same_cat, 'excluded_categories'); ?>

用例

初期設定での使用

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

Next Post Title »

<?php next_post_link(); ?>

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

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

<strong>Next Post Title</strong>

<?php next_post_link('%link'); ?>

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

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

Next post in category

<?php next_post_link('%link', 'Next post in category', TRUE); ?>

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

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

Next post in category

<?php next_post_link('%link', 'Next post in category', TRUE, '13'); ?>

パラメータ

format 

(文字列) リンクの文字列の書式。リンクの前後に追加する文字を設定できます。「%link」と文字列内に表記すると「link」 (下のパラメータ) に置き換えられます。「Go to %link」とすると「Go to <a href=...」となります。デフォルトは「%link &raquo;」です

link 

(文字列) 表示するリンクのテキスト。デフォルトは次の記事のタイトル (%title) です

in_same_cat 

(論理値) 表示している記事と同じカテゴリーの次の記事を表示するかどうかを設定します。TRUE の場合、同じカテゴリーの記事だけが表示されます

• TRUE
• FALSE (デフォルト)

excluded_categories 

(文字列) 表示させたくない記事のカテゴリー ID の番号。複数のカテゴリーを除外する場合は and で区切ってください (例: '1 and 5 and 15')。デフォルトはありません

WordPress 2.2 では、どうやら複数のカテゴリーを除外するのに and ではなく、コンマを使って区切るようです (例: '1, 5, 15')。今まで通りデフォルトはありません

関連

参照： previous_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/next_post_link （最新版との差分）