Upstream/WordPress
1
0
Fork 0
mirror of https://github.com/WordPress/WordPress.git synced 2024-12-22 17:18:32 +01:00
Code Issues Projects Releases Wiki Activity

Docs: Add changing existing items recommendations to 'admin_bar_menu' action.

Browse Source 
Improves the `'admin_bar_menu'` docblock by adding recommendations for customizing / changing existing items.

It also improves the `wp_admin_bar_render()` function's docblock by removing the "most optimal point" sentence.

The [58748] changeset moved the user menu to a higher priority level (of `9991`) to achieve:

>so nodes added with higher priorities will still be shown visually before the user and recovery menu items, as they were prior to [58215].

When hooking into `'admin_bar_menu'` with a priority level less than 9991 and attempting to get the `'my-account'` node, `null` is returned. While the preferred approach is to hook into `'wp_before_admin_bar_render'`, the documentation of the `'admin_bar_menu'` action was previously misleading.

Follow-up to [58748], [58759].

Props michaelwp85, narenin, sabernhardt, joedolson, costdev, jorbin, hellofromTonya, mukesh27, pbiron.
Fixes #61738.
Built from https://develop.svn.wordpress.org/trunk@58978


git-svn-id: http://core.svn.wordpress.org/trunk@58374 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
hellofromTonya 2024-09-03 19:58:11 +00:00
parent 2ce04ceab9
commit 7b2eb3f79b
2 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
wp-includes/admin-bar.php
View File

@ -62,9 +62,8 @@ function _wp_admin_bar_init() {
* the function is also called late on {@see 'wp_footer'}. * the function is also called late on {@see 'wp_footer'}.
* *
* It includes the {@see 'admin_bar_menu'} action which should be used to hook in and * It includes the {@see 'admin_bar_menu'} action which should be used to hook in and
* add new menus to the admin bar. That way you can be sure that you are adding at most * add new menus to the admin bar. This also gives you access to the `$post` global,
* optimal point, right before the admin bar is rendered. This also gives you access to * among others.
* the `$post` global, among others.
* *
* @since 3.1.0 * @since 3.1.0
* @since 5.4.0 Called on 'wp_body_open' action first, with 'wp_footer' as a fallback. * @since 5.4.0 Called on 'wp_body_open' action first, with 'wp_footer' as a fallback.
@ -86,7 +85,10 @@ function wp_admin_bar_render() {
/** /**
* Loads all necessary admin bar items. * Loads all necessary admin bar items.
* *
* This is the hook used to add, remove, or manipulate admin bar items. * This hook can add, remove, or manipulate admin bar items. The priority
* determines the placement for new items, and changes to existing items
* would require a high priority. To remove or manipulate existing nodes
* without a specific priority, use `wp_before_admin_bar_render`.
* *
* @since 3.1.0 * @since 3.1.0
* *

2
wp-includes/version.php
View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '6.7-alpha-58977'; $wp_version = '6.7-alpha-58978';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.