在WordPress中,使用 add_menu_page()
函数可以创建一个自定义的管理菜单。以下是如何使用该函数的步骤和示例代码:
步骤:
-
定义菜单页的回调函数:这个函数将用于输出菜单页面的内容。
-
使用
add_menu_page()
函数:在admin_menu
动作钩子中调用add_menu_page()
函数来添加菜单。 -
设置菜单参数:
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管理后台中你应该能看到一个新的菜单项。