WordPress 評論分頁功能實現指南

WordPress 內建評論分頁函數

WordPress 2.7+ 在 wp-includes/link-template.php 中提供了四個核心函數：

• get_comments_pagenum_link($pagenum, $max_page)：返回指定頁碼的連結地址
• next_comments_link($label, $max_page)：顯示「下一頁」連結，預設文字為「Newer Comments »」
• previous_comments_link($label)：顯示「上一頁」連結，預設文字為「« Older Comments」
• paginate_comments_links($args)：顯示完整分頁導航（類似 WP-PageNavi 效果）

paginate_comments_links 參數詳解

基礎實作範例

1. 簡單上一頁/下一頁

<div id="commentnavi">
    <span class="floatleft"><?php previous_comments_link(__('« Older Comments')) ?></span>
    <span class="floatright"><?php next_comments_link(__('Newer Comments »')) ?></span>
    <div class="fixed"></div>
</div>

2. 完整分頁導航

<div id="commentnavi">
    <?php paginate_comments_links(); ?>
</div>

進階：條件式顯示分頁區塊

避免在未啟用分頁或評論數不足時輸出空白容器：

改進版上一頁/下一頁

<?php
if (get_option('page_comments')) {
    $comment_pages = paginate_comments_links('echo=0');
    if ($comment_pages) {
?>
    <div id="commentnavi">
        <span class="floatleft"><?php previous_comments_link(__('« Older Comments')) ?></span>
        <span class="floatright"><?php next_comments_link(__('Newer Comments »')) ?></span>
        <div class="fixed"></div>
    </div>
<?php
    }
}
?>

改進版分頁導航

<?php
if (get_option('page_comments')) {
    $comment_pages = paginate_comments_links('echo=0');
    if ($comment_pages) {
?>
    <div id="commentnavi">
        <?php echo $comment_pages; ?>
    </div>
<?php
    }
}
?>

實務建議與注意事項

• 錨點定位問題：外部連結指向特定評論 ID（如 #5630）時，若該評論不在第一頁，無法正確定位
• 非 AJAX 機制：翻頁需重新載入頁面，建議將每頁評論數設大（30-100 筆），減少翻頁頻率
• 後台設定：需在「設定 → 討論」中啟用「分頁顯示評論」

CSS 樣式可根據主題風格自行設計，建議為 #commentnavi 設置清晰的分頁樣式。