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

User Contributed Notes

1. Skip to note 6 content

   SeherKhan 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 10You must log in to vote on the helpfulness of this note

   if ( ! function_exists( 'mytheme_register_nav_menu' ) ) {
   
   	function mytheme_register_nav_menu(){
   		register_nav_menus( array(
   	    	'primary_menu' => __( 'Primary Menu', 'text_domain' ),
   	    	'footer_menu'  => __( 'Footer Menu', 'text_domain' ),
   		) );
   	}
   	add_action( 'after_setup_theme', 'mytheme_register_nav_menu', 0 );
   }
2. Skip to note 7 content

   cebbi 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   Refactoring Menu Slugs:

   If you just rename the slug of a registered menu location, it will disappear from the frontend. This means you need to reassign the menu to the new location in the dashboard.

   In order to edit the slug of a menu location while automatically keeping the previously assigned menu, customize and use the following snippet after renaming the slug in register_nav_menu():

   function cebbi_update_menu_location() {
   
   	// Get assigned menus from theme mods
   	$nav_menu_locations = get_theme_mod('nav_menu_locations');
   
   	// Check if old-slug was previously assigned
   	if (isset($nav_menu_locations['old-slug'])) {
   
   		// Verify that new location does not yet exist or is empty to avoid overwriting manual changes
   		if (!isset($nav_menu_locations['new-slug']) || $nav_menu_locations['new-slug'] === 0) { 
   
   			// Copy assigned menu index to new location
   			$nav_menu_locations['new-slug'] = $nav_menu_locations['old-slug'];
   
   			// Optional: delete the menu assignment to the old location
   			unset($nav_menu_locations['old-slug']);
   
   			// Update theme mod
   			set_theme_mod('nav_menu_locations', $nav_menu_locations);
   		}
   	}
   }
   add_action('after_setup_theme', 'cebbi_update_menu_location');

   Also, don’t forget to update the slug where it’s used to display the menu (wp_nav_menu(), has_nav_menu()).

   You can use get_registered_nav_menus() to verify that the old-slug is not registered in your theme, before removing the assigned menu.
3. Skip to note 8 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Example

   register_nav_menus( array(
   	'pluginbuddy_mobile' => 'PluginBuddy Mobile Navigation Menu',
   	'footer_menu' => 'My Custom Footer Menu',
   ) );
4. Skip to note 9 content

   Khoi Pro 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Creating menus from your Custom Taxonomies.

   For example: I have a custom taxonomy named ‘Country’ with a few countries in list.
   Right now I want to assign each country has a private name and using it for condition displayed on frontend.

   $tax = 'country-category';
   
   $terms = get_terms( $tax, [
   'hide_empty' => false,
   ]);
   
   $args = array(
   'primary' => __( 'Primary Menu', 'khoipro' ),
   'secondary' => __( 'Secondary Menu', 'khoipro' )
   );
   
   // Loop through all terms to add term id as menu id and term name as menu name.
   foreach( $terms as $term) {
   $args = array_merge($args, array(
   'primary_'.$term->slug => 'Country Menu ('.$term->name.')'
   ));
   }
   
   register_nav_menus( $args );

   So my output codes should be displayed in Menus > Manage Locations:

   * Primary Menu (id: primary)
   * Secondary Menu (id: secondary)
   * Country Menu (Japan) (id: primary_japan)
   * Country Menu (Singapore) (id: primary_singapore)
   * Country menu (Vietnam) (id: primary_vietnam)

   Have a proof in a real practice with a newly created project.
5. Skip to note 10 content

   Abdallah Youssef 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   //function to add nav menu in Navigation Bar and Footer Bar:
   
   function add_nav_menus() {
       register_nav_menus( array(
           'nav menu'=>'Navigation Bar',
           'footer menu'=> 'Footer Bar',
       ));
   }
   add_action('init', 'add_nav_menus');