更新日期:2020-12-21
一般外掛若是需要填寫一些設定值,或是展示一些資料畫面,就需要在控制台既有的選單新增一個新選單項目。
這邊會 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