WordPress 中文文档

出自WordPress Chinese 中文文档

wordpress.org.cn

Description

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

This tag must be used in The Loop.

Usage

%%% ?php next_post_link('format', 'link', 'in_same_cat', 'excluded_categories'); ? %%%

Examples

Default Usage

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:10pxNext Post Title raquo;/div

%%% ?php next_post_link(); ? %%%

Bold Post Title As Link

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

div style=border:1px solid blue; width:50%; padding:10pxstrongNext Post Title/strong/div

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

Text As Link, Without Post Title, Within Same Category

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:10pxNext post in category/div

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

Within Same Category, Excluding One

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:10pxNext post in category/div

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

Parameters

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 ttTRUE/tt, only posts from the current category will be displayed. Options are:

• ttTRUE/tt
• ttFALSE/tt (Default)

Note that if the post is in both the parent and subcategory, or more than one category, the next post link will lead to the next post in any of those categories.

excluded_categories 

(string) Numeric category ID(s) from which the next post should not be listed. Separate multiple categories with ttand/tt; example: tt'1 and 5 and 15'/tt. There is no default.

In Wordpress 2.2 (only), apparently, concatenating multiple categories for exclusion is done with a comma, not ttand/tt; example: tt'1, 5, 15'/tt. Still no default.

Notes

See also previous_post_link().

Resources

• Digging into Wordpress - Definitive Guide to WordPress Page Navigation
• Forum discussion on using a image with next_post_link

Related

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

includeonlydiv style=clear:both; background-color:#F7F7F7; border:1px solid #CCCCCC; color:#000000; padding:7px; margin:0.5em auto 0.5em auto; vertical-align:middle;See also index of Function Reference and index of Template Tags./div/includeonlynoinclude

Description

This Template is used by Codex:Template Messages.

Usage

pre 已侦测回归模板: Template:Message /pre

Result

已侦测回归模板: Template:Message

/noinclude