Function Reference/register nav menus

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

1 Description
2 Usage
3 Parameters
4 Return Values
5 Examples
6 Notes
7 Change Log
8 Source File
9 Resources
10 Related

Description

Registers multiple custom navigation menus in the new custom menu editor of WordPress 3.0. This allows for the 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 associative array of menu location slugs (key) and descriptions (according value).

Default: None

Return Values

None.

Examples

add_action( 'after_setup_theme', 'register_custom_nav_menus' );
function register_custom_nav_menus() {
	register_nav_menus( array(
		'pluginbuddy_mobile' => 'PluginBuddy Mobile Navigation Menu',
		'footer_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' );
Use wp_nav_menu() to display your custom menu.
On the Menus admin page, there is a Show advanced menu properties to allow "Link Target" "CSS Classes" "Link Relationship (XFN) Description"
Use get_registered_nav_menus to get back a list of the menus that have been registered in a theme.

Change Log

Since: 3.0.0

Source File

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

Resources

WordPress Navigation Menu Generator

Navigation Menu

See also index of Function Reference and index of Template Tags.

WordPress.org

Codex