如果你是 WordPress主題開(kāi)發(fā)者，你肯定需要實(shí)現(xiàn)存檔分頁(yè)導(dǎo)航功能，雖然目前有不少方法，但是倡萌還是推薦盡量使用官方函數(shù)來(lái)實(shí)現(xiàn)。今天介紹的函數(shù) paginate_links，可以用來(lái)檢索歸檔后的頁(yè)面分頁(yè)鏈接。其實(shí)，該函數(shù)可以被用在任何地方實(shí)現(xiàn)分頁(yè)鏈接
來(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 – 添加查詢字符串參數(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
