WordPress最简单的分页方法——使用自带的paginate_links函数

最近在研究如何设计 WordPress 主题，分页当然是必不可少的功能之一，于是搜索了一下如何实现分页。

很多人都抱怨说为什么 WordPress 没有自带的分页功能，还得自己写函数实现或者安装 WP-Pagenavi pagebar 等插件实现。

其实 WordPress 从 2.1 版本开始就提供了 paginate_links 的函数，它可以在任何地方显示页码导航链接。这个函数的基本参数如下：

其中 ‘base’ 参数用来提供创建页面链接的参考链接，’format’ 参数是用来替换成页码。’total’ 参数是设置页面的总数，’current’ 参数用于设置当前的页码，它们都必须是整数。这些参数我们在使用的时候必须提供的。

‘show_all’ 参数设置为 true 就会显示所有的页面，默认情况它是被设置为 false 的，通过 ‘end_size’ 和 ‘mid_size’ 这两个参数来控制页码显示的规则。’end_size’ 参数是用来控制在开始和结束的两端显示多少个数字，默认是 1 。’mid_size’ 参数是用来显示多少个数字显示在当前页数字的两边，并且不包括当前页。

‘prev_next’ 这个参数是用来设置是否显示上一页和下一页的页码链接，默认是 true，然后我们可以通过 ‘prev_text’ 和 ‘next_text’ 这两个参数来控制上一页和下一页的文本。

以下是 WordPress 官方文档提供的示例代码：

<?php
global $wp_query;

$big = 999999999; // need an unlikely integer

echo paginate_links( array(
    'base' => str_replace( $big, '%#%', get_pagenum_link( $big ) ),
    'format' => '?paged=%#%',
    'current' => max( 1, get_query_var('paged') ),
    'total' => $wp_query->max_num_pages
) );
?>

参考链接：WordPress 技巧：不用插件实现 Pagenavi 功能

随机文章:

1. Ubuntu从NTP服务器同步时间
2. VBS调用Windows API函数
3. VB6拾遗：轻量级COM对象
4. PHP base_convert函数的一个有趣现象
5. Chrome新标签页无法打开问题的解决

这篇文章发布于 2011年11月4日，星期五，16:05，归类于 软件相关。 您可以跟踪这篇文章的评论通过 RSS 2.0 feed。 您可以留下评论，或者从您的站点trackback。