Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: paginate_links

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 3 times in this file.

Line Code
3247           $link .= $args['add_fragment'];
3248
3249           /**
3250            * Filters the paginated links for the given archive pages.
3251            *
3252            * @since 3.0.0
3253            *
3254            * @param string $link The paginated link URL.
3255            */
3256           $page_links[] = '<a class="prev page-numbers" href="' . esc_url( apply_filters( 'paginate_links', $link ) ) . '">' . $args['prev_text'] . '</a>';
3257      endif;
3258      for ( $n = 1; $n <= $total; $n++ ) :
3259           if ( $n == $current ) :
3260                $page_links[] = "<span class='page-numbers current'>" . $args['before_page_number'] . number_format_i18n( $n ) . $args['after_page_number'] . "</span>";
3261                $dots = true;
3262           else :
3263                if ( $args['show_all'] || ( $n <= $end_size || ( $current && $n >= $current - $mid_size && $n <= $current + $mid_size ) || $n > $total - $end_size ) ) :
3264                     $link = str_replace( '%_%', 1 == $n ? '' : $args['format'], $args['base'] );
3265                     $link = str_replace( '%#%', $n, $link );
3266                     if ( $add_args )
3267                          $link = add_query_arg( $add_args, $link );
3268                     $link .= $args['add_fragment'];
3269
3270                     /** This filter is documented in wp-includes/general-template.php */
3271                     $page_links[] = "<a class='page-numbers' href='" . esc_url( apply_filters( 'paginate_links', $link ) ) . "'>" . $args['before_page_number'] . number_format_i18n( $n ) . $args['after_page_number'] . "</a>";
3272                     $dots = true;
3273                elseif ( $dots && ! $args['show_all'] ) :
3274                     $page_links[] = '<span class="page-numbers dots">' . __( '&hellip;' ) . '</span>';
3275                     $dots = false;
3276                endif;
3277           endif;
3278      endfor;
3279      if ( $args['prev_next'] && $current && ( $current < $total || -1 == $total ) ) :
3280           $link = str_replace( '%_%', $args['format'], $args['base'] );
3281           $link = str_replace( '%#%', $current + 1, $link );
3282           if ( $add_args )
3283                $link = add_query_arg( $add_args, $link );
3284           $link .= $args['add_fragment'];
3285
3286           /** This filter is documented in wp-includes/general-template.php */
3287           $page_links[] = '<a class="next page-numbers" href="' . esc_url( apply_filters( 'paginate_links', $link ) ) . '">' . $args['next_text'] . '</a>';
3288      endif;
3289      switch ( $args['type'] ) {
3290           case 'array' :
3291                return $page_links;
3292
3293           case 'list' :
3294                $r .= "<ul class='page-numbers'>\n\t<li>";
3295                $r .= join("</li>\n\t<li>", $page_links);
3296                $r .= "</li>\n</ul>\n";