WordPress 文章迴圈重置利器：rewind_posts() 函數完整指南

為什麼需要重置迴圈指標？

在 WordPress 主題開發中，有時需在主要迴圈開始前「提前進入」迴圈以取得特定資料（如作者資訊、分類標題等）。但 WordPress 預設單頁面僅執行一次主迴圈，若提前呼叫 the_post() 移動指標，後續的主迴圈將從「第二篇文章」開始，導致首篇文章遺漏。rewind_posts() 正是為了解決此問題而設計的內建函數。

函數語法與說明

<?php rewind_posts(); ?>

• 功能：將迴圈指標重置至起始位置，使後續 have_posts() / the_post() 可從頭遍歷。
• 參數：無。
• 回傳值：無。

實戰範例：Twenty Eleven author.php

<?php if ( have_posts() ) : the_post(); // 提前進入迴圈取得作者名稱
    echo get_the_author();
    rewind_posts(); // 關鍵：重置指標回到第一篇
    while ( have_posts() ) : the_post(); // 正式主迴圈開始
        get_template_part( 'content', get_post_format() );
    endwhile;
endif; ?>

此範例展示：先取得作者顯示名稱，隨即呼叫 rewind_posts()，確保後續主迴圈完整輸出所有文章。

進階應用場景

• 同頁多重迴圈：首頁需分別顯示「最新文章」、「精選文章」、「熱門文章」三個區塊，每區塊皆需完整迴圈。
• 條件式預取資料：在迴圈前判斷是否有文章、取得第一篇文章的縮圖作為 Hero Banner 背景。
• 自訂查詢後復原主查詢：搭配 wp_reset_postdata() 使用，確保全域 $post 變數正確。

補充：single_cat_title() 函數

用於分類/標籤彙整頁面，直接取得目前頁面的分類或標籤名稱，不依賴主迴圈，亦不可置於迴圈內。

<?php single_cat_title( $prefix, $display ); ?>

• $prefix：標題前綴字串。
• $display：true 直接輸出，false 回傳字串。

範例（category.php）：

<?php printf( __( 'Category Archives: %s', 'twentyeleven' ),
    '<span>' . single_cat_title( '', false ) . '</span>' ); ?>

總結

rewind_posts() 雖簡單，卻是掌控迴圈流程的關鍵。善用它能避免「文章漏顯」、「重複顯示」等常見 Bug，讓主題邏輯更穩健。