模板标签-wp_link_pages()

0条评论

说明

该标签为分页文章(如文章中包含一个或一个以上<!--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 pagePrevious 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