分頁可讓您的用戶通過多頁內容來回瀏覽。 WordPress可以使用分頁： - 或者在一個頁面上查看更多帖子的帖子列表 - 通過使用以下標簽手動打破更長的帖子。 ``` <!--nextpage--> ``` ## 使用分頁瀏覽帖子列表 在WordPress網站中最常用的分頁是將長列表的帖子分解成單獨的頁面。 無論您是查看博客或網站的類別，歸檔或默認索引頁面，默認情況下，WordPress僅顯示每頁10個帖子。 用戶可以在閱讀屏幕上更改每個頁面上顯示的帖子數量：管理員>設置>閱讀。 ## 循環與分頁 此簡化示例顯示可以為主循環添加分頁功能的位置。 在循環之前或之后添加功能。 ``` <?php if ( have_posts() ) : ?> <!-- Add the pagination functions here. --> <!-- Start of the main loop. --> <?php while ( have_posts() ) : the_post(); ?> <!-- the rest of your theme's main loop --> <?php endwhile; ?> <!-- End of the main loop --> <!-- Add the pagination functions here. --> <div class="nav-previous alignleft"><?php next_posts_link( 'Older posts' ); ?></div> <div class="nav-next alignright"><?php previous_posts_link( 'Newer posts' ); ?></div> <?php else : ?> <?php _e('Sorry, no posts matched your criteria.'); ?> <?php endif; ?> ``` ## 顯示分頁鏈接的方法 >[warning] 注意：在使用分頁循環的模板文件外部使用任何這些分頁函數時，必須調用全局變量$wp_query。 ``` function your_themes_pagination(){ global $wp_query; echo paginate_links(); } ``` WordPress具有許多功能，用于顯示您循環中其他頁面的鏈接。 這些功能中的一些僅在非常具體的上下文中使用。 您將在單個頁面上使用不同的功能，然后在歸檔頁面上。 以下部分介紹歸檔模板分頁功能。 之后的部分封面單后分頁。 ## 簡單分頁 - posts_nav_link 最簡單的方法之一是posts_nav_link()。 在你的循環之后，簡單的把你的模板放在你的模板中。 這將產生兩個鏈接到下一頁的帖子和上一頁的帖子（如適用）。 此功能適用于具有簡單分頁要求的主題。 ``` posts_nav_link(); ``` - next_posts_link & prev_posts_link 構建主題時，請使用next_posts_link()和prev_posts_link()。 以控制上一頁和下一頁的頁面鏈接出現在哪里。 ``` next_posts_link(); previous_posts_link(); ``` 如果您需要將分頁鏈接傳遞給PHP變量，則可以使用get_next_posts_link()和get_previous_posts_link()。 ``` $next_posts = get_next_posts_link(); $prev_posts = get_previous_posts_link(); ``` ## 數字分頁 當您有許多頁面的內容時，顯示頁碼列表是一個更好的體驗，因此用戶可以點擊任何一個頁面鏈接，而不必重復單擊下一個或上一個帖子。 WordPress提供了幾個自動顯示數字分頁列表的功能。 對于WordPress 4.1+ 如果您想要更強大的分頁選項，則可以對WordPress 4.1及更高版本the_posts_pagination()。 這將輸出一組頁碼，其中包含上一頁和下一頁的鏈接。 ``` the_posts_pagination(); ``` 對于4.1之前的WordPress 如果您希望分頁支持舊版本的WordPress，則必須使用paginate_links()。 ``` echo paginate_links(); ``` ## 單職之間的分頁 所有以前的功能都應該用在索引和歸檔頁面上。 當您查看單個博文時，您必須使用prev_post_link和next_post_link。 在您的single.php上的循環下面放置以下功能。 ``` previous_post_link(); next_post_link(); ``` ## 一篇文章中的分頁 WordPress為您提供了一個標簽，可以放置在帖子內容中以啟用該帖子的分頁。 ``` <!--nextpage--> ``` 如果您在內容中使用該標簽，則需要確保將wp_link_pages函數放在循環中的single.php模板中。 ``` <?php if ( have_posts() ) : ?> <!-- Start of the main loop. --> <?php while ( have_posts() ) : the_post(); ?> <?php the_content(); ?> <?php wp_link_pages(); ?> <?php endwhile; ?> <?php endif; ?> ```