如何為插件創建 WooCommerce 管理員通知 – WooCommerce 開發

已發表: 2020-08-22

創建 WooCommerce 管理員通知 作為 WooCommerce 開發人員,在創建主題或 WooCommerce 插件時通常需要創建管理員通知。 WooCommerce 管理員通知可以是警告用戶有關更新,通知他們有關流程或提醒重要事項。

WooCommerce 管理員通知示例

通常,WordPress 管理員通知可能會有所不同並具有不同的顏色代碼,它們將出現在管理頁面的頂部,如下圖 WooCommerce 管理員通知所示。

WooCommerce 管理員通知

每個管理員通知只是一個白色背景樣式的div ,通知文本輸出,左邊框有不同顏色的不同通知,如下圖所示。

五種不同類型的通知顏色包括灰色、紅色、綠色、橙色和藍色。 給定類名,紅色用於顯示錯誤,綠色用於成功消息,橙色用於警告,藍色用於信息通知,灰色用於默認通知。

一般的 WordPress 管理員通知可以如下圖所示,並帶有相應的代碼:
帶有代碼的 WordPress 管理員通知 如果您想複製代碼,以下是每個管理員 WordPress 管理員通知的代碼片段。

 <div class="notice"><p>默認通知</p></div>

<div class="notice is-dismissible"><p>默認關閉通知</p></div>

<div class="notice notice-info"><p>信息通知</p></div>

<div class="notice notice-info is-dismissible"><p>信息通知可駁回</p></div>

<div class="notice notice-info alt"><p>信息通知 alt</p></div>

<div class="notice notice-success"><p>成功通知</p></div>

<div class="notice notice-success is-dismissible"><p>成功通知可駁回</p></div>

<div class="notice notice-success notice-alt"><p>成功通知alt</p></div>

<div class="notice notice-warning"><p>警告通知</p></div>

<div class="notice notice-warning is-dismissible"><p>警告通知可駁回</p></div>

<div class="notice notice-warning notice-alt"><p>警告通知alt</p></div>

<div class="notice notice-error"><p>錯誤提示</p></div>

<div class="notice notice-error"><p>錯誤提示</p></div>

<div class="notice notice-error is-dismissible"><p>錯誤通知可關閉</p></div>

<div class="notice notice-error notice-alt"><p>錯誤通知alt</p></div>

正如您在上面的代碼中看到的,通知中的差異是為每種類型的 WordPress 管理員通知分配的類。 以下是四個最常用的 WooCommerce 管理員通知類的列表:

  1. 錯誤通知notice-error
  2. 成功通知notice-success
  3. 信息通知notice-info
  4. 警告通知notice-warning

創建 WooCommerce 或 WordPress 管理員通知

要創建管理員通知,您需要使用掛鉤admin_notices事件的操作掛鉤。 通知 div 和內容應該添加到動作鉤子的回調函數中。

您可以在插件中使用此管理員通知掛鉤,讓用戶收到重要更新、信息或警告的通知。

WordPress 錯誤通知示例

以下是錯誤通知的示例:

 <?php
add_action('admin_notices', 'njengah_error_notice');

功能 njengah_error_notice() {
       ?>
       <div class="notice notice-error">
          <p><?php _e( '錯誤提示示例。', 'text-domain' );?></p>
       </div>
       <?php 
}
?>

WordPress 信息通知示例

以下是信息通知的示例:

 <?php
add_action('admin_notices', 'njengah_info_notice');

功能 njengah_info_notice() {
       ?>
       <div class="notice notice-info">
            <p><?php _e( '信息通知示例', '文本域' ); ?></p>
       </div>
       <?php 
 }

以上是如何為 WordPress 或 WooCommerce 插件創建管理員通知的兩個實際示例。

您可以更改通知類別以適合您要創建的通知類型。 您也可以將操作掛鉤包裝在 if 語句中,以便有條件地顯示通知,如下例所示。

有條件地顯示 WordPress 管理員通知

<?php
如果(!空(get_option('njengah_update_status'))){
    add_action('admin_notices', 'njengah_update_notice');
}

功能 njengah_update_notice() {
?>
    <div class="notice notice-success">
        <p><?php _e( '更新成功!', 'text-domain' ); ?></p>
    </div>
<?php
}
?>

結論

在這篇文章中,我們概述瞭如何在 WordPress 和 WooCommerce 插件開發中創建管理員通知。 您需要了解各種 WordPress 管理員通知類,並將消息添加到與admin_notices掛鉤的操作掛鉤中。 這就是如何創建 WooCommerce 管理員通知的全部內容。

類似文章