Ticket #24709: 24709.2.patch

wp-includes/general-template.php

@@ -1983 +1983 @@
  * It is possible to add query vars to the link by using the 'add_args' argument
  * and see {@link add_query_arg()} for more information.
  *
+ * The 'before_page_number' and 'after_page_number' arguments allow users to 
+ * augment the links themselves. Typically this might be to add context to the
+ * numbered links so that screen reader users understand what the links are for.
+ * The text strings are added before and after the page number - within the 
+ * anchor tag.
+ *
  * @since 2.1.0
  *
  * @param string|array $args Optional. Override defaults.
@@ -2002 +2008 @@
                 'mid_size' => 2,
                 'type' => 'plain',
                 'add_args' => false, // array of query args to add
-                'add_fragment' => ''
+                'add_fragment' => '',
+                'before_page_number' => '',
+                'after_page_number' => ''
         );
 
         $args = wp_parse_args( $args, $defaults );
@@ -2032 +2040 @@
         for ( $n = 1; $n <= $total; $n++ ) :
                 $n_display = number_format_i18n($n);
                 if ( $n == $current ) :
-                        $page_links[] = "<span class='page-numbers current'>$n_display</span>";
+                        $page_links[] = "<span class='page-numbers current'>" . $before_page_number . $n_display . $after_page_number . "</span>";
                         $dots = true;
                 else :
                         if ( $show_all || ( $n <= $end_size || ( $current && $n >= $current - $mid_size && $n <= $current + $mid_size ) || $n > $total - $end_size ) ) :
@@ -2041 +2049 @@
                                 if ( $add_args )
                                         $link = add_query_arg( $add_args, $link );
                                 $link .= $add_fragment;
-                                $page_links[] = "<a class='page-numbers' href='" . esc_url( apply_filters( 'paginate_links', $link ) ) . "'>$n_display</a>";
+                                $page_links[] = "<a class='page-numbers' href='" . esc_url( apply_filters( 'paginate_links', $link ) ) . "'>" . $before_page_number . $n_display . $after_page_number . "</a>";
                                 $dots = true;
                         elseif ( $dots && !$show_all ) :
                                 $page_links[] = '<span class="page-numbers dots">' . __( '&hellip;' ) . '</span>';

wp-includes/link-template.php

@@ -2172 +2172 @@
                 'total' => $max_page,
                 'current' => $page,
                 'echo' => true,
-                'add_fragment' => '#comments'
+                'add_fragment' => '#comments',
+                'before_page_number' => '',
+                'after_page_number' => ''
         );
         if ( $wp_rewrite->using_permalinks() )
                 $defaults['base'] = user_trailingslashit(trailingslashit(get_permalink()) . 'comment-page-%#%', 'commentpaged');