WordPress 分頁(yè)鏈接函數(shù) paginate_links

來(lái)源于：

https://www.wpdaxue.com/paginate_links.html

paginate_links 用法

 echo paginate_links( $args ); ?>

paginate_links 默認(rèn)參數(shù)

 $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 – 用來(lái)參考的網(wǎng)址
• format – 用于URL的分頁(yè)結(jié)構(gòu)，例如： /page/3
• total – 總頁(yè)數(shù)
• current – 當(dāng)前頁(yè)碼
• show_all – 默認(rèn)值是false，如果設(shè)置為true，那么將顯示所有的可用頁(yè)碼
• end_size – 頁(yè)面顯示在列表的末尾號(hào)
• mid_size – 多少個(gè)數(shù)字到當(dāng)前頁(yè)面的兩側(cè)，但不包括當(dāng)前頁(yè)面
• prev_next – 布爾值，是否包含上一頁(yè)和下一頁(yè)的鏈接
• prev_text – 前一頁(yè)的文字。只有當(dāng)’prev_next’參數(shù)設(shè)置為true
• next_text – 下一頁(yè)的文字。只有當(dāng)’prev_next’參數(shù)設(shè)置為true
• type – 定義該函數(shù)返回什么，plain, array 或 list
• add_args – 添加查詢(xún)字符串參數(shù)到鏈接
• add_fragment – 添加文本追加到每個(gè)鏈接
• before_page_number – 在頁(yè)碼前顯示的字符串
• after_page_number – 在頁(yè)碼后顯示的字符串

paginate_links 示例

這里只簡(jiǎn)單舉一個(gè)使用例子，將下面的函數(shù)添加到當(dāng)前主題的?functions.php?文件：

function wpdx_paging_nav(){
	global $wp_query;
?
	$big = 999999999; // 需要一個(gè)不太可能的整數(shù)
?
	$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;
}

然后在主題需要顯示分頁(yè)鏈接的地方使用下面的函數(shù)調(diào)用即可：

 if(function_exists('wpdx_paging_nav')) wpdx_paging_nav(); ?>

更多例子和詳細(xì)介紹，請(qǐng)?jiān)L問(wèn)官方文檔：http://codex.wordpress.org/Function_Reference/paginate_links