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

作者猫斯基 2015-02-07 121 人读过

最新文章

函数

$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

本文由 猫斯基 原创发布。

著作权均归用户本人所有。独家文章转载,请联系本站管理员。获得授权后,须注明本文地址! 本文地址:https://maosiji.com/wordpress/wordpress-wp_link_pages.html