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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/next_post_link 2007年11月6日 (火) 02:35 Kafkaesqui 版)
 
(クリーンアップ。)
 
(6人の利用者による、間の19版が非表示)
1行目: 1行目:
== Description ==
+
{{CheckTrans}}
  
Used on single post [[Glossary#Permalink|permalink]] pages, this template tag displays a link to the next post which exists in chronological order from the current post.
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
This tag must be used in [[The Loop]].
+
このテンプレートタグは、現在の投稿から見て日付順で次の投稿へのリンクを表示します。個別投稿の[[用語集#Permalink|パーマリンク]]ページで使用します。
  
== Usage ==
+
<p class="information">標準の使い方(デフォルトの設定変更していない[[ループ]]内)では、<code>next_post_link</code> は現在の投稿より新しい投稿へのリンクを表示します。これは似た名前の <tt>[[テンプレートタグ/next_posts_link|next_posts_link]]</tt> が現在の複数投稿ページより<em>古い</em>ページへリンクするのと反対方向です。</p>
  
%%% <?php next_post_link('format', 'link', in_same_cat,
+
このタグは[[The Loop|ループ]]内で使用しなければなりません。
                        'excluded_categories'); ?> %%%
+
  
== Examples  ==
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
===Default Usage===
+
<?php next_post_link( $format, $link, $in_same_term = false, $excluded_terms = <nowiki>''</nowiki>, $taxonomy = 'category' ); ?>
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 style="border:1px solid blue; width:50%; padding:10px">[[#Examples|Next Post Title &raquo;]]</div>
+
<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">
 +
== 用例 ==
 +
</div>
 +
 
 +
<div id="Default_Usage">
 +
=== 初期設定での使用 ===
 +
</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(); ?>
  
===Bold Post Title As Link===
+
<div id="Bold_Post_Title_As_Link">
Displays link with next chronological post's title wrapped in 'strong' tags (typically sets text to bold).
+
=== リンクのタイトルを太字にする ===
 +
</div>
  
<div style="border:1px solid blue; width:50%; padding:10px">[[#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>
  
===Text As Link, Without Post Title, Within Same Category===
+
<?php next_post_link( <nowiki>'<strong>%link</strong>'</nowiki> ); ?>
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 style="border:1px solid blue; width:50%; padding:10px">[[#Examples|Next post in category]]</div>
+
<div id="Text_As_Link.2C_Without_Post_Title.2C_Within_Same_Category">
 +
=== 同じカテゴリー内で、リンクテキストに投稿タイトルを使わず任意の文字にする ===
 +
</div>
  
<tt><?php next_post_link('%link', 'Next post in category', TRUE); ?></tt>
+
現在の投稿と同じカテゴリー内の次の投稿へのリンクを、テキストをカスタマイズして表示します。投稿タイトルは入れません。「Next post in category」というテキストはあなたの希望にあわせてカスタマイズできます。
  
===Within Same Category, Excluding One===
+
<div style="border:1px solid blue; width:50%; margin: 20px; padding:10px">[[#Examples|Next post in category]]</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 style="border:1px solid blue; width:50%; padding:10px">[[#Examples|Next post in category]]</div>
+
<?php next_post_link( '%link', 'Next post in category', TRUE ); ?>
  
<tt><?php next_post_link('%link', 'Next post in category', TRUE, '13'); ?></tt>
+
<div id="Within_Same_Category.2C_Excluding_One">
 +
=== 同じカテゴリー内だが特定のカテゴリーを除外する ===
 +
</div>
  
== Parameters ==
+
13 番(カテゴリー ID の数値)のカテゴリーだけを除外して、同じカテゴリーの次の投稿へのリンクを表示します。除外したいカテゴリーの番号は自由に変えられます。複数のカテゴリーを除外するには「<tt>,</tt>」で区切ってください。
  
; 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>.
+
<div style="border:1px solid blue; width:50%; margin: 20px; padding:10px">[[#Examples|Next post in category]]</div>
; 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:
+
:* <tt>TRUE</tt>
+
:* <tt>FALSE</tt> (Default)
+
; 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.
+
  
== Related ==
+
<?php next_post_link( '%link', 'Next post in category', TRUE, '13' ); ?>
 +
 
 +
<div id="Within_Same_Taxonomy">
 +
=== 同じタクソノミー内 ===
 +
</div>
 +
 
 +
同じタクソノミー・ターム内の次の投稿へのリンクを表示します。投稿フォーマットはタクソノミーのひとつなので、下記の例は同じ投稿フォーマットの次の投稿へリンクします。
 +
 
 +
<div style="border:1px solid blue; width:50%; margin: 20px; padding:10px">[[#Examples|Next post in taxonomy]]</div>
 +
 
 +
<?php next_post_link( '%link', 'Next post in taxonomy', TRUE, ' ', 'post_format' ); ?>
 +
 
 +
<!-- 冗長なので削除 gblsm 26-Jun-2015
 +
== Notes ==
 
See also [[Template Tags/previous_post_link|previous_post_link()]].
 
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>
 +
 +
1.5.0 : 新規導入
 +
 +
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
 +
 +
<tt>next_post_link()</tt> は {{Trac|wp-includes/link-template.php}} にあります。
 +
 +
<div id="Related">
 +
== 関連項目 ==
 +
</div>
 +
 +
{{Pagination}}
 +
 +
{{Tag Footer}}
  
{{Tag Post Tags}}
+
{{原文|Function Reference/next_post_link|151999}} <!-- 12:27, 10 June 2015 Tex0gen 版 -->
  
{{PHP Function Tag Footer}}
+
{{DEFAULTSORT:Next_post_link}}
 +
[[Category:テンプレートタグ]]
  
[[en:Template Tags/next_post_link]]
+
[[en:Function Reference/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 &raquo;'
$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()


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


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