olami 自定义上下文

olami 自定义上下文

That little “Help” tab that sits in the top-right corner of the WordPress admin dashboard which, when clicked, reveals helpful information about the various admin pages and how they work is referred to as a contextual help tab.

位于WordPress管理仪表板右上角的那个小“帮助”选项卡在单击时会显示有关各种管理页面及其工作方式的有用信息，称为上下文帮助选项卡。

It is contextual because the information it displays pertains to the admin page that is currently being viewed.

这是上下文相关的，因为它显示的信息与当前正在查看的管理页面有关。

For example, when the contextual help tab is clicked while in the post edit screen, information on how perform several tasks is revealed, including the following examples:

例如，在后编辑屏幕中单击上下文帮助选项卡时，将显示有关如何执行多个任务的信息，包括以下示例：

How to customize the screen display

如何自定义屏幕显示 How to enter post title and content

如何输入帖子标题和内容 How to insert media files to the post content

如何将媒体文件插入帖子内容 How to turn comments and pings on or off

如何打开或关闭评论和ping

If you are a plugin or theme developer, this will be useful in providing quick documentation to your users which in turn reduces support questions from your customers. If you are looking to learn about theme development, take a look at the WordPress Theme Development course on SitePoint Premium

如果您是插件或主题开发人员，这将有助于向用户提供快速文档，从而减少客户的支持问题。 如果您想学习主题开发，请参阅SitePoint Premium上的WordPress主题开发课程。

When a custom post type and a theme or plugin settings page is created, there exist no default contextual help tab. Therefore, in this tutorial, you will learn how to add one to the above mentioned admin pages.

创建自定义帖子类型和主题或插件设置页面时，不存在默认的上下文帮助选项卡。 因此，在本教程中，您将学习如何向上述管理页面添加一个。

将“上下文帮助”选项卡添加到帖子类型屏幕 (Adding Contextual Help Tab to Post Type Screens)

The add_help_tab() and set_help_sidebar methods of the WP_Screen class are used to add a contextual help menu and a sidebar to the help tab in an admin page.

WP_Screen类的add_help_tab()和set_help_sidebar方法用于在管理页面的帮助选项卡中添加上下文帮助菜单和侧边栏。

The function below will add three menus to the contextual help tab of an admin page.

下面的功能会将三个菜单添加到管理页面的上下文帮助选项卡中。

For now, the sp_help_tabs function won’t show up in any admin page because you have yet to define the page(s) where it will be displayed.

目前， sp_help_tabs函数不会显示在任何管理页面中，因为您尚未定义显示该页面的页面。

function sp_help_tabs() { $screen = get_current_screen(); $screen->add_help_tab( array( 'id' => 'sp_overview', 'title' => 'Overview', 'content' => '<p>Overview of your plugin or theme here</p>' ) ); $screen->add_help_tab( array( 'id' => 'sp_faq', 'title' => 'FAQ', 'content' => '<p>Frequently asked questions and their answers here</p>' ) ); $screen->add_help_tab( array( 'id' => 'sp_support', 'title' => 'Support', 'content' => '<p>For support, shoot us a mail via me@w3guy.com</p>' ) ); }

Below is a screenshot of the contextual help tab when added to an admin page.

以下是添加到管理页面时上下文帮助选项卡的屏幕截图。

The function get_current_screen() returns a WP_Screen object of the admin page currently being viewed, and its value saved to the $screen variable.

函数get_current_screen()返回当前正在查看的管理页面的WP_Screen对象，并将其值保存到$screen变量中。

The add_help_tab() method, which accepts the below parameters, is called three times to add three menus to the contextual help for the screen.

接受以下参数的add_help_tab()方法被调用三次，以将三个菜单添加到屏幕的上下文帮助中。

id: a unique ID for the tab. It must be HTML-safe and shouldn’t contain empty spaces.

id ：选项卡的唯一ID。 它必须是HTML安全的，并且不能包含空格。

title: title for the tab.

title ：选项卡的标题。

content: content of the help tab. can be in plain text or HTML.

content ：帮助选项卡的内容。 可以是纯文本或HTML。

callback: function to be called to output the content for this page.

callback ：将被调用以输出此页面内容的函数。

From the description of the parameters above, you can see that the third and fourth parameters are related — they deal with displaying the tab’s content. While the former is a string containing the content in plain text or HTML format, the latter is a callback function to be called that echoes or prints the tab content.

从上面参数的描述中，您可以看到第三个和第四个参数是相关的-它们处理显示选项卡的内容。 前者是包含纯文本或HTML格式内容的字符串，而后者是要调用的回调函数，该函数回显或打印选项卡内容。

The callback function accepts two arguments $screen and $tab, where the former is the WP_Screen object of the current page and the latter an array of add_help_tab() arguments and their values.

