把长内容文章进行内容分页显示是一种流行，或者可能用户体验较好的显示方式，常见于各大中小型新闻资讯类网站。今天要介绍的函数wp_link_pages()则是WordPress的内容分页函数，通过wp_link_pages()函数可以实现wordpress网站长文章内容分页显示，和众多资讯网站一样的分页效果。

函数代码

1

<?php wp_link_pages( $args ); ?>

默认参数：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

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

参数说明：

• before – 字符串。所有链接之前的文本，默认值<p>Pages：（通常和after搭配使用）
• after – 字符串。所有链接之后的文本，默认值</p>（通常和before搭配使用）
• link_before – 字符串。单个链接文本之前的文本，默认为空
• link_after – 字符串。单个链接文本之后的文本，默认为空
• next_or_number – 字符串。选择使用数字分页还是上一页、下一页文本分页，可选number或next，默认number
• separator – 字符串。页码分隔符，默认似乎是空格
• nextpagelink – 字符串。下一页链接文本，默认Next page
• previouspagelink – 字符串。上一页链接文本，默认Previous page
• pagelink – 字符串。页码的字符串格式，百分号%会被替换成数字，如页%会生成 “页1”、“页2”这样的样式
• echo – 布尔型。选择是要返回结果还是直接输出，默认为True，返回NULL或返回内容；设置为false，则直接输出HTML格式

示例

1、全部使用默认值，下一页、上一页使用段落标签，Page 1，Page 2作为分页页码：

1

<?php wp_link_pages(); ?>

2、使用段落标签包围分页链接

1

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

3、使用div包围分页链接，便于CSS样式修改

1

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

提示：可以CSS中对#page-links进入样式修改

使用方法

1、在主题的内容模板文件single.php（部分主题可能是content.php或其它文件）中找到代码：

1

<?php the_content();?>

在其下面添加代码：

1

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

然后保存文件

2、在编辑文章时，把编辑器切换为“文本”模式，在要分页的地方，添加分页标签：

1

<!–nextpage–>

发布文章即可实现长内容分页功能。

源文件

wp_link_pages()函数位置：wp-includes/post-template.php

WordPress官方函数：https://codex.wordpress.org/Function_Reference/wp_link_pages