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

2024-12-28 66 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插件中使用ajax?
如何通过WordPress函数创建自定义菜单?
在WordPress主题开发中,如何使用WP_Customize_Manager来自定义主题选项?
如何使用WordPress的filter钩子修改输出内容?
如何使用WordPress的action钩子添加自定义JavaScript?
在WordPress插件中,如何使用自定义表单和nonce字段来增强安全性?