回调函数接受两个参数$screen和$tab ，其中前一个是当前页面的WP_Screen对象，后一个是add_help_tab()参数及其值的数组。

These two arguments will come in handy if you would want to display the tab content base on certain conditions. For example, you may already have the content you need to output, making it easier to just output the string. However, you might need to manipulate something to acquire that content, making the use of a callback more appropriate.

如果要在某些条件下显示选项卡内容，这两个参数将派上用场。 例如，您可能已经具有需要输出的内容，这使得仅输出字符串更加容易。 但是，您可能需要进行一些操作才能获取该内容，从而使回调的使用更加合适。

An example of the use of callback:

使用callback的示例：

function sp_help_tabs() { $screen = get_current_screen(); $screen->add_help_tab( array( 'id' => 'sp_overview', 'title' => 'Overview', 'callback' => function ( $screen, $tab ) { echo '<p>Overview of your plugin or theme here.</p>'; } ) ); }

In the code above, an anonymous function is used as the callback. A named function can also be used like so:

在上面的代码中，匿名函数用作回调。 命名函数也可以这样使用：

function sp_help_tabs() { $screen = get_current_screen(); $screen->add_help_tab( array( 'id' => 'sp_overview', 'title' => 'Overview', 'callback' => 'overview_content' ) ); } function overview_content( $screen, $tab ) { echo '<p>Overview of your plugin or theme here.</p>'; }

Both content and callback can be combined together with the former displayed before the latter.

content和callback都可以与前者一起显示在后者之前。

function sp_help_tabs() { $screen = get_current_screen(); $screen->add_help_tab( array( 'id' => 'sp_overview', 'title' => 'Overview', 'content' => '<p>Overview of your plugin or theme here.</p>', 'callback' => function () { echo '<p>More detailed description of the plugin coming soon.</p>'; } ) ); }

To add a sidebar to the contextual help for the screen, use WP_Screen‘s set_help_sidebar method as follows:

要将边栏添加到屏幕的上下文帮助中，请使用WP_Screen的set_help_sidebar方法，如下所示：

