Displays a paginated navigation to next/previous set of posts, when applicable.
Parameters
$argsarrayoptional- See get_the_posts_pagination() for available arguments.
More Arguments from get_the_posts_pagination( … $args )
Array or string of arguments for generating paginated links for archives.
basestringBase of the paginated url. Default empty.formatstringFormat for the pagination structure. Default empty.totalintThe total amount of pages. Default is the value WP_Query‘smax_num_pagesor 1.currentintThe current page number. Default is'paged'query var or 1.aria_currentstringThe value for the aria-current attribute. Possible values are'page','step','location','date','time','true','false'. Default is'page'.show_allboolWhether to show all pages. Default false.end_sizeintHow many numbers on either the start and the end list edges.
Default 1.mid_sizeintHow many numbers to either side of the current pages. Default 2.prev_nextboolWhether to include the previous and next links in the list. Default true.prev_textstringThe previous page text. Default ‘« Previous’.next_textstringThe next page text. Default ‘Next »’.typestringControls format of the returned value. Possible values are'plain','array'and'list'. Default is'plain'.add_argsarrayAn array of query args to add. Default false.add_fragmentstringA string to append to each link. Default empty.before_page_numberstringA string to appear before the page number. Default empty.after_page_numberstringA string to append after the page number. Default empty.
Default:
array()
Source
function the_posts_pagination( $args = array() ) {
echo get_the_posts_pagination( $args );
}
Changelog
| Version | Description |
|---|---|
| 4.1.0 | Introduced. |
Displays pagination with additional page links
Displays pagination with alternative prev/next text