Template Tags/link pages
Материал из WordPress Wiki
Содержание |
Description
Displays page-links for paginated posts (i.e. includes the <!--nextpage--> Quicktag one or more times). This tag works similarly to wp_link_pages(). This tag must be within The_Loop.
Replace With
Usage
%%% <?php link_pages('before', 'after', 'next_or_number',
'nextpagelink', 'previouspagelink', 'pagelink',
'more_file'); ?> %%%
Examples
Default Usage
Displays page-links by default with line breaks before and after, using next page and previous page, listing them with page numbers as Page 1, Page 2 and so on.
<?php link_pages(); ?>
Page-links in Paragraph Tags
Displays page-links wrapped in paragraph tags.
<?php link_pages('<p>', '</p>', 'number', '', '', 'page %'); ?>
Parameters
- before
- (string) Text to put before all the links. Defaults to '<br />'.
- after
- (string) Text to put after all the links. Defaults to '<br />'.
- next_or_number
- (string) Indicates whether page numbers should be used. Valid values are:
- 'number' (Default)
- 'next' (Valid in WordPress 1.5 or after)
- nextpagelink
- (string) Text for link to next page. Defaults to 'next page'. (Valid in WordPress 1.5 or after)
- previouspagelink
- (string) Text for link to previous page. Defaults to 'previous page'. (Valid in WordPress 1.5 or after)
- pagelink
- (string) Format string for page numbers. '%' in the string will be replaced with the number, so 'Page %' would generate "Page 1", "Page 2", etc. Defaults to '%'.
- more_file
- (string) Page the links should point to. Defaults to the current page.
Related
To use the query string to pass parameters, see wp_link_pages()