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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(様式・リンク調整、未翻訳)
(和訳完了。非推奨タグへのリンクはコメントアウトしました。)
1行目: 1行目:
{{NeedTrans}}
 
 
 
<div id="Description">
 
<div id="Description">
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
  
Used on single post [[用語集#Permalink|permalink]] pages, this template tag displays a link to the previous post which exists in chronological order from the current post.
+
個別記事で他のページへの[[用語集#Permalink|パーマリンク]]を表示するのに使う、このテンプレートタグは日付順で表示している記事からみてひとつ前の記事へのリンクを表示します。
  
This tag must be used in [[The Loop]].
+
このタグは[[The Loop|ループ]]内で使用しなければなりません。
  
 
<div id="Usage">
 
<div id="Usage">
13行目: 11行目:
 
</div>
 
</div>
  
  <?php previous_post_link('format', 'link', in_same_cat,  
+
  <?php previous_post_link('format', 'link', in_same_cat, 'excluded_categories'); ?>
                        'excluded_categories'); ?>
+
  
 
<div id="Examples">
 
<div id="Examples">
23行目: 20行目:
 
=== 初期設定での使用 ===
 
=== 初期設定での使用 ===
 
</div>
 
</div>
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 [[テンプレートタグ/previous_post|previous_post()]].
+
前の記事 (記事の作成日順) へのリンクとそのタイトルをアンギュラークウォート (&laquo;) を使って表示します。<!-- デフォルトでは、このタグは [[テンプレートタグ/previous_post|previous_post()]] と同様の動作をします。-->
  
 
<div class="example">[[#Examples|&laquo; Previous Post Title]]</div>
 
<div class="example">[[#Examples|&laquo; Previous Post Title]]</div>
30行目: 27行目:
  
 
<div id="Bold_Post_Title_As_Link">
 
<div id="Bold_Post_Title_As_Link">
===Bold Post Title As Link===
+
=== リンクのタイトルを太字にする ===
 
</div>
 
</div>
Displays link with previous chronological post's title wrapped in 'strong' tags (typically sets text to bold).
+
ひとつ前の記事のタイトルを「strong」タグを使って表示します (太字になって強調されます)
  
 
<div class="example">[[#Examples|'''Previous Post Title''']]</div>
 
<div class="example">[[#Examples|'''Previous Post Title''']]</div>
  
  <?php previous_post_link('<strong>%link</strong>'); ?>
+
  <?php previous_post_link('&lt;strong&gt;%link&lt;/strong&gt;'); ?>
  
 
<div id="Text_As_Link.2C_Without_Post_Title.2C_Within_Same_Category">
 
<div id="Text_As_Link.2C_Without_Post_Title.2C_Within_Same_Category">
===Text As Link, Without Post Title, Within Same Category===
+
=== 同じカテゴリー内で、リンクテキストに記事名を使わず、任意の文字にする ===
 
</div>
 
</div>
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.
+
表示している記事と同じカテゴリー内のひとつ前の記事へのリンクのテキストをカスタマイズして表示します。記事名はここでは表示されません。「Previous in category」というテキストはあなたの要求にあわせて自由にカスタマイズできます。
  
 
<div class="example">[[#Examples|Previous in category]]</div>
 
<div class="example">[[#Examples|Previous in category]]</div>
48行目: 45行目:
  
 
<div id="Within_Same_Category.2C_Excluding_One">
 
<div id="Within_Same_Category.2C_Excluding_One">
===Within Same Category, Excluding One===
+
=== 同一カテゴリー内で、特定のカテゴリーを除外する ===
 
</div>
 
</div>
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.
+
13 (カテゴリー ID の数値) のカテゴリーだけを除外して、同じカテゴリーのひとつ前の記事へのリンクを表示します。除外したいカテゴリーの番号は自由に変えられます。複数のカテゴリーを除外するには「<tt> and </tt>」で区切ってください。
  
 
<div class="example">[[#Examples|Previous in category]]</div>
 
<div class="example">[[#Examples|Previous in category]]</div>
60行目: 57行目:
 
</div>
 
</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>.
+
; format : (''文字列'') リンクの文字列の書式。リンクの前後に追加する文字を設定できます。「<tt>%link</tt>」と文字列内に表記すると「link」 (下のパラメータ) に置き換えられます。「<tt>Go to %link</tt>」とすると「Go to <a href=...」となります。デフォルトは「<tt>&amp;laquo; %link</tt>」です
; 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:
+
; link : (''文字列'') 表示するリンクのテキスト。デフォルトは前の記事のタイトル (<tt>%title</tt>) です
 +
 
 +
; in_same_cat : (''論理値'') 表示している記事と同じカテゴリーの前の記事を表示するかどうかを設定します。<tt>TRUE</tt> の場合、同じカテゴリーの記事だけが表示されます
 
:* <tt>TRUE</tt>  
 
:* <tt>TRUE</tt>  
:* <tt>FALSE</tt> (Default)
+
:* <tt>FALSE</tt> (デフォルト)
; 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.
+
 
 +
; excluded_categories : (''文字列'') 表示させたくない記事のカテゴリー ID の番号。複数のカテゴリーを除外する場合は <tt>and</tt> で区切ってください (例: <tt>'1 and 5 and 15'</tt>)。デフォルトはありません
  
 
<div id="Related">
 
<div id="Related">

2008年4月6日 (日) 14:52時点における版

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

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

使い方

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

用例

初期設定での使用

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

<?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=...」となります。デフォルトは「&laquo; %link」です
link 
(文字列) 表示するリンクのテキスト。デフォルトは前の記事のタイトル (%title) です
in_same_cat 
(論理値) 表示している記事と同じカテゴリーの前の記事を表示するかどうかを設定します。TRUE の場合、同じカテゴリーの記事だけが表示されます
  • TRUE
  • FALSE (デフォルト)
excluded_categories 
(文字列) 表示させたくない記事のカテゴリー ID の番号。複数のカテゴリーを除外する場合は and で区切ってください (例: '1 and 5 and 15')。デフォルトはありません

参照: 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最新版との差分