说明

该标签为分页文章（如文章中包含一个或一个以上<!–nextpage–> 快速标签）显示分页链接。与link_pages()运行方式几乎一致，区别在于，该标签的参数以查询字符串形式传递。该标签必须在WordPress主循环（loop）。

用法

 <?php wp_link_pages( $args ); ?> 

默认用法

<?php $args = array(
‘before’ => ‘<p>’ . __(‘Pages:’),
‘after’ => ‘</p>’,
‘link_before’ => ,
‘link_after’ => ,
‘next_or_number’ => ‘number’,
‘nextpagelink’ => __(‘Next page’),
‘previouspagelink’ => __(‘Previous page’),
‘pagelink’ => ‘%’,
‘more_file’ => ,
‘echo’ => 1 ); ?>

参数

before

（字符串）显示在所有链接前的文本。默认值为<p>Pages:。

after

（字符串）显示在所有链接后的文本。默认值为</p>。.

link_before

（字符串）链接文本前的文字。默认值为（blank）（空）。在WP 2.7以及更高版本中，该参数为必要参数。

link_after

（字符串）链接文本后的文字。默认值为（blank）（空）。在WP 2.7以及更高版本中，该参数为必要参数。

next_or_number

（字符串）是否使用页数。有效值包括：

• number（默认）
• next（WP 1.5及之后版本中有效）

nextpagelink

（字符串）下一页链接的链接文本。默认值为Next page（下一页）。（WP 1.5及之后版本中有效）

previoustpagelink

（字符串）上一页链接的链接文本。默认值为Previous page（上一页）。（WP 1.5及之后版本中有效）

pagelink

（字符串）页数的格式化字符串。字符串中的%会被替换为数字，因此Page % 会转换成”Page 1″、”Page 2″等。默认为%。

more_file

（字符串）链接所指向的网页。默认为当前页面。

echo

（布尔型）响应或返回结果。默认值为true。有效值包括：

• 1 （True）—— 默认值
• 0（False）

示例

默认用法

默认显示分页链接，链接前后有段落标签，分页链接文本为Next page 与Previous page，所有页面按1、2、3这样的编号顺序显示。

<?php wp_link_pages(); ?>  

段落标签中的分页链接

显示由段落标签包裹着的分页链接。

<?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?>  

DIV中的分页链接

在CSS引用的DIV中显示分页链接（div id=”page-links”）。

<?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?>

历史记录

• 始见于WordPress 0.71版本

源文件

wp_link_pages()位于wp-includes/post-template.php

分类：中文手册