Filters the HTML output of page links for paginated posts.
Parameters
$output
string- HTML output of paginated posts’ page links.
$args
array|string- An array or query string of arguments. See wp_link_pages() for information on accepted arguments.
More Arguments from wp_link_pages( … $args )
Array or string of default arguments.
before
stringHTML or text to prepend to each link. Default is<p> Pages:
.after
stringHTML or text to append to each link. Default is</p>
.link_before
stringHTML or text to prepend to each link, inside the<a>
tag.
Also prepended to the current item, which is not linked.link_after
stringHTML or text to append to each Pages link inside the<a>
tag.
Also appended to the current item, which is not linked.aria_current
stringThe value for the aria-current attribute. Possible values are'page'
,'step'
,'location'
,'date'
,'time'
,'true'
,'false'
. Default is'page'
.next_or_number
stringIndicates whether page numbers should be used. Valid values are number and next. Default is'number'
.separator
stringText between pagination links. Default is ‘ ‘.nextpagelink
stringLink text for the next page link, if available. Default is ‘Next Page’.previouspagelink
stringLink text for the previous page link, if available. Default is ‘Previous Page’.pagelink
stringFormat string for page numbers. The % in the parameter string will be replaced with the page number, so ‘Page %’ generates "Page 1", "Page 2", etc.
Defaults to'%'
, just the page number.echo
int|boolWhether to echo or not. Accepts1|true
or0|false
. Default1|true
.
Source
$html = apply_filters( 'wp_link_pages', $output, $args );
Changelog
Version | Description |
---|---|
3.6.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.