在 WordPress 插件中創建自訂的後台管理頁面

在 WordPress 插件開發中，您可能需要在後台添加自訂的管理頁面，以便讓用戶對插件進行設置或操作。這可以通過 add_menu_page 函數來實現。以下是創建自訂後台管理頁面的步驟。

步驟 1：創建插件目錄結構

首先，在您的插件目錄中創建一個名為 Pages 的資料夾，用於存放後台管理頁面的 PHP 文件。

• 目錄結構：

  /your-plugin-directory/
  ├── /Pages/
  │   └── my_device1.php
  ├── your-plugin-main-file.php
  

   

步驟 2：創建自訂的後台頁面文件

在 Pages 資料夾中，創建一個名為 my_device1.php 的文件，並在其中添加以下 HTML 代碼：

• my_device1.php 文件內容：

  <h3>裝置</h3>
  <hr>
  <button type="button" id="send_btn">傳送</button>
  

  這段代碼簡單地創建了一個標題和一個按鈕，將在後台的自訂頁面上顯示。

步驟 3：在插件的主文件中註冊後台菜單

接下來，您需要使用 add_action 函數綁定 admin_menu 鉤子，並在回調函數中使用 add_menu_page 函數來創建後台菜單項目。

• 主插件文件內容：

  // 綁定 'admin_menu' 鉤子，並註冊自訂的後台頁面
  add_action('admin_menu', 'my_admin_page_create1');
  
  // 定義回調函數來創建後台菜單
  function my_admin_page_create1()
  {
      // 使用 add_menu_page 函數創建一個新的後台菜單項目
      $temple_light_up = add_menu_page(
          '裝置',          // 頁面標題
          '裝置',          // 菜單標題
          'read',          // 權限要求
          'My_Device1',    // 菜單 slug
          'my_device1',    // 回調函數
          '',              // 圖標 URL（留空則使用預設圖標）
          10               // 菜單位置（數字越小，顯示越靠前）
      );
  }
  
  // 定義回調函數來顯示自訂頁面的內容
  function my_device1()
  {
      // 將 my_device1.php 文件包含進來，以顯示頁面內容
      include(plugin_dir_path(__FILE__) . 'Pages/my_device1.php');
  }
  

  代碼解釋：

  • add_action('admin_menu', 'my_admin_page_create1');：將 my_admin_page_create1 函數綁定到 admin_menu 鉤子上，以便在後台菜單中添加自訂項目。
  • add_menu_page('裝置', '裝置', 'read', 'My_Device1', 'my_device1', '', 10);：這行代碼創建了一個名為 “裝置” 的後台菜單項目。當用戶點擊該菜單項時，將會執行 my_device1 函數。
  • my_device1() 函數：這個函數包含了 my_device1.php 文件，從而將該文件的內容顯示在自訂的後台頁面上。

步驟 4：測試插件

完成上述步驟後，啟用插件並進入 WordPress 後台，您應該會在左側菜單中看到一個名為 “裝置” 的新項目。點擊該項目後，應該會顯示 “裝置” 的標題和一個 “傳送” 按鈕。