Template Tags/link pages « WordPress Codex

Codex Resources

Template Tags/link pages

This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement if one exists.

1 Description
2 Replace With
3 Usage
4 Examples
- 4.1 Default Usage
- 4.2 Page-links in Paragraph Tags
5 Parameters
6 Related

Description

Displays page-links for paginated posts (i.e. includes the  Quicktag one or more times). This tag works similarly to wp_link_pages(). This tag must be within The_Loop.

Replace With

wp_link_pages().

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.