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

如果你是 WordPress主題開發(fā)者，你肯定需要實(shí)現(xiàn)存檔分頁導(dǎo)航功能，雖然目前有不少方法，但是倡萌還是推薦盡量使用官方函數(shù)來實(shí)現(xiàn)。今天介紹的函數(shù) paginate_links，可以用來檢索歸檔后的頁面分頁鏈接。其實(shí)，該函數(shù)可以被用在任何地方實(shí)現(xiàn)分頁鏈接（例如：WordPress 為自定義表格/列表添加分頁導(dǎo)航功能）。

paginate_links 用法

<?php echo paginate_links( $args ); ?>

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

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

paginate_links 示例

這里只簡單舉一個(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;
}

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

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

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