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

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

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2008年4月3日 (木) 05:01時点におけるBono (トーク | 投稿記録)による版 (en:Template Tags/previous_post_link 2007年11月6日 (火) 02:34 Kafkaesqui 版)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

Description

Used on single post permalink pages, this template tag displays a link to the previous post which exists in chronological order from the current post.

This tag must be used in The Loop.

Usage

%%% <?php previous_post_link('format', 'link', in_same_cat,

                        'excluded_categories'); ?> %%%

Examples

Default Usage

Displays link with left angular quote («) followed by the post title of the previous post (chronological post date order). By default, this tag works like previous_post().

« Previous Post Title
<?php previous_post_link(); ?>

Bold Post Title As Link

Displays link with previous chronological post's title wrapped in 'strong' tags (typically sets text to bold).

Previous Post Title

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

Text As Link, Without Post Title, 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.

Previous in category

%%% <?php previous_post_link('%link', 'Previous in category', TRUE); ?> %%%

Within Same Category, 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 " and " as a delimiter.

Previous in category

%%% <?php previous_post_link('%link', 'Previous in category', TRUE, '13'); ?> %%%

Parameters

format 
(string) Format string for the link. This is where to control what comes before and after the link. '%link' in string will be replaced with whatever is declared as 'link' (see next parameter). 'Go to %link' will generate "Go to <a href=..." Put HTML tags here to style the final results. Defaults to '&laquo; %link'.
link 
(string) Link text to display. Defaults to previous post's title ('%title').
in_same_cat 
(boolean) Indicates whether previous post must be within the same category as the current post. If set to TRUE, only posts from the current category will be displayed. Options are:
  • TRUE
  • FALSE (Default)
excluded_categories 
(string) Numeric category ID(s) from which the previous post should not be listed. Separate multiple categories with and; example: '1 and 5 and 15'. There is no default.

Related

See also 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 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。