Ticket #29808: 29808.diff

src/wp-includes/link-template.php

@@ -2186 +2186 @@
 }
 
 /**
+ * Return navigation to next/previous post when applicable.
+ *
+ * @since 4.1.0
+ * @uses wp_parse_args()
+ * @uses get_previous_post_link()
+ * @uses get_next_post_link()
+ *
+ * @param array $args Optional.
+ * @return string
+ */
+function get_post_navigation( $args = array() ) {
+        $args = wp_parse_args( $args, array(
+                'prev_text' => _x( '<span class="meta-nav">&larr;</span> %title', 'Previous post link' ),
+                'next_text' => _x( '%title <span class="meta-nav">&rarr;</span>', 'Next post link' ),
+        ) );
+
+        $navigation = '';
+        $previous   = get_previous_post_link( '<div class="nav-previous">%link</div>', $args['prev_text'] );
+        $next       = get_next_post_link( '<div class="nav-next">%link</div>', $args['next_text'] );
+
+        // Don't print empty markup if there's nowhere to navigate.
+        if ( $next || $previous ) {
+                $navigation = _navigation_markup( $next . $previous, 'post-navigation', __( 'Post navigation' ) );
+        }
+
+        return $navigation;
+}
+
+/**
+ * Display navigation to next/previous post when applicable.
+ *
+ * @since 4.1.0
+ * @uses get_post_navigation()
+ */
+function the_post_navigation( $args = array() ) {
+        echo get_post_navigation( $args );
+}
+
+/**
+ * Return navigation to next/previous set of posts when applicable.
+ *
+ * @since 4.1.0
+ * @uses get_next_posts_link()
+ * @uses get_previous_posts_link()
+ *
+ * @global WP_Query $wp_query WordPress Query object.
+ * @param array $args Optional.
+ * @return string
+ */
+function get_paging_navigation( $args = array() ) {
+        $navigation = '';
+
+        // Don't print empty markup if there's only one page.
+        if ( $GLOBALS['wp_query']->max_num_pages < 2 ) {
+                return $navigation;
+        }
+
+        $args = wp_parse_args( $args, array(
+                'prev_text' => __( '<span class="meta-nav">&larr;</span> Older posts' ),
+                'next_text' => __( 'Newer posts <span class="meta-nav">&rarr;</span>' ),
+        ) );
+
+        $next_link = get_next_posts_link( $args['prev_text'] );
+        $prev_link = get_previous_posts_link( $args['next_text'] );
+
+        if ( $next_link ) {
+                $navigation .= '<div class="nav-previous">' . $next_link . '</div>';
+        }
+
+        if ( $prev_link ) {
+                $navigation .= '<div class="nav-next">' . $prev_link . '</div>';
+        }
+
+        return _navigation_markup( $navigation );
+}
+
+/**
+ * Display navigation to next/previous set of posts when applicable.
+ *
+ * @since 4.1.0
+ * @uses get_paging_navigation()
+ *
+ * @param array $args Optional.
+ */
+function the_paging_navigation( $args = array() ) {
+        echo get_paging_navigation( $args );
+}
+
+/**
+ * Return a paginated navigation to next/previous set of posts,
+ * when applicable.
+ *
+ * @since 4.1.0
+ * @uses wp_parse_args()
+ * @uses paginate_links()
+ *
+ * @param array $args Optional.
+ * @return string
+ */
+function get_pagination( $args = array() ) {
+        $navigation = '';
+
+        // Don't print empty markup if there's only one page.
+        if ( $GLOBALS['wp_query']->max_num_pages < 2 ) {
+                return $navigation;
+        }
+
+        $args = wp_parse_args( $args, array(
+                'mid_size'  => 1,
+                'prev_text' => __( '&larr; Previous' ),
+                'next_text' => __( 'Next &rarr;' ),
+        ) );
+
+        // Set up paginated links.
+        $links = paginate_links( $args );
+
+        if ( $links ) {
+                $navigation = _navigation_markup( $links, 'pagination' );
+        }
+
+        return $navigation;
+}
+
+/**
+ * Display a paginated navigation to next/previous set of posts,
+ * when applicable.
+ *
+ * @since 4.1.0
+ * @uses get_pagination()
+ *
+ * @param array $args Optional.
+ */
+function the_pagination( $args = array() ) {
+        echo get_pagination( $args );
+}
+
+/**
+ * Wraps passed links in navigational markup.
+ *
+ * @since 4.1.0
+ * @access private
+ *
+ * @param string $links
+ * @param string $class Optional.
+ * @param string $screen_reader_text Optional.
+ * @return string
+ */
+function _navigation_markup( $links, $class = 'paging-navigation', $screen_reader_text = '' ) {
+        if ( empty( $screen_reader_text ) ) {
+                $screen_reader_text = __( 'Posts navigation' );
+        }
+
+        $template = '<nav class="navigation %1$s" role="navigation">
+                                        <h1 class="screen-reader-text">%2$s</h1>
+                                        <div class="nav-links">%3$s</div>
+                                </nav>';
+
+        return sprintf( $template, $class, esc_html( $screen_reader_text ), $links );
+}
+
+/**
  * Retrieve comments page number link.
  *
  * @since 2.7.0