手札

WordPress后台添加自定义菜单并关联显示页面

在WordPress主题后台添加自定义菜单并关联显示页面是插件开发和主题定制中的常见需求。以下是完整的实现方法：

一、添加顶级菜单项

1. 使用 `add_menu_page()`函数

add_action('admin_menu', 'register_custom_admin_menu');

function register_custom_admin_menu() {
    add_menu_page(
        '我的自定义页面',      // 页面标题
        '我的菜单',           // 菜单标题
        'manage_options',     // 权限要求
        'my-custom-page',     // 菜单slug
        'custom_page_content', // 回调函数
        'dashicons-admin-site', // 图标（可选）
        6                     // 位置（可选）
    );
}

function custom_page_content() {
    echo '<div class="wrap">';
    echo '<h1>我的自定义页面</h1>';
    echo '<p>这是您的自定义页面内容</p>';
    echo '</div>';
}

2. 参数详解

参数	说明
页面标题	浏览器标题栏和页面顶部显示的标题
菜单标题	侧边栏菜单中显示的文本
权限	用户访问此页面所需的权限
菜单slug	页面的唯一标识符
回调函数	输出页面内容的函数
图标	使用Dashicons图标类或自定义图标URL
位置	控制菜单在侧边栏的位置