WordPress 置頂文章完整操作指南：判斷、添加與移除 PHP 函數詳解

WordPress 內建的文章置頂功能讓重要內容優先展示。開發主題或外掛時，常需以程式化方式判斷、添加或移除置頂狀態。本文系統整理核心函數用法，助你靈活掌控置頂邏輯。

判斷文章是否置頂：is_sticky()

該函數位於 wp-includes/post.php，回傳布林值。

語法

is_sticky( $post_id );

參數

• $post_id (整數，可選)：要檢查的文章 ID，預設為主迴圈中的當前文章（0 表示當前文章）。

返回值

布林值：true 表示置頂，false 表示非置頂。

使用範例

// 判斷當前迴圈文章
if ( is_sticky() ) {
    echo '當前文章是置頂文章';
}

// 判斷指定 ID 文章
if ( is_sticky( 68 ) ) {
    echo 'ID 為 68 的文章是置頂文章';
}

程式化添加與移除置頂

WordPress 將置頂文章 ID 存儲在 options 表的 sticky_posts 字段中。雖可直接操作資料庫，但官方提供兩個封裝函數更安全便捷：

置頂文章：stick_post()

// 置頂指定 ID 文章
stick_post( 68 );

// 置頂當前迴圈文章
stick_post( get_the_ID() );

取消置頂：unstick_post()

// 取消指定 ID 文章置頂
unstick_post( 425 );

// 取消當前迴圈文章置頂
unstick_post( get_the_ID() );

實戰應用場景

• 自動化置頂：根據自定義欄位、發布時間、分類等條件，透過 save_post 鉤子自動調用 stick_post()。
• 批量管理：後台開發批量置頂/取消功能，遍歷文章 ID 陣列調用對應函數。
• 前端用戶操作：結合 AJAX 讓作者或編輯在前端一鍵置頂/取消，無需進入後台。

掌握這三個核心函數，即可在任何開發場景中精準控制 WordPress 文章置頂狀態。