在WordPress插件中,如何使用 add_menu_page() 和 add_submenu_page() 函数来添加管理菜单?

2024-12-28 49 0

在WordPress中,add_menu_page()add_submenu_page() 函数用于在管理后台创建菜单和子菜单。以下是如何使用这些函数的步骤和示例代码:

步骤 1: 定义一个函数来创建菜单和子菜单

首先,你需要定义一个函数来创建菜单和子菜单。这个函数通常会连接到 admin_menu 动作钩子。

步骤 2: 使用 add_menu_page() 添加主菜单

使用 add_menu_page() 函数来添加一个主菜单项。这个函数需要几个参数,包括菜单标题、页面标题、用户权限、菜单ID、回调函数等。

步骤 3: 使用 add_submenu_page() 添加子菜单

使用 add_submenu_page() 函数来添加子菜单项。这个函数的参数与 add_menu_page() 类似,但是还需要指定父菜单的ID。

以下是一个示例代码:

<?php
// 在插件文件中添加以下代码

// 步骤 1: 定义一个函数来创建菜单和子菜单
function my_custom_menu() {
    // 步骤 2: 使用 add_menu_page() 添加主菜单
    add_menu_page(
        'My Custom Menu', // 页面标题
        'Custom Menu', // 菜单标题
        'manage_options', // 用户权限
        'my-custom-menu', // 菜单ID
        'my_custom_menu_page', // 回调函数
        'dashicons-admin-site-alt3', // 图标URL
        6 // 菜单位置
    );

    // 步骤 3: 使用 add_submenu_page() 添加子菜单
    add_submenu_page(
        'my-custom-menu', // 父菜单ID
        'Submenu Page Title', // 页面标题
        'Submenu', // 子菜单标题
        'manage_options', // 用户权限
        'my-custom-submenu', // 子菜单ID
        'my_custom_submenu_page' // 回调函数
    );
}

// 步骤 4: 将自定义菜单函数连接到 admin_menu 动作钩子
add_action('admin_menu', 'my_custom_menu');

// 定义回调函数,显示菜单页面内容
function my_custom_menu_page() {
    echo '<div class="wrap"><h1>My Custom Menu</h1><p>这里是主菜单的内容。</p></div>';
}

// 定义子菜单回调函数,显示子菜单页面内容
function my_custom_submenu_page() {
    echo '<div class="wrap"><h1>My Custom Submenu</h1><p>这里是子菜单的内容。</p></div>';
}
?>

将上述代码添加到你的插件文件中,然后在WordPress后台激活该插件。你应该会在管理菜单中看到一个名为“Custom Menu”的主菜单,并且在该菜单下有一个名为“Submenu”的子菜单。点击这些菜单项将会显示相应的页面内容。

相关文章

在开发WordPress插件时,如何使用register_post_type()创建自定义文章类型?
如何使用WordPress的cron jobs来安排定期任务?
在WordPress主题开发中,如何使用 is_front_page() 和 is_home() 来区分首页和博客页面?
在WordPress主题开发中,如何使用is_home()和is_front_page()来判断首页?
如何使用 WordPress 的 the_post_thumbnail() 函数显示特色图片?
在WordPress插件中,如何使用 update_option() 和 get_option() 来存储和检索设置?