get_next_posts_link()

You are here:

get_next_posts_link( string $label = nullint $max_page )

Parameters Parameters

$label

(string) (Optional) Content for link text.

Default value: null

$max_page

(int) (Optional) Max pages. Default 0.


Top ↑

Return Return

(string|void) HTML-formatted next posts page link.


Top ↑

More Information More Information

Gets a link to the previous set of posts within the current query.

Because post queries are usually sorted in reverse chronological order, get_next_posts_link() usually points to older entries (toward the end of the set) and get_previous_posts_link() usually points to newer entries (toward the beginning of the set).


Top ↑

Source Source

File: wp-includes/link-template.php

2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
function get_next_posts_link( $label = null, $max_page = 0 ) {
    global $paged, $wp_query;
 
    if ( ! $max_page ) {
        $max_page = $wp_query->max_num_pages;
    }
 
    if ( ! $paged ) {
        $paged = 1;
    }
 
    $nextpage = intval( $paged ) + 1;
 
    if ( null === $label ) {
        $label = __( 'Next Page »' );
    }
 
    if ( ! is_single() && ( $nextpage <= $max_page ) ) {
        /**
         * Filters the anchor tag attributes for the next posts page link.
         *
         * @since 2.7.0
         *
         * @param string $attributes Attributes for the anchor tag.
         */
        $attr = apply_filters( 'next_posts_link_attributes', '' );
 
        return '<a href="' . next_posts( $max_page, false ) . "\" $attr>" . preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label ) . '</a>';
    }
}


Top ↑

Changelog Changelog

Changelog
VersionDescription
2.7.0Introduced.
Was this article helpful?
Dislike 0
Views: 2

Cart

Log in

Create an Account
Back to Top