如何新增 WordPress 後台的通知訊息區塊？

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

我們要利用 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，就會出現關閉該訊息的小按鈕，不過你自己要寫個程式記錄使用者已經按下關閉，不然每一次都會出現該通知也是很煩人。