概述

add_utility_page() 函数用于在 WordPress 管理后台的“实用工具”部分添加一个顶级菜单页面。该函数自 WordPress 4.5.0 版本起已被弃用，建议使用 add_menu_page() 替代。

关键要点

• 函数功能：在“utility”区域创建顶级菜单页面，需指定页面标题、菜单标题、权限、菜单 slug 等参数。
• 弃用状态：自 WordPress 4.5.0 起被标记为弃用，应改用 add_menu_page() 函数。
• 权限控制：函数基于 $capability 参数控制菜单显示，回调函数需额外验证用户权限。
• 返回值：返回页面的 hook_suffix，可用于后续操作。

代码示例

function add_utility_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $icon_url = '') {
    _deprecated_function( __FUNCTION__, '4.5.0', 'add_menu_page()' );

    global $_wp_last_utility_menu;

    $_wp_last_utility_menu++;

    return add_menu_page($page_title, $menu_title, $capability, $menu_slug, $callback, $icon_url, $_wp_last_utility_menu);
}

注意事项

• 此函数已弃用，新开发中应避免使用，改用 add_menu_page()。
• 回调函数必须检查用户是否具有指定的 $capability，以确保安全访问。
• 菜单 slug 应保持唯一性，以避免冲突。