创建WordPress管理页面的一个快速简便的指南

管理页面是插件的心脏和灵魂.本文显示了创建WordPress管理页面的简单.

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

在此简短的教程中，我们会查看如何将这些页面添加到WordPress后端的基础知识.然后，您可以将这些知识与其他教程结合起来，以创建选项卡式页面，Ajax功能，覆盖等.

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

管理页面的组件

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

1. 菜单输入-顶级或子级别
2. 页面内容
3. 为表格处理逻辑-如果需要

为了本教程的目的，我们不会看表格并形成处理，我们将留下另一天.现在我们将关注的是如何将页面本身放入到位.

顶级和子级菜单

有两种类型的菜单条目:顶级和子级别.我建议-撰写WordPress Codex -您考虑您的插件是否真正需要顶级菜单条目.太多插件添加了顶级条目，最终污染了管理员.

一个好的拇指规则是:如果用户每天需要与插件交互，则可以使用顶级条目.如果您的管理页面只是设置，则设置顶级菜单中的子级条目更合适.

创建顶级管理页面

第一步是使用add_menu_page()函数创建菜单条目.以下是一个完整的示例，解释随之而来:

该函数需要七个参数.第一个是页面标题，它定义了标题标记;它在标签标题中显示，而不是在屏幕上.

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

参数三是访问菜单所需的功能.这可用于仅限于仅限管理员，编辑或作者.

参数四是菜单slug，它基本上用作页面的URL.

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

下一个参数是图标URL.这可以接受许多格式.如果给出了图像的URL，则将使用图像.您还可以使用Dashicons，内置于WordPress，甚至是SVG.

最后一个参数定义了菜单将放置的位置.参数五表示帖子所以我用六个将此菜单条目放在下面.看看Codex，以便准确地查看用于所需位置的数字.

下一步是创建一些内容.您需要做的就是创建参数五个中定义的函数并回显一些内容.这是一个非常简单的例子，你可以从:

创建子级别管理页面

您可以用来添加亚级页面的一些功能.常规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().让我们使用这个函数在上面创建的顶级一个下面添加一个条目:

如您所见，此函数几乎与上面的特定功能相同，但第一个参数除了指定父元素的SLUS.在我们的情况下，这是myplugin/myplugin-admin-page.php.

结论

您可以看到，添加菜单条目和显示内容非常简单.一旦完成，难度开始.什么放在页面上，如何安排它，使用JavaScript和CSS使演示文稿很棒，确保表格是安全和验证的等等.这些是我们将在未来的教程中查看的事情.

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