WordPress.org

Function Reference/register nav menus

Languages: English • 日本語 • (Add your language)

Description

Registers multiple custom navigation menus in the new custom menu editor of WordPress 3.0. This allows for creation of custom menus in the dashboard for use in your theme.

See register_nav_menu() for creating a single menu, and Navigation Menus for adding theme support.

Usage

<?php register_nav_menus( $locations ); ?>

Parameters

$locations

(array) (required) An associated array of menu location slugs (key) and descriptions (according value).

Default: None

Return Values

None.

Examples

if ( function_exists( 'register_nav_menus' ) ) {
	register_nav_menus(
		array(
		  'pluginbuddy_mobile' => 'PluginBuddy Mobile Navigation Menu',
		  'foot_menu' => 'My Custom Footer Menu'
		)
	);
}

Notes

This function automatically registers custom menu support for the theme therefore you do not need to call add_theme_support( 'menus' );
Verify the function exists prior to usage to provide backwards compatibility before WordPress 3.0.0:

if ( function_exists( 'register_nav_menus' ) ) {
	...
}

Use wp_nav_menu() to display your custom menu.
In the Menus admin page, there is a Show advanced menu properties to allow "Link Target" "CSS Classes" "Link Relationship (XFN) Description"

Change Log

Since: 3.0.0

Source File

register_nav_menus() is located in wp-includes/nav-menu.php.

WordPress.org

Codex

Function Reference/register nav menus

Contents