如何使用WordPress函数 add_menu_page() 创建自定义管理菜单?

2024-12-20 19 0

在WordPress中,使用 add_menu_page() 函数可以创建一个自定义的管理菜单。以下是如何使用该函数的步骤和示例代码:

步骤:

  1. 定义菜单页的回调函数:这个函数将用于输出菜单页面的内容。

  2. 使用 add_menu_page() 函数:在 admin_menu 动作钩子中调用 add_menu_page() 函数来添加菜单。

  3. 设置菜单参数add_menu_page() 函数接受多个参数,用于定义菜单的标题、菜单页的标题、用户权限、菜单的slug、回调函数等。

示例代码:

<?php
// 在主题的 functions.php 文件中或在一个自定义插件中添加以下代码

// 步骤1:定义回调函数
function my_custom_menu_page() {
    ?>
    <div class="wrap">
        <h1>我的自定义菜单页面</h1>
        <p>这里是自定义菜单页面的内容。</p>
    </div>
    <?php
}

// 步骤2:在admin_menu钩子中添加菜单
add_action( 'admin_menu', 'my_add_custom_menu' );

function my_add_custom_menu() {
    // 步骤3:使用add_menu_page()函数
    add_menu_page(
        '自定义菜单页面标题', // 页面标题
        '自定义菜单', // 菜单标题
        'manage_options', // 用户权限
        'my-custom-menu', // 页面slug
        'my_custom_menu_page', // 回调函数
        'dashicons-admin-site-alt3', // 图标URL或Dashicons类名
        6 // 菜单位置
    );
}
?>

在上面的代码中:

  • my_custom_menu_page() 是输出菜单页面内容的回调函数。
  • add_menu_page() 用于添加菜单,其中:
    • '自定义菜单页面标题' 是页面标题,在浏览器标签页中显示。
    • '自定义菜单' 是菜单标题,在管理菜单栏中显示。
    • 'manage_options' 是用户权限,只有拥有此权限的用户才能看到这个菜单。
    • 'my-custom-menu' 是菜单的slug,用于生成页面的URL。
    • 'my_custom_menu_page' 是回调函数的名称。
    • 'dashicons-admin-site-alt3' 是Dashicons图标类名,用于菜单图标。
    • 6 是菜单的位置,数字决定了菜单在管理菜单栏中的位置。

将这段代码添加到你的WordPress主题的 functions.php 文件中或创建一个插件来包含这段代码,然后在WordPress管理后台中你应该能看到一个新的菜单项。

相关文章

在WordPress主题开发中,如何使用wp_footer()和wp_head()钩子来添加自定义代码?
在WordPress插件中,如何使用wp_enqueue_script()和wp_enqueue_style()来正确地注册和加载脚本和样式?
在WordPress插件开发中,如何使用register_post_type()来创建自定义文章类型?
在WordPress主题开发中,如何使用is_page()和is_single()等条件标签来控制内容输出?
如何使用acf_add_options_page()来为WordPress主题添加自定义设置页面?
如何使用WordPress的 add_menu_page() 函数在后台创建自定义菜单页面?