wp_link_pages() | wordpress文章内容分页函数

函数

$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
);
wp_link_pages( $args );

描述

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

参数

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 格式

例子

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

wp_link_pages();

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

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

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

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

使用方法

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

the_content();

在其下面添加代码：

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

然后保存文件。

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

<span id="more-2865"></span>

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

源文件

wp-includes/post-template.php

官方文档

https://codex.wordpress.org/Function_Reference/wp_link_pages