Generic page links generating function

[mdawaffe]

This has been talked about an hackers a couple times and on at least one bug hunt.

Attached: paginate_links()

1. 'base' => base link with %_% to be replaced by:
2. 'format' => format of replacement with %#% to be replaced by page number.
3. 'total' => total # of pages.
4. 'current' => current page.
5. 'show_all' => show all links or just the first, last and those near current?
6. 'prev_next' => show previous and next links?
7. 'prev_text' =>, 'next_text' => text for previous and next links.
8. 'end_size' => how many links to show at the beginning of the range.
9. 'mid_size' => how many links to show on either side of the current page.
10. 'type' => 'array', 'list', 'plain'.
11. 'add_args' => array of args to add with add_query_arg()

Modifies WP_User_Search to use this function. See #2793.

[mdawaffe]

masquerade, thoughts?

[mdawaffe]

update

[mdawaffe]

3159b.diff

1. update patch to @4261

[ryan]

(In [4275]) paginate_links() from mdawaffe. fixes #3159