Codex

Function Reference/register nav menu

Languages: English • 日本語 • Português do Brasil • (Add your language)

Contents

Description

Registers a single custom navigation menu 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_menus() for creating multiple menus at once.

Usage

 <?php register_nav_menu( $location, $description ); ?> 

Parameters

$location
(string) (required) Menu location identifier, like a slug.
Default: None
$description
(string) (required) The default value to return if no value is returned (ie. the option is not in the database).
Default: None

Return Values

None.

Examples 

<?php
register_nav_menu( 'primary', 'Primary Menu' );
?>

Notes

  • This function automatically registers custom menu support for the theme therefore you do not need to call add_theme_support( 'menus' );
  • This function actually works by simply calling register_nav_menus() in the following way: 
    register_nav_menus( array( $location => $description ) );
  • Use wp_nav_menu() to display your custom menu.

Change Log

Source File

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

Related

Navigation Menu: register_nav_menus(), register_nav_menu(), unregister_nav_menu(), has_nav_menu(), wp_nav_menu(), wp_get_nav_menu_items()

See also index of Function Reference and index of Template Tags.
Retrieved from "http://codex.wordpress.org/Function_Reference/register_nav_menu"

Codex Resources