為控制台新增最上層選單

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

這邊會 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