更新日期:2021-03-05

一般外掛若是需要填寫一些設定值,或是展示一些資料畫面,就需要在控制台既有的選單新增一個新選單項目。

這邊會 hook admin_menu,並且使用函數 add_menu_page。


add_menu_page( 
    string $page_title,  //必需,頁面標題
    string $menu_title,  //必需,選單顯示的名稱
    string $capability,  //必需,限定能使用的角色
    string $menu_slug,   //必需,不能重複的文件命名(僅包含小寫字母數字,破折號和下劃線字符) 
    callable $function = '',  //可選,呼叫函數 
    string $icon_url = '',   //可選,選單icon
    int $position = null    //可選,顯示的位置
)

 

簡單例子如下:


add_action('admin_menu', 'sig_my_plugin_setup_menu');

function sig_my_plugin_setup_menu(){
    add_menu_page(
      '我的外掛設定',
      '我的外掛設定',
      'manage_options', 
      'sig-my-plugin-setup', 
      'manager_plugins_page'
    );
}

 

$capability 角色說明:
https://wordpress.org/support/article/roles-and-capabilities/

$position 位置說明:

  • 2 – Dashboard
  • 4 – Separator
  • 5 – Posts
  • 10 – Media
  • 15 – Links
  • 20 – Pages
  • 25 – Comments
  • 59 – Separator
  • 60 – Appearance
  • 65 – Plugins
  • 70 – Users
  • 75 – Tools
  • 80 – Settings
  • 99 – Separator