创建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使演示文稿很棒,确保表格是安全和验证的等等.这些是我们将在未来的教程中查看的事情.

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

2
订阅评论
提醒
0 评论
内联反馈
查看所有评论