Changeset 27600

Timestamp:

03/18/2014 11:30:55 PM (13 years ago)

Author:

johnbillion

Message:

Introduce before_page_number and after_page_number arguments for paginate_links(). Fixes #24709. Props grahamarmfield.

File:

• trunk/src/wp-includes/general-template.php (modified) (4 diffs)

trunk/src/wp-includes/general-template.php

@@ -1984 +1984 @@
  * 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
  *
@@ -2003 +2009 @@
                 'type' => 'plain',
                 'add_args' => false, // array of query args to add
-                'add_fragment' => ''
+                'add_fragment' => '',
+                'before_page_number' => '',
+                'after_page_number' => ''
         );
 
@@ -2032 +2040 @@
         for ( $n = 1; $n <= $total; $n++ ) :
                 if ( $n == $current ) :
-                        $page_links[] = "<span class='page-numbers current'>" . number_format_i18n($n) . "</span>";
+                        $page_links[] = "<span class='page-numbers current'>" . $before_page_number . number_format_i18n( $n ) . $after_page_number . "</span>";
                         $dots = true;
                 else :
@@ -2041 +2049 @@
                                         $link = add_query_arg( $add_args, $link );
                                 $link .= $add_fragment;
-                                $page_links[] = "<a class='page-numbers' href='" . esc_url( apply_filters( 'paginate_links', $link ) ) . "'>" . number_format_i18n($n) . "</a>";
+                                $page_links[] = "<a class='page-numbers' href='" . esc_url( apply_filters( 'paginate_links', $link ) ) . "'>" . $before_page_number . number_format_i18n( $n ) . $after_page_number . "</a>";
                                 $dots = true;
                         elseif ( $dots && !$show_all ) :