WordPress官方提供了一个关于分页的函数paginate_links，WordPress自定义查询分页函数paginate_links可以让你在你需要的任何位置实现WordPress自定义分页效果。比如文章列表、存档页面、自定义文章类型等。
paginate_links 用法
复制
<?php echo paginate_links( $args ); ?>
paginate_links 默认参数
复制
<?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 – 在页码后显示的字符串
paginate_links函数使用示例
这里只简单举一个使用例子，将下面的函数添加到当前主题的 functions.php 文件：
复制
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; }
然后在主题需要显示分页链接的地方使用下面的函数调用即可：
复制
<?php if(function_exists('wpdx_paging_nav')) wpdx_paging_nav(); ?>
WordPress自定义分页paginate_links()函数官方文档：https://codex.wordpress.org/Function_Reference/paginate_links
评论 （0）