管理页面是插件的核心和灵魂。 本文展示了创建 WordPress 管理页面是多么简单。

很容易假设它们是复杂的表格填充怪物，其唯一目的是从用户那里收集数据。 事实上，管理页面提供了一个熟悉的地方来欢迎新用户、提供信息并显示支持和文档的详细信息。

在这个简短的教程中，我们将了解如何将这些页面添加到 WordPress 后端的基础知识。 然后，您可以将这些知识与其他教程相结合，以创建选项卡式页面、AJAX 功能、覆盖等等。

• 管理页面的组件
• 顶级和子级菜单
• 创建顶级管理页面
• 创建子级管理页面

管理页面的组件

管理页面有两个或三个组件，具体取决于您正在构建的功能：

1. 菜单条目——顶级或子级
2. 页面内容
3. 表单的处理逻辑——如果需要

出于本教程的目的，我们将不讨论表单和表单处理，我们将把它留到另一天。 现在我们要关心的是如何将页面本身放置到位。

顶级和子级菜单

有两种类型的菜单条目：顶级和子级。 我建议 - 就像 WordPress Codex 一样 - 你考虑一下你的插件是否真的需要一个顶级菜单条目。 太多插件添加了顶级条目，最终严重污染了管理员。

一个好的经验法则是：如果用户需要每天与您的插件交互，您可以使用顶级条目。 如果您的管理页面仅用于设置，则设置顶级菜单中的子级条目更合适。

创建顶级管理页面

第一步是创建一个菜单项 add_menu_page() 功能。 这是一个完整的例子，解释随之而来：

该函数有七个参数。 第一个是页面标题，它定义了标题 标签; 它显示在选项卡标题中，而不是屏幕上。

第二个参数是显示在菜单中的标题。

参数三是访问菜单所需的能力。 这可用于将其限制为仅管理员、编辑或作者。

参数四是menu slug，它本质上是用作页面的URL。

参数五是函数，它将处理页面的内容。

下一个参数是图标 url。 这可以接受多种格式。 如果给定图像的 URL，则将使用该图像。 您还可以使用内置于 WordPress 甚至 SVG 中的 Dashicons。

最后一个参数定义了菜单的放置位置。 参数 5 表示帖子，所以我使用了 6 来将此菜单条目放在下面。 查看 Codex 以准确了解您想要的职位使用的数字。

下一步是创建一些内容。 您需要做的就是创建参数 5 中定义的函数并回显一些内容。 这是一个非常简单的示例，您可以从以下示例开始：

创建子级管理页面

您可以使用很多功能来添加子级别页面。 一般 add_submenu_page() 将允许您将子级别条目放在任何地方，但所有内置的顶级页面都有自己的功能：

• 要在帖子下添加菜单项，请使用 add_posts_page
• 要在页面下添加菜单项，请使用 add_pages_page
• 在媒体使用下添加菜单项 add_media_page
• 要在链接下添加菜单项，请使用 add_links_page
• 要在评论下添加菜单项，请使用 add_comments_page
• 要在外观下添加菜单项，请使用 add_theme_page
• 要在插件下添加菜单项，请使用 add_plugin_page
• 要在用户下添加菜单项，请使用 add_users_page
• 要在工具下添加菜单项，请使用 add_management_page
• 要在设置下添加菜单项，请使用 add_options_page

这些函数中的每一个都遵循相同的格式： add_comments_page( $page_title, $menu_title, $capability, $menu_slug, $function);. 这些参数应该从我们上面的顶级示例中熟悉。

您可能希望将子级菜单添加到您自己的顶层，在这种情况下，这些特定功能对您没有多大用处。 你需要使用 add_submenu_page(). 让我们使用这个函数在上面创建的顶级条目下添加一个条目：

正如你所看到的，这个函数几乎与上面的特定函数相同，除了第一个参数指定父元素的 slug 之外。 在我们的例子中，这是 myplugin/myplugin-admin-page.php.

结论

如您所见，添加菜单条目和显示内容非常容易。 一旦完成，困难就开始了。 在页面上放置什么，如何安排它，使用 JavaScript 和 CSS 使演示文稿更出色，确保表单安全且经过验证等。这些都是我们将在以后的教程中介绍的内容。

本文的目的是让您了解菜单和管理页面创建的基础知识，以便您可以在需要时参考它。 希望您现在可以为您的产品创建页面。 我们将很快在另一篇文章中处理特定的用例。

• 代码
• 开发商