WordPress后台菜单添加指南：顶级菜单与子菜单的功能详解

对于希望在WordPress后台添加新菜单项的朋友，这篇指南将为你提供详尽的教程。我们将深入如何添加顶级菜单和子菜单，让你轻松定制你的WordPress后台管理界面。

一、添加顶级菜单：使用add_menu_page函数

我们来了解如何添加顶级菜单。在WordPress后台，顶级菜单与“外观”、“插件”等并列。为了添加顶级菜单，我们可以使用add_menu_page函数。

函数的结构如下：

```php

add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position );

```

`$page_title`：页面标题标签信息。

`$menu_title`：菜单标题，即显示在菜单上的文字。

`$capability`：用户权限，决定谁可以访问该菜单项。

`$menu_slug`：菜单项的别名，用于在URL中识别。

`$function`：当访问此菜单项时要执行的函数。如果为空，可以使用 `$menu_slug` 对应的文件路径。

`$icon_url`：菜单项的图标URL地址。

`$position`：菜单项在菜单中的位置，如果两个菜单项的位置相同，其中一个可能会被覆盖。

示例：

```php

function test_function() {

add_menu_page( '页面标题', '顶级菜单标题', 'edit_themes', 'ashu_slug','display_function','',6);

}

function display_function() {

echo '

这是设置页面

}

add_action('admin_menu', 'test_function');

```

在这个例子中，我们创建了一个名为“顶级菜单标题”的顶级菜单，其位置为6（在默认WordPress后台的“文章”后面）。点击这个菜单会执行display_function函数，显示一个简单的设置页面。

二、添加子菜单项：使用add_submenu_page函数

要添加子菜单项，我们可以使用add_submenu_page函数。其参数与add_menu_page类似，但有一个额外的`$parent_slug`参数，用于指定子菜单的父级菜单项。

函数结构如下：

```php

add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function );

```

示例（作为上面顶级菜单的子菜单）：

```php

add_submenu_page('ashu_slug', '子菜单页面标题', '子菜单标题', 'edit_themes', 'sub_menu_slug','subdisplay_function');

function subdisplay_function() {

echo '

这是子菜单设置页面

}

```

在这个例子中，我们为之前创建的顶级菜单“ashu_slug”添加了一个子菜单。点击这个子菜单会执行subdisplay_function函数，显示一个子菜单设置页面。 需要注意的是，为了保持文章的简洁和流畅性，上述代码示例可能需要根据你的实际需求进行适当的调整和优化。确保在添加新菜单或子菜单时遵循WordPress的最佳实践和安全准则。在Twenty Ten主题的定制中，我们以一个富有创意的方式进一步拓展我们的WordPress功能。我们已经有一个默认的myfunctions.php文件，通过include指令将它融入到我们的functions.php文件中。在这基础上，我们要构建一个复杂的菜单结构——从一个顶级菜单项延伸出一个子菜单项。

打开myfunctions.php文件，你会发现一个已经设定好的顶级菜单项。现在，我们要在这个基础上添加一个新的元素——一个子菜单项。让我们逐步来完成这个任务。

我们先保留昨天的代码，然后逐步添加新的功能。在PHP中，我们可以使用add_submenu_page函数来添加子菜单项。这个函数需要一些参数，包括父级菜单的slug，子菜单的标题，子菜单的权限级别等。在这里，我们将顶级菜单的slug设为ashu_slug，子菜单的标题设为“子菜单”。我们还需要定义一个新的函数my_submenu_page_display()，用于显示子菜单的内容。在这个函数中，我们简单地输出一段文字：“子菜单项的输出代码”。我们通过add_action函数将我们的新函数绑定到admin_menu事件上。这样，每当WordPress加载管理菜单时，我们的新菜单就会被添加到菜单列表中。

这样，我们的myfunctions.php文件中的代码看起来应该是这样的：

function test_function(){

add_menu_page( 'title标题', '菜单标题', 'edit_themes', 'ashu_slug','display_function','',6);

}

function display_function(){

echo '

这是设置页面

}

add_action('admin_menu', 'test_function');

//添加子菜单项代码开始

function add_my_custom_submenu_page() {

add_submenu_page( 'ashu_slug', '子菜单', '子菜单', 'edit_themes', 'ashu-submenu-page', 'my_submenu_page_display' );

}

function my_submenu_page_display() {

echo '

子菜单项的输出代码

}

add_action('admin_menu', 'add_my_custom_submenu_page'); //绑定到admin_menu事件上

?>

现在，当你进入WordPress后台管理页面时，你会看到一个顶级菜单项和一个新的子菜单项。点击子菜单项时，会看到一个简单的设置页面显示：“子菜单项的输出代码”。这就是我们添加子菜单项后的效果。通过这种方法，你可以轻松地扩展你的WordPress管理菜单，使其更符合你的需求。这就是我们的WordPress自定义开发教程的第二部分——如何添加子菜单项。希望你喜欢这个教程！