next_posts_link() WordPress Function
The next_posts_link() function displays a link to the next page of posts, if there is one. This is useful for paginated posts and archives, where you want to give the reader an easy way to view more content. The function accepts two parameters: The first is the label for the link. This can be either a string or an array. The second is an array of HTML attributes for the link.
next_posts_link( string $label = null, int $max_page ) #
Displays the next posts page link.
Parameters
- $label
(string)(Optional)Content for link text.
Default value: null
- $max_page
(int)(Optional) Max pages. Default 0.
More Information
This function prints a link to the next set of posts within the current query.
If you need the values for use in PHP, use get_next_posts_link().
Because post queries are usually sorted in reverse chronological order, next_posts_link() usually points to older entries (toward the end of the set) and previous_posts_link() usually points to newer entries (toward the beginning of the set).
Parameter $max_pages is the limit the number of pages on which the link is displayed. The default value “0” means “no limit”.
This function will not work (fail silently) if mysql.trace_mode is enabled in your php.ini. If you can’t edit that file, try adding ini_set( 'mysql.trace_mode', 0 ); to your theme’s functions.php.
See also: previous_posts_link() and next_post_link().
Source
File: wp-includes/link-template.php
function next_posts_link( $label = null, $max_page = 0 ) {
echo get_next_posts_link( $label, $max_page );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 0.71 | Introduced. |