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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/previous_post_link 2007年11月6日 (火) 02:34 Kafkaesqui 版)
 
(クリーンアップ。)
 
(4人の利用者による、間の11版が非表示)
1行目: 1行目:
== Description ==
+
{{CheckTrans}}
  
Used on single post [[Glossary#Permalink|permalink]] pages, this template tag displays a link to the previous 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>previous_post_link</code> は現在の投稿より古い投稿へのリンクを表示します。これは似た名前の <tt>[[テンプレートタグ/previous_posts_link|previous_posts_link]]</tt> が現在の複数投稿ページより<em>新しい</em>ページへリンクするのと反対方向です。</p>
  
%%% <?php previous_post_link('format', 'link', in_same_cat,
+
このタグは[[The Loop|ループ]]内で使用しなければなりません。
                        'excluded_categories'); ?> %%%
+
  
== Examples  ==
+
<div id="Arguments">
 +
== 使い方 ==
 +
</div>
  
===Default Usage===
+
<?php previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy ); ?>
Displays link with left angular quote (&laquo;) followed by the post title of the previous post (chronological post date order). By default, this tag works like [[Template_Tags/previous_post|previous_post()]].
+
 
 +
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
 
 +
{{Parameter|$format|文字列|リンクの文字列の書式。リンクの前後に追加する文字を設定できます。「<tt>%link</tt>」と文字列内に表記すると「$link」(次のパラメータ)に置き換えられます。「<tt>Go to %link</tt>」とすると「Go to <nowiki><a href=...</nowiki>」となります。スタイルをつけるには HTML タグを入れます。|オプション|<tt>'&amp;laquo; %link'</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>
 +
 
 +
ひとつ前の投稿(投稿の作成日順)へのリンクを、左アンギュラークォート(&laquo;)と投稿タイトルとして表示します。
  
 
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|&laquo; Previous Post Title]]</div>
 
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|&laquo; Previous Post Title]]</div>
 
   
 
   
<pre><?php previous_post_link(); ?></pre>
+
<?php previous_post_link(); ?>
  
===Bold Post Title As Link===
+
<div id="Bold_Post_Title_As_Link">
Displays link with previous chronological post's title wrapped in 'strong' tags (typically sets text to bold).
+
=== リンクのタイトルを太字にする ===
 +
</div>
 +
 
 +
作成日順でひとつ前の投稿のタイトルを「strong」タグで囲んで表示します(ふつうは太字になって強調されます)。
  
 
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|'''Previous Post Title''']]</div>
 
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|'''Previous Post Title''']]</div>
  
%%% <?php previous_post_link('<strong>%link</strong>'); ?> %%%
+
<?php previous_post_link(<nowiki>'<strong>%link</strong>'</nowiki>); ?>
  
===Text As Link, Without Post Title, Within Same Category===
+
<div id="Text_As_Link.2C_Without_Post_Title.2C_Within_Same_Category">
Displays custom text as link to the previous post within the same category as the current post. Post title is not included here. "Previous in category" is the custom text, which can be changed to fit your requirements.
+
=== 同じカテゴリー内で、リンクテキストに投稿タイトルを使わず任意の文字にする ===
 +
</div>
 +
 
 +
現在の投稿と同じカテゴリー内のひとつ前の投稿へのリンクを、テキストをカスタマイズして表示します。投稿タイトルは入れません。「Previous in category」というテキストはあなたの希望にあわせてカスタマイズできます。
  
 
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|Previous in category]]</div>
 
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|Previous in category]]</div>
  
%%% <?php previous_post_link('%link', 'Previous in category', TRUE); ?> %%%
+
<?php previous_post_link('%link', 'Previous in category', TRUE); ?>
  
===Within Same Category, Excluding One===
+
<div id="Within_Same_Category.2C_Excluding_One">
Displays link to previous 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>
 +
 
 +
13 番(カテゴリー ID の数値)のカテゴリーだけを除外して、同じカテゴリーのひとつ前の投稿へのリンクを表示します。除外したいカテゴリーの番号は自由に変えられます。複数のカテゴリーを除外するには「<tt>,</tt>」で区切るか配列で指定してください。
  
 
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|Previous in category]]</div>
 
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|Previous in category]]</div>
  
%%% <?php previous_post_link('%link', 'Previous in category', TRUE, '13'); ?> %%%
+
<?php previous_post_link('%link', 'Previous in category', TRUE, '13'); ?>
 +
 
 +
<div id="Within_Same_Taxonomy">
 +
=== 同じタクソノミー内 ===
 +
</div>
 +
 
 +
同じタクソノミー・ターム内のひとつ前の投稿へのリンクを表示します。投稿フォーマットはタクソノミーのひとつなので、下記の例は同じ投稿フォーマットの次の投稿へリンクします。
 +
 
 +
<div style="border:1px solid blue; width:50%; padding:10px">[[#Examples|Previous post in taxonomy]]</div>
 +
 
 +
<?php previous_post_link( '%link', 'Previous post in category', TRUE, ' ', 'post_format' ); ?>
 +
 
 +
<!-- 冗長なので削除 gblsm 26-Jun-2015
 +
== Notes ==
 +
* See also: [[Template Tags/next_post_link|next_post_link()]].
 +
-->
 +
 
 +
<div id="Resources">
 +
== 外部リソース ==
 +
</div>
 +
 
 +
* [http://digwp.com/2009/08/wordpress-page-navigation/ Digging into WordPress - Definitive Guide to WordPress Page Navigation]
 +
 
 +
<div id="Change_Log">
 +
== 変更履歴 ==
 +
</div>
 +
 
 +
1.5.0 : 新規導入
 +
 
 +
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
 +
 
 +
<tt>previous_post_link()</tt> は {{Trac|wp-includes/link-template.php}} にあります。
  
== Parameters ==
+
<div id="Related">
 +
== 関連項目 ==
 +
</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>'&amp;laquo; %link'</tt>.
+
{{Pagination}}
; link : (''string'') Link text to display. Defaults to previous post's title (<tt>'%title'</tt>).
+
; in_same_cat : (''boolean'') Indicates whether previous 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 previous post should not be listed. Separate multiple categories with <tt>and</tt>; example: <tt>'1 and 5 and 15'</tt>. There is no default.
+
  
== Related ==
+
{{Tag Footer}}
See also [[Template Tags/next_post_link|next_post_link()]].
+
  
{{Tag Post Tags}}
+
{{原文|Function Reference/previous_post_link|147074}} <!-- 12:41, 6 October 2014 Eliorivero 版 -->
  
{{PHP Function Tag Footer}}
+
{{DEFAULTSORT:Previous_post_link}}
 +
[[Category:テンプレートタグ]]
  
[[en:Template Tags/previous_post_link]]
+
[[en:Function Reference/previous_post_link]]

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

この項目「テンプレートタグ/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最新版との差分