Changeset 27600

Timestamp:

03/18/2014 11:30:55 PM (11 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 ) :