WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/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. See also wp-includes/deprecated.php. Use any of these functions instead.

Contents

Description

Displays page-links for paginated posts (i.e. includes the <!--nextpage--> Quicktag one or more times). This tag must be within The_Loop.

Replace With

Usage

 <?php link_pages$before$after$next_or_number$nextpagelink$previouspagelink$pagelink$more_file ); ?> 

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.

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 %'); ?>

Change Log

Related

See also index of Function Reference and index of Template Tags.