更新日期:2021-05-06

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

首先需使用 admin_menu 這個 hook,並且使用函數 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_add_menu_page');

function sig_add_menu_page(){
    add_menu_page( 'page_title' , 'menu_title' , 'manage_options' , 'sig-my-menu' , 'sig_my_menu_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