WordPress 分页链接函数paginate_links详解

学习笔记 1个月前 小天
101 0

wordpress分类存档页如何实现分页导航的功能呢?这里推荐使用官方提供的函数 paginate_links 来实现。

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' => ''
);
echo paginate_links( $args );
?>
  • 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 - 在页码后显示的字符串

实例讲解

	function wp_pagenavi() {   
	    //先申明两个全局变量   
	    global $wp_query, $wp_rewrite;   
	    //判断当前页面   
	    $wp_query->query_vars['paged'] > 1 ? $current = $wp_query->query_vars['paged'] : $current = 1;   
	       
	    $pagination = array(   
	        'base' => @add_query_arg('paged','%#%'),   
	        'format' => '',   
	        'total' => $wp_query->max_num_pages,   
	        'current' => $current,   
	        'show_all' => false,   
	        'type' => 'plain',   
	        'end_size'=>'1',   
	        'mid_size'=>'3',   
	        'prev_text' => '上一页',   
	        'next_text' => '下一页'   
	    );   
	       
	    if( $wp_rewrite->using_permalinks() )   
	        $pagination['base'] = user_trailingslashit( trailingslashit( remove_query_arg('s',get_pagenum_link(1) ) ) . 'page/%#%/', 'paged');   
	    if( !empty($wp_query->query_vars['s']) )   
	        $pagination['add_args'] = array('s'=>get_query_var('s'));   
	    echo paginate_links($pagination);   
	}  

首先在 functions.php 文件中加入此函数,然后就可以在任何分类存档页输出 wp_pagenavi() 即可。

Wordpress 分页链接函数paginate_links详解

效果如图,具体的样式可以自己修改。

版权声明:小天 发表于 2021年10月15日 下午1:48。
转载请注明:WordPress 分页链接函数paginate_links详解 | 小菜IT

相关文章

暂无评论

暂无评论...