get_previous_posts_link()

You are here:
  • Help
  • get_previous_posts_link()

get_previous_posts_link( string $label = null )

Retrieves the previous posts page link.

Parameters Parameters

$label

(string) (Optional) Previous page link text.

Default value: null


Top ↑

Return Return

(string|void) HTML-formatted previous page link.


Top ↑

Source Source

File: wp-includes/link-template.php

2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
function get_previous_posts_link( $label = null ) {
    global $paged;
 
    if ( null === $label ) {
        $label = __( '« Previous Page' );
    }
 
    if ( ! is_single() && $paged > 1 ) {
        /**
         * Filters the anchor tag attributes for the previous posts page link.
         *
         * @since 2.7.0
         *
         * @param string $attributes Attributes for the anchor tag.
         */
        $attr = apply_filters( 'previous_posts_link_attributes', '' );
        return '<a href="' . previous_posts( false ) . "" $attr>" . preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label ) . '</a>';
    }
}


Top ↑

Changelog Changelog

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