「テンプレートタグ/next post link」の版間の差分

2015年6月27日 (土) 13:05時点における最新版

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

説明

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

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

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

使い方

<?php next_post_link( $format, $link, $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ); ?>

パラメータ

$format

（文字列）（オプション）リンクの文字列の書式。リンクの前後に追加する文字を設定できます。「%link」と文字列内に表記すると「$link」（次のパラメータ）に置き換えられます。「Go to %link」とすると「Go to <a href=...」となります。スタイルをつけるには HTML タグを入れます。

初期値： '%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'

用例

初期設定での使用

次の投稿（投稿の作成日順）へのリンクを、そのタイトルと右アンギュラークォート（»）として表示します。

Next Post Title »

<?php next_post_link(); ?>

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

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

Next Post Title

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

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

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

Next post in category

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

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

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

Next post in category

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

同じタクソノミー内

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

Next post in taxonomy

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

外部リソース

変更履歴

1.5.0 : 新規導入

ソースファイル

next_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()

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

@@ 1行目: / 1行目: @@
-{{NeedTrans}}
+{{CheckTrans}}
 <div id="Description">
@@ 5行目: / 5行目: @@
 </div>
-Used on single post [[用語集#Permalink|permalink]] pages, this template tag displays a link to the next post which exists in chronological order from the current post.
+このテンプレートタグは、現在の投稿から見て日付順で次の投稿へのリンクを表示します。個別投稿の[[用語集#Permalink|パーマリンク]]ページで使用します。
-This tag must be used in [[The Loop]].
+<p class="information">標準の使い方（デフォルトの設定変更していない[[ループ]]内）では、<code>next_post_link</code> は現在の投稿より新しい投稿へのリンクを表示します。これは似た名前の <tt>[[テンプレートタグ/next_posts_link|next_posts_link]]</tt> が現在の複数投稿ページより<em>古い</em>ページへリンクするのと反対方向です。</p>
+このタグは[[The Loop|ループ]]内で使用しなければなりません。
 <div id="Usage">
@@ 13行目: / 15行目: @@
 </div>
-  <?php next_post_link('format', 'link', in_same_cat,
+  <?php next_post_link( $format, $link, $in_same_term = false, $excluded_terms = <nowiki>''</nowiki>, $taxonomy = 'category' ); ?>
-                         'excluded_categories'); ?>
+<div id="Parameters">
+== パラメータ ==
+</div>
+{{Parameter|$format|文字列|リンクの文字列の書式。リンクの前後に追加する文字を設定できます。「<tt>%link</tt>」と文字列内に表記すると「$link」（次のパラメータ）に置き換えられます。「<tt>Go to %link</tt>」とすると「Go to <nowiki><a href=...</nowiki>」となります。スタイルをつけるには HTML タグを入れます。|オプション|<tt>'%link &amp;raquo;'</tt>}}
+{{Parameter|$link|文字列|表示するリンクのテキスト。|オプション|<tt>%title</tt> &ndash; 次の投稿のタイトル}}
+{{Parameter|$in_same_term|真偽値|現在の投稿と同じタクソノミー・ターム（例：カテゴリー）の投稿に限定するかどうか。<tt>'true'</tt> にすると現在のタクソノミー・タームがついた投稿だけを表示します。|オプション|<tt>false</tt>}}
+<p class="information">'''注意:''' 現在の投稿に 2 つ以上のターム（例：親と子の両方）がついていた場合、どのタームがついた投稿へリンクするかは選べません。</p>
+{{Parameter|$excluded_terms|文字列/配列|表示させたくない投稿のターム ID（例：カテゴリー ID）。複数のタームを除外するには配列にするか、コンマで区切ってください（例：<tt>array(1, 5)</tt> または <tt>'1,5'</tt>）。<!-- This argument used to accept a list of IDs separated by <tt>'and'</tt>, this was deprecated in WordPress 3.3 -->|オプション|<nowiki>''</nowiki>}}
+{{Parameter|$taxonomy|文字列|タクソノミー。これは <tt>$in_same_term</tt> が true の場合に有効です。（WordPress 3.8 で追加）|オプション|<tt>'category'</tt>}}
 <div id="Examples">
@@ 23行目: / 40行目: @@
 === 初期設定での使用 ===
 </div>
-Displays link with the post title of the next post (chronological post date order), followed by a right angular quote (&raquo;). By default, this tag works like [[Next Post]]
-<div class="example">[[#Examples|Next Post Title &raquo;]]</div>
+次の投稿（投稿の作成日順）へのリンクを、そのタイトルと右アンギュラークォート（&raquo;）として表示します。
+<div style="border:1px solid blue; width:50%; margin: 20px; padding:10px">[[#Examples|Next Post Title &raquo;]]</div>
-<pre><?php next_post_link(); ?></pre>
+ <?php next_post_link(); ?>
 <div id="Bold_Post_Title_As_Link">
-===Bold Post Title As Link===
+=== リンクのタイトルを太字にする ===
 </div>
-Displays link with next chronological post's title wrapped in 'strong' tags (typically sets text to bold).
-<div class="example">[[#Examples|<strong>Next Post Title</strong>]]</div>
+作成日順で次の投稿のタイトルを「strong」タグで囲んで表示します（ふつうは太字になって強調されます）。
-  <?php next_post_link('<strong>%link</strong>'); ?>
+<div style="border:1px solid blue; width:50%; margin: 20px; padding:10px">[[#Examples|<strong>Next Post Title</strong>]]</div>
+  <?php next_post_link( <nowiki>'<strong>%link</strong>'</nowiki> ); ?>
 <div id="Text_As_Link.2C_Without_Post_Title.2C_Within_Same_Category">
-===Text As Link, Without Post Title, Within Same Category===
+=== 同じカテゴリー内で、リンクテキストに投稿タイトルを使わず任意の文字にする ===
 </div>
-Displays custom text as link to the next post within the same category as the current post. Post title is not included here. "Next post in category" is the custom text, which can be changed to fit your requirements.
-<div class="example">[[#Examples|Next post in category]]</div>
+現在の投稿と同じカテゴリー内の次の投稿へのリンクを、テキストをカスタマイズして表示します。投稿タイトルは入れません。「Next post in category」というテキストはあなたの希望にあわせてカスタマイズできます。
-  <?php next_post_link('%link', 'Next post in category', TRUE); ?>
+<div style="border:1px solid blue; width:50%; margin: 20px; padding:10px">[[#Examples|Next post in category]]</div>
+  <?php next_post_link( '%link', 'Next post in category', TRUE ); ?>
 <div id="Within_Same_Category.2C_Excluding_One">
-===Within Same Category, Excluding One===
+=== 同じカテゴリー内だが特定のカテゴリーを除外する ===
 </div>
-Displays link to next post in the same category, as long as it is not in category 13 (the category ID #). You can change the number to any category you wish to exclude. Exclude multiple categories by using "<tt> and </tt>" as a delimiter.
-<div class="example">[[#Examples|Next post in category]]</div>
+番（カテゴリー ID の数値）のカテゴリーだけを除外して、同じカテゴリーの次の投稿へのリンクを表示します。除外したいカテゴリーの番号は自由に変えられます。複数のカテゴリーを除外するには「<tt>,</tt>」で区切ってください。
- <?php next_post_link('%link', 'Next post in category', TRUE, '13'); ?>
+<div style="border:1px solid blue; width:50%; margin: 20px; padding:10px">[[#Examples|Next post in category]]</div>
-<div id="Parameters">
+ <?php next_post_link( '%link', 'Next post in category', TRUE, '13' ); ?>
-== パラメータ ==
+<div id="Within_Same_Taxonomy">
+=== 同じタクソノミー内 ===
 </div>
-; format : (''string'') Format string for the link. This is where to control what comes before and after the link. <tt>'%link'</tt> in string will be replaced with whatever is declared as <tt>'link'</tt> (see next parameter). <tt>'Go to %link'</tt> will generate "Go to <a href=..." Put HTML tags here to style the final results. Defaults to <tt>'%link &amp;raquo;'</tt>.
+同じタクソノミー・ターム内の次の投稿へのリンクを表示します。投稿フォーマットはタクソノミーのひとつなので、下記の例は同じ投稿フォーマットの次の投稿へリンクします。
-; link : (''string'') Link text to display. Defaults to next post's title (<tt>'%title'</tt>).
-; in_same_cat : (''boolean'') Indicates whether next post must be within the same category as the current post. If set to <tt>TRUE</tt>, only posts from the current category will be displayed. Options are:
+<div style="border:1px solid blue; width:50%; margin: 20px; padding:10px">[[#Examples|Next post in taxonomy]]</div>
-:* <tt>TRUE</tt>
-:* <tt>FALSE</tt> (Default)
+ <?php next_post_link( '%link', 'Next post in taxonomy', TRUE, ' ', 'post_format' ); ?>
-; excluded_categories : (''string'') Numeric category ID(s) from which the next post should not be listed. Separate multiple categories with <tt>and</tt>; example: <tt>'1 and 5 and 15'</tt>. There is no default.
-: In Wordpress 2.2, apparently, concatenating multiple categories for exclusion is done with a comma, not <tt>and</tt>; example: <tt>'1, 5, 15'</tt>.  Still no default.
+<!-- 冗長なので削除 gblsm 26-Jun-2015
+== Notes ==
+See also [[Template Tags/previous_post_link|previous_post_link()]].
+-->
+<div id="Resources">
+== 外部リソース ==
+</div>
+* [http://digwp.com/2009/08/wordpress-page-navigation/ Digging into Wordpress - Definitive Guide to WordPress Page Navigation]
+* [http://wordpress.org/support/topic/286131 Forum discussion on using a image with next_post_link]
+<div id="Change_Log">
+== 変更履歴 ==
+</div>
+.5.0 : 新規導入
+<div id="Source_File">
+== ソースファイル ==
+</div>
+<tt>next_post_link()</tt> は {{Trac|wp-includes/link-template.php}} にあります。
 <div id="Related">
-== 関連 ==
+== 関連項目 ==
 </div>
-参照： [[テンプレートタグ/previous_post_link|previous_post_link()]]
-{{Tag Post Tags}}
+{{Pagination}}
+{{Tag Footer}}
-{{PHP Function Tag Footer}}
+{{原文|Function Reference/next_post_link|151999}} <!-- 12:27, 10 June 2015 Tex0gen 版 -->
-{{原文|Template Tags/next_post_link|49701}}
+{{DEFAULTSORT:Next_post_link}}
+[[Category:テンプレートタグ]]
-{{DEFAULTSORT:next_post_link}}
+[[en:Function Reference/next_post_link]]
-[[en:Template Tags/next_post_link]]

「テンプレートタグ/next post link」の版間の差分

2015年6月27日 (土) 13:05時点における最新版

目次

説明

使い方

パラメータ

用例

初期設定での使用

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

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

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

同じタクソノミー内

外部リソース

変更履歴

ソースファイル

案内メニュー

個人用ツール

名前空間

変種

表示

その他

検索

このサイトについて

特集

リファレンス

サーバー別情報

ドキュメント整備

協力・貢献

WordPress関連リンク

ツール

他言語版