register_nav_menus( string[] $locations = array() )

Parameters

$locationsstring[]optional

Associative array of menu location identifiers (like a slug) and descriptive text.Default: array()

Uses · 3

• add_theme_support()Registers theme support for a given feature.
• _doing_it_wrong()Marks something as being incorrectly called.
• __()Retrieves the translation of $text.

Used by · 9

• register_nav_menu()Registers a navigation menu location for a theme.
• twenty_twenty_one_setup()Sets up theme defaults and registers support for various WordPress features.
• twentyfifteen_setup()Sets up theme defaults and registers support for various WordPress features.
• twentyfourteen_setup()Twenty Fourteen setup.
• twentynineteen_setup()Sets up theme defaults and registers support for various WordPress features.
• twentyseventeen_setup()Sets up theme defaults and registers support for various WordPress features.
• twentysixteen_setup()Sets up theme defaults and registers support for various WordPress features.
• twentyten_setup()Sets up theme defaults and registers support for various WordPress features.
• twentytwenty_menus()Registers navigation menus.

Source

View on Trac ↗View on GitHub ↗

90function register_nav_menus( $locations = array() ) {91	global $_wp_registered_nav_menus;92 93	add_theme_support( 'menus' );94 95	foreach ( $locations as $key => $value ) {96		if ( is_int( $key ) ) {97			_doing_it_wrong( __FUNCTION__, __( 'Nav menu locations must be strings.' ), '5.3.0' );98			break;99		}100	}101 102	$_wp_registered_nav_menus = array_merge( (array) $_wp_registered_nav_menus, $locations );103}

History

Introduced in 3.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/nav-menu.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.