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

把长内容文章进行内容分页显示是一种流行,或者可能用户体验较好的显示方式,常见于各大中小型新闻资讯类网站。今天要介绍的函数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 – 字符串。选择使用数字分页还是上一页、下一页文本分页,可选numbernext,默认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

发表留言