性价比最高的香港ASP、PHP主机提供商
做网站,就上凡科建站

WordPress 分页链接函数 paginate_links

Loading
0
Comodo SLL证书促销 - 免费ssl证书申请_ssl证书购买_ev ssl证书_https证书购买 - GDCA_数安时代

如果你是 WordPress主题开发者,你肯定需要实现存档分页导航功能,虽然目前有不少方法,但是倡萌还是推荐尽量使用官方函数来实现。今天介绍的函数 paginate_links,可以用来检索归档后的页面分页链接。其实,该函数可以被用在任何地方实现分页链接(例如:WordPress 为自定义表格/列表添加分页导航功能)。

paginate_links_wpdaxue_com

1
<?php echo paginate_links( $args ); ?>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<?php $args = array(
	'base'         => '%_%',
	'format'       => '?page=%#%',
	'total'        => 1,
	'current'      => 0,
	'show_all'     => False,
	'end_size'     => 1,
	'mid_size'     => 2,
	'prev_next'    => True,
	'prev_text'    => __('« Previous'),
	'next_text'    => __('Next »'),
	'type'         => 'plain',
	'add_args'     => False,
	'add_fragment' => '',
	'before_page_number' => '',
	'after_page_number' => ''
); ?>
  • base – 用来参考的网址
  • format – 用于URL的分页结构,例如: /page/3
  • total – 总页数
  • current – 当前页码
  • show_all – 默认值是false,如果设置为true,那么将显示所有的可用页码
  • end_size – 页面显示在列表的末尾号
  • mid_size – 多少个数字到当前页面的两侧,但不包括当前页面
  • prev_next – 布尔值,是否包含上一页和下一页的链接
  • prev_text – 前一页的文字。只有当’prev_next’参数设置为true
  • next_text – 下一页的文字。只有当’prev_next’参数设置为true
  • type – 定义该函数返回什么,plain, array 或 list
  • add_args – 添加查询字符串参数到链接
  • add_fragment – 添加文本追加到每个链接
  • before_page_number – 在页码前显示的字符串
  • after_page_number – 在页码后显示的字符串

这里只简单举一个使用例子,将下面的函数添加到当前主题的 functions.php 文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
function wpdx_paging_nav(){
	global $wp_query;
 
	$big = 999999999; // 需要一个不太可能的整数
 
	$pagination_links = paginate_links( array(
		'base' => str_replace( $big, '%#%', esc_url( get_pagenum_link( $big ) ) ),
		'format' => '?paged=%#%',
		'current' => max( 1, get_query_var('paged') ),
		'total' => $wp_query->max_num_pages
	) );
 
echo $pagination_links;
}

然后在主题需要显示分页链接的地方使用下面的函数调用即可:

1
<?php if(function_exists('wpdx_paging_nav')) wpdx_paging_nav(); ?>

更多例子和详细介绍,请访问官方文档:http://codex.wordpress.org/Function_Reference/paginate_links

支付宝扫码打赏 微信打赏

如果文章对你有帮助,欢迎点击上方按钮打赏作者

MetInfo | 最适合企业网站建设的cms系统

关于 倡萌

一个疯狂的 WordPress 爱好者,喜欢折腾 WordPress 主题,分享 WordPress 资源。如果你也喜欢 WordPress,欢迎和我一起交流!

精彩推荐

检查 PHP 和 WordPress 的最低版本

检查 PHP 和 WordPress 的最低版本

决定如何开发你的WordPress主题框架

决定如何开发你的WordPress主题框架

12 条评论

  1. 使用这个分布,首页正常。 但是分类和TAG等 无法正打开
    默认链接方式下 会出现: http://www.xxx.com/?tag=xxx#038;page=10
    请问有人遇见过并且解决了吗

  2. 这个和wp-pagenavi一样的功能的吗?

  3. 某些特殊时候还是用到自己写的分页。www.songker.com

  4. 分页能实现ajax吗?

  5. 本文目录
    [隐藏]
    1paginate_links 用法
    2paginate_links 默认参数
    3paginate_links 示例
    这是怎么实现的呢

  6. 最近打算系统的学习下wordpress开发,本站的教程正和我意! :!:

  7. 默认主题twentyfourteen中有一个函数twentyfourteen_paging_nav(),在inc中的template-tags.php中,用的也是paginate_links;经常按照客户设计效果图定制主题时,都是用默认主题改的;有时候感觉冗余,想把function.php和inc这些都删掉;可是又听说默认主题写的一些函数优化都比较好;就又犹豫了,很多函数继续使用;不知道倡萌能否给一些建议,谢谢;

  8. laiydesign.com

    wordpress-form-manager 这个插件是不是能用了?怎么才能正常使用这个插件呢?

发表评论