function sp_help_tabs() { $screen = get_current_screen(); $screen->add_help_tab( array( 'id' => 'sp_overview', 'title' => 'Overview', 'content' => '<p>Overview of your plugin or theme here</p>' ) ); $screen->add_help_tab( array( 'id' => 'sp_faq', 'title' => 'FAQ', 'content' => '<p>Frequently asked questions and their answers here</p>' ) ); $screen->add_help_tab( array( 'id' => 'sp_support', 'title' => 'Support', 'content' => '<p>For support, shoot us a mail via me@w3guy.com</p>' ) ); // Add a sidebar to contextual help. $screen->set_help_sidebar( 'This is the content you will be adding to the sidebar.' ); }

To add the contextual help tab to a book custom post type screen, hook the sp_help_tabs function to load-edit.php and load-post.php actions. Then, do a conditional check to ensure you are in a book CPT like so:

要将上下文帮助选项卡添加到book自定义帖子类型屏幕，请将sp_help_tabs函数挂接到load-edit.php和load-post.php操作。 然后，进行条件检查，以确保您像这样的book CPT：

add_action( "load-edit.php", 'sp_help_tabs' ); add_action( "load-post.php", 'sp_help_tabs' ); function sp_help_tabs() { $screen = get_current_screen(); $screen_ids = array( 'edit-book', 'book' ); if ( ! in_array( $screen->id, $screen_ids ) ) { return; } $screen->add_help_tab( array( 'id' => 'sp_overview', 'title' => 'Overview', 'content' => '<p>Overview of your plugin or theme here</p>' ) ); $screen->add_help_tab( array( 'id' => 'sp_faq', 'title' => 'FAQ', 'content' => '<p>Frequently asked questions and their answers here</p>' ) ); $screen->add_help_tab( array( 'id' => 'sp_support', 'title' => 'Support', 'content' => '<p>For support, shoot us a mail via me@w3guy.com</p>' ) ); // Add a sidebar to contextual help. $screen->set_help_sidebar( 'This is the content you will be adding to the sidebar.' ); }

The function sp_help_tabs() was hooked toload-edit.php and load-post.php actions because you want the contextual help tab to show up in the post type listing (page that list post belonging to the post type) and post edit (admin page where a post is edited, saved and published) screens.

函数sp_help_tabs()已挂接到load-edit.php和load-post.php操作，因为您希望上下文帮助选项卡显示在帖子类型列表(列出帖子类型的页面)中，并进行编辑(在管理员页面上编辑，保存和发布帖子)屏幕。

To be sure you are adding the contextual help tab to book custom post type screen, you use the if conditional statement inside the function to ensure that the current screen ID is either edit-book or book. Note that the screen ID is edit-book and book in load-edit.php and load-post.php action hooks respectively.

为确保将上下文帮助选项卡添加到book自定义帖子类型屏幕，请在函数内部使用if条件语句，以确保当前的屏幕ID是edit-book或book 。 请注意，屏幕ID分别是load-edit.php和load-post.php操作挂钩中的edit-book和book 。

If you want the contextual help tab displayed in book post listing and edit-book screens to be different, hook two functions containing the tab content to load-edit.php and load-post.php as follows:

如果希望在book帖列表和edit-book屏幕中显示的上下文帮助选项卡不同，则将包含选项卡内容的两个函数挂接到load-edit.php和load-post.php ，如下所示：

add_action( 'load-edit.php', 'post_listing_screen_help_tab' ); /** * This will be added to the admin page listing all post in "book" CPT. */ function post_listing_screen_help_tab() { $screen = get_current_screen(); if ( 'edit-book' != $screen->id ) { return; } $screen->add_help_tab( array( 'id' => 'book_review', 'title' => 'Book Reviews', 'content' => '<p>How to add a book review here</p>' ) ); // Add a sidebar to contextual help. $screen->set_help_sidebar( 'This is the content you will be adding to the sidebar.' ); } add_action( 'load-post.php', 'post_edit_screen_help_tab' ); /** * This will be added to the admin page for editing a post belonging to "book" CPT. */ function post_edit_screen_help_tab() { $screen = get_current_screen(); if ( 'book' != $screen->id ) { return; } $screen->add_help_tab( array( 'id' => 'edit_book_review', 'title' => 'Book Review Edit', 'content' => '<p>How to edit a book review entry.</p>' ) ); // adds a sidebar to contextual help. $screen->set_help_sidebar( 'This is the content you will be adding to the sidebar.' ); }

将上下文帮助选项卡添加到设置页面 (Adding Contextual Help Tab to Settings Pages)

Adding a help tab to a plugin or theme settings page is pretty much the same process as a post type screen added above. The only difference is the action hook that the function containing the contextual help tab setup will be hooked to, which in this case is the hook_suffix returned by add_menu_page(). If you are creating a top level menu or add_submenu_page() if it is a sub menu.

向插件或主题设置页面添加帮助标签的过程与上面添加的帖子类型屏幕几乎相同。 唯一的区别是将包含上下文帮助选项卡设置的函数action hook到action hook ，在这种情况下，该hook_suffix是add_menu_page()返回的add_menu_page() 。 如果要创建顶级菜单，请创建add_submenu_page()如果它是子菜单)。

The code below creates a top-level menu for our demo plugin and our contextual help tab added to the plugin settings page.

下面的代码为我们的演示插件创建一个顶层菜单，并将上下文帮助标签添加到插件设置页面。

add_action( 'admin_menu', 'register_plugin_page' ); function register_plugin_page() { $hook_suffix = add_submenu_page( 'plugins.php', 'SitePoint Plugin', 'SitePoint', 'manage_options', 'sp-config', 'sp_plugin_page' ); add_action( "load-$hook_suffix", 'sp_help_tabs' ); } function sp_plugin_page() { /* Code for the settings page will go here */ } function sp_help_tabs() { $screen = get_current_screen(); $screen->add_help_tab( array( 'id' => 'sp_overview', 'title' => 'Overview', 'content' => '<p>Overview of your plugin or theme here</p>' ) ); $screen->add_help_tab( array( 'id' => 'sp_faq', 'title' => 'FAQ', 'content' => '<p>Frequently asked questions and their answers here</p>' ) ); $screen->add_help_tab( array( 'id' => 'sp_support', 'title' => 'Support', 'content' => '<p>For support, shoot us a mail via me@w3guy.com</p>' ) ); $screen->set_help_sidebar( 'This is the content you will be adding to the sidebar.' ); }

The hook_suffix returned by add_menu_page() was saved to $hook_suffix variable and then used together with load prefix to form a load-$hook_suffix action which was used to include our contextual help tab — sp_help_tabs() — to the plugin settings page.

该hook_suffix通过返回add_menu_page()被保存到$hook_suffix变量，然后一起使用load前缀，以形成一个load-$hook_suffix这是用来包含我们的上下文帮助选项卡行动- sp_help_tabs() -到插件设置页面。

结论 (Conclusion)

In this tutorial, we learned what a contextual help tabs is, its importance and how to implement in to WordPress post types and plugin / themes settings page screens, hopefully leading you to a decrease in support questions and technical customer assistance!

在本教程中，我们了解了上下文帮助选项卡的含义，其重要性以及如何在WordPress帖子类型和插件/主题设置页面屏幕中实施，希望可以帮助您减少支持问题和技术客户支持！

If you have any questions or contributions, leave a comment below!

如果您有任何疑问或贡献，请在下面发表评论！

翻译自: https://www.sitepoint.com/contextual-help-tab-custom-post-types/

olami 自定义上下文

相关资源：使用Olami SDK实现一个语音输入数字进行24点计算的iOS程序