get_next_posts_link() - Retrieves the next posts page link.

get_next_posts_link() – Retrieves the next posts page link.

You appear to be a bot. Output may be restricted

Description

Retrieves the next posts page link.

Usage

$string|void = get_next_posts_link( $label, $max_page );

Parameters

$label: ( string ) optional – Content for link text.
$max_page: ( int ) optional – Optional. Max pages. Default 0.

Returns

string|void HTML-formatted next posts page link.

Source

File name: wordpress/wp-includes/link-template.php

Lines:

1 to 37 of 37

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;
  }

  $next_page = (int) $paged + 1;

  if ( null === $label ) {
    $label = __( 'Next Page &raquo;' );
  }

  if ( ! is_single() && ( $next_page <= $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 sprintf(
      '<a href="%1$s" %2$s>%3$s</a>',
      next_posts( $max_page, false ),
      $attr,
      preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label )
    );
  }
}

View on GitHub View on Trac