wp_link_pages函数实现文章内容分页

背景

当一篇文章内容较长，而用户的WordPress主题没有支持侧边栏随滚动功能时页面的布局可能会显得混乱。WordPress提供了一个名为wp_link_pages的函数，它能够帮助您解决这个问题。该函数的作用是将一篇长篇文章拆分成多个页面从而实现文章内容的分页显示，这一功能非常有用，可以确保用户文章内容在不影响网页排版的情况下被逐页呈现给读者。wp_link_pages函数位于wp-includes/post-template.php文件中，它包含了大量的代码，本文不贴出具体源码了。

函数用法

<?php wp_link_pages( $args ); ?>

参数说明

<? 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作为分页页码：

<?php wp_link_pages();?>

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

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

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

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

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

分页方法

在文章内容页模板single.php中找到输出文章内容的WordPress函数the_content，然后在下面添加一行代码：

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

<!–nextpage–>