更新日期:2021-12-08

後台管理每一個頁面上方都會顯示一些通知訊息,這很方便讓使用者載入頁面後就先看到。底下語法可以很簡單的幫你新增你需要的文字訊息。

我們要利用 admin_notices 這個 action hook 來做:

語法

function general_admin_notice(){
    global $pagenow;
    if ( $pagenow == 'index.php' ) {
         echo '<div class="notice notice-error is-dismissible">
             <p>This is an example of a notice that appears on the settings page.</p>
         </div>';
    }
}
add_action('admin_notices', 'general_admin_notice');

說明

$pagenow; 這個變數,可以讓你控制要出現的頁面,判斷頁面程式名稱,就不會每一頁都出現通知。通知內容用一個 div 包住,class 記得要加上 notice。

而官方也提供四種色彩樣式的通知,可在加上左邊邊框加上顏色,方便使用者判斷類型:

  • notice-error:是紅色邊框,一般作為錯誤提醒。
  • notice-warning:是橘黃色邊框,有警告的意義。
  • notice-success:是綠色邊框,執行成功的意思。
  • notice-info: 是藍色邊框,有提示作用。

另外可加一個 is-dismissible,就會出現關閉該訊息的小按鈕,不過你自己要寫個程式記錄使用者已經按下關閉,不然每一次都會出現該通知也是很煩人。