unregister_nav_menu() WordPress Function
The unregister_nav_menu() function is used to remove a registered navigation menu from a WordPress site. This function can be useful if you want to remove a menu that is no longer needed or if you want to replace an existing menu with a new one.
unregister_nav_menu( string $location ) #
Unregisters a navigation menu location for a theme.
Parameters
- $location
(string)(Required)The menu location identifier.
Return
(bool) True on success, false on failure.
More Information
Usage:
unregister_nav_menu( 'primary' );
Source
File: wp-includes/nav-menu.php
function unregister_nav_menu( $location ) {
global $_wp_registered_nav_menus;
if ( is_array( $_wp_registered_nav_menus ) && isset( $_wp_registered_nav_menus[ $location ] ) ) {
unset( $_wp_registered_nav_menus[ $location ] );
if ( empty( $_wp_registered_nav_menus ) ) {
_remove_theme_support( 'menus' );
}
return true;
}
return false;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 3.1.0 | Introduced. |