WordPress at a glance

get_posts_nav_link() WP 1.0

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

  • Global. WP_Query. $wp_query
Is the basis for: posts_nav_link()

No Hooks.

Return

String. The posts link navigation.

Usage

get_posts_nav_link( $args );
$args(string/array)

Arguments to build the post pages link navigation.

  • $sep (string)
    Separator character.
    Default: '—'

  • $prelabel (string)
    Link text to display for the previous page link.
    Default: '« Previous Page'

  • $nxtlabel (string)
    Link text to display for the next page link.
    Default: 'Next Page »'

Default: array()

Code of get_posts_nav_link: wp-includes/link-template.php VER 4.9.8

<?php
function get_posts_nav_link( $args = array() ) {
	global $wp_query;

	$return = '';

	if ( !is_singular() ) {
		$defaults = array(
			'sep' => ' &#8212; ',
			'prelabel' => __('&laquo; Previous Page'),
			'nxtlabel' => __('Next Page &raquo;'),
		);
		$args = wp_parse_args( $args, $defaults );

		$max_num_pages = $wp_query->max_num_pages;
		$paged = get_query_var('paged');

		//only have sep if there's both prev and next results
		if ($paged < 2 || $paged >= $max_num_pages) {
			$args['sep'] = '';
		}

		if ( $max_num_pages > 1 ) {
			$return = get_previous_posts_link($args['prelabel']);
			$return .= preg_replace('/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $args['sep']);
			$return .= get_next_posts_link($args['nxtlabel']);
		}
	}
	return $return;

}

Related Functions

From tag: Navigation pagination

More from category: Archives

No comments
    Hello, !     Log In . Register