get_next_posts_link()

You are here:
In this article

get_next_posts_link( string $label = null, int $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>';
    }
}

Expand full source code View on Trac

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/query.php: is_single()

Determines whether the query is for an existing single post.
wp-includes/link-template.php: next_posts()

Displays or retrieves the next posts page link.
wp-includes/link-template.php: next_posts_link_attributes

Filters the anchor tag attributes for the next posts page link.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/link-template.php: get_the_posts_navigation()

Returns the navigation to next/previous set of posts, when applicable.
wp-includes/link-template.php: next_posts_link()

Displays the next posts page link.
wp-includes/link-template.php: get_posts_nav_link()

Retrieves the post pages link navigation for previous and next pages.

Top ↑

Changelog Changelog

Changelog
Version Description
2.7.0 Introduced.
Was this article helpful?
Dislike 0
Views: 19