如果你是 WordPress主題開發者，你肯定需要實現存檔分頁導航功能，雖然目前有不少方法，但是倡萌還是推薦盡量使用官方函數來實現。今天介紹的函數 paginate_links，可以用來檢索歸檔后的頁面分頁鏈接。其實，該函數可以被用在任何地方實現分頁鏈接
來源于：
https://www.wpdaxue.com/paginate_links.html
paginate_links 用法
echo paginate_links( $args ); ?>
paginate_links 默認參數
$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;
}
然后在主題需要顯示分頁鏈接的地方使用下面的函數調用即可：
if(function_exists('wpdx_paging_nav')) wpdx_paging_nav(); ?>
更多例子和詳細介紹，請訪問官方文檔：http://codex.wordpress.org/Function_Reference/paginate_links
