Menus: Add wp_nav_menus_registered filter to get_registered_nav_menus() - #12559
Menus: Add wp_nav_menus_registered filter to get_registered_nav_menus()#12559SainathPoojary wants to merge 3 commits into
get_registered_nav_menus()#12559Conversation
d2cf45a to
d6a29dd
Compare
Test using WordPress PlaygroundThe changes in this pull request can previewed and tested using a WordPress Playground instance. WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser. Some things to be aware of
For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation. |
|
The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the Core Committers: Use this line as a base for the props when committing in SVN: To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook. |
d6a29dd to
72e9f5a
Compare
There was a problem hiding this comment.
Pull request overview
This PR introduces a new wp_nav_menus_registered filter so plugins/themes can modify the array returned by get_registered_nav_menus(), and adds PHPUnit coverage to verify the filter is applied and can reorder/remove locations.
Changes:
- Added
wp_nav_menus_registeredfilter toget_registered_nav_menus()output. - Added new PHPUnit tests validating the filter can remove and reorder registered menu locations.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
src/wp-includes/nav-menu.php |
Applies the new wp_nav_menus_registered filter when returning registered nav menu locations. |
tests/phpunit/tests/menu/registeredNavMenus.php |
Adds tests ensuring the filter is applied and can reorder/remove locations. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| * @param string[] $menus Associative array of registered navigation menu descriptions | ||
| * keyed by their location. If none are registered, an empty array. | ||
| */ | ||
| return apply_filters( 'wp_nav_menus_registered', $menus ); |
| class Tests_Menu_RegisteredNavMenus extends WP_UnitTestCase { | ||
|
|
||
| /** | ||
| * Tear down after each test. | ||
| */ | ||
| public function tear_down() { | ||
| remove_all_filters( 'wp_nav_menus_registered' ); | ||
| parent::tear_down(); | ||
| } |
Trac ticket: #31391