## 添加頂級菜單 要向WordPress管理添加新的頂級菜單，請使用add_menu_page（）函數。 ``` <?php add_menu_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', string $icon_url = '', int $position = null ); ``` ## 示例 假設我們要添加一個名為“WPOrg”的頂級菜單。 第一步將創建一個將輸出HTML的函數。 在此功能中，我們將執行必要的安全檢查，并使用Settings API呈現我們注冊的選項。 >[info] 注意：我們建議使用一個包裹類型的“<div>”包裝你的HTML。 ``` <?php function wporg_options_page_html() { // check user capabilities if (!current_user_can('manage_options')) { return; } ?> <div class="wrap"> <h1><?= esc_html(get_admin_page_title()); ?></h1> <form action="options.php" method="post"> <?php // output security fields for the registered setting "wporg_options" settings_fields('wporg_options'); // output setting sections and their fields // (sections are registered for "wporg", each field is registered to a specific section) do_settings_sections('wporg'); // output save settings button submit_button('Save Settings'); ?> </form> </div> <?php } ``` 第二步將注冊我們的WPOrg菜單。 注冊需要在admin_menu操作鉤子中進行。 ``` <?php function wporg_options_page() { add_menu_page( 'WPOrg', 'WPOrg Options', 'manage_options', 'wporg', 'wporg_options_page_html', plugin_dir_url(__FILE__) . 'images/icon_wporg.png', 20 ); } add_action('admin_menu', 'wporg_options_page'); ``` 有關參數列表，請參閱引用中的add_menu_page（）。 ## 使用PHP文件進行HTML 便攜式代碼的最佳做法是創建一個需要/包含您的PHP文件的回調。 為了完整性和幫助您了解遺留代碼，我們將展示另一種方法：將PHP文件路徑作為$ menu_slug參數傳遞一個null $ function參數。 ``` <?php function wporg_options_page() { add_menu_page( 'WPOrg', 'WPOrg Options', 'manage_options', plugin_dir_path(__FILE__) . 'admin/view.php', null, plugin_dir_url(__FILE__) . 'images/icon_wporg.png', 20 ); } add_action('admin_menu', 'wporg_options_page'); ``` ## 刪除頂級菜單 要從WordPress管理中刪除注冊的菜單，請使用remove_menu_page（）函數。 ``` <?php remove_menu_page( string $menu_slug ); ``` >[warning] 警告：刪除菜單不會阻止用戶直接訪問它們。這絕對不能用來限制用戶的功能。 ## 示例 讓我們說要從中刪除“工具”菜單。 ``` <?php function wporg_remove_options_page() { remove_menu_page('tools.php'); } add_action('admin_menu', 'wporg_remove_options_page', 99); ``` 在嘗試刪除之前，請確保已將菜單注冊到admin_menu鉤子，為add_action（）指定較高優先級號。