代码狗

当前位置:代码狗 > Wordpress > 正文

WordPress自定义查询分页函数paginate_links详解

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' => ''
); 
?>

参数说明

  1. base – 用来参考的网址
  2. format – 用于URL的分页结构,例如: /page/3
  3. total – 总页数
  4. current – 当前页码
  5. show_all – 默认值是false,如果设置为true,那么将显示所有的可用页码
  6. end_size – 页面显示在列表的末尾号
  7. mid_size – 多少个数字到当前页面的两侧,但不包括当前页面
  8. prev_next – 布尔值,是否包含上一页和下一页的链接
  9. prev_text – 前一页的文字。只有当’prev_next’参数设置为true
  10. next_text – 下一页的文字。只有当’prev_next’参数设置为true
  11. type – 定义该函数返回什么,plain, array 或 list
  12. add_args – 添加查询字符串参数到链接
  13. add_fragment – 添加文本追加到每个链接
  14. before_page_number – 在页码前显示的字符串
  15. 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) 打赏

评论 抢沙发

×

请作者吃根烤肠!

支付宝