3 * WordPress Administration for Navigation Menus
9 * @subpackage Administration
12 /** Load WordPress Administration Bootstrap */
13 require_once( dirname( __FILE__ ) . '/admin.php' );
15 // Load all the nav menu interface functions
16 require_once( ABSPATH . 'wp-admin/includes/nav-menu.php' );
18 if ( ! current_theme_supports( 'menus' ) && ! current_theme_supports( 'widgets' ) )
19 wp_die( __( 'Your theme does not support navigation menus or widgets.' ) );
22 if ( ! current_user_can( 'edit_theme_options' ) ) {
24 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
25 '<p>' . __( 'You are not allowed to edit theme options on this site.' ) . '</p>',
30 wp_enqueue_script( 'nav-menu' );
33 wp_enqueue_script( 'jquery-touch-punch' );
35 // Container for any messages displayed to the user
38 // Container that stores the name of the active menu
39 $nav_menu_selected_title = '';
41 // The menu id of the current menu being edited
42 $nav_menu_selected_id = isset( $_REQUEST['menu'] ) ? (int) $_REQUEST['menu'] : 0;
44 // Get existing menu locations assignments
45 $locations = get_registered_nav_menus();
46 $menu_locations = get_nav_menu_locations();
47 $num_locations = count( array_keys( $locations ) );
49 // Allowed actions: add, update, delete
50 $action = isset( $_REQUEST['action'] ) ? $_REQUEST['action'] : 'edit';
53 * If a JSON blob of navigation menu data is in POST data, expand it and inject
54 * it into `$_POST` to avoid PHP `max_input_vars` limitations. See #14134.
60 function _wp_expand_nav_menu_post_data() {
61 if ( ! isset( $_POST['nav-menu-data'] ) ) {
65 $data = json_decode( stripslashes( $_POST['nav-menu-data'] ) );
67 if ( ! is_null( $data ) && $data ) {
68 foreach ( $data as $post_input_data ) {
69 // For input names that are arrays (e.g. `menu-item-db-id[3][4][5]`),
70 // derive the array path keys via regex and set the value in $_POST.
71 preg_match( '#([^\[]*)(\[(.+)\])?#', $post_input_data->name, $matches );
73 $array_bits = array( $matches[1] );
75 if ( isset( $matches[3] ) ) {
76 $array_bits = array_merge( $array_bits, explode( '][', $matches[3] ) );
79 $new_post_data = array();
81 // Build the new array value from leaf to trunk.
82 for ( $i = count( $array_bits ) - 1; $i >= 0; $i -- ) {
83 if ( $i == count( $array_bits ) - 1 ) {
84 $new_post_data[ $array_bits[ $i ] ] = wp_slash( $post_input_data->value );
86 $new_post_data = array( $array_bits[ $i ] => $new_post_data );
90 $_POST = array_replace_recursive( $_POST, $new_post_data );
95 if ( ! function_exists( 'array_replace_recursive' ) ) :
97 * PHP-agnostic version of {@link array_replace_recursive()}.
99 * The array_replace_recursive() function is a PHP 5.3 function. WordPress
100 * currently supports down to PHP 5.2, so this method is a workaround
103 * Note: array_replace_recursive() supports infinite arguments, but for our use-
104 * case, we only need to support two arguments.
106 * Subject to removal once WordPress makes PHP 5.3.0 the minimum requirement.
110 * @see http://php.net/manual/en/function.array-replace-recursive.php#109390
112 * @param array $base Array with keys needing to be replaced.
113 * @param array $replacements Array with the replaced keys.
117 function array_replace_recursive( $base = array(), $replacements = array() ) {
118 foreach ( array_slice( func_get_args(), 1 ) as $replacements ) {
119 $bref_stack = array( &$base );
120 $head_stack = array( $replacements );
125 $bref = &$bref_stack[ key( $bref_stack ) ];
126 $head = array_pop( $head_stack );
128 unset( $bref_stack[ key( $bref_stack ) ] );
130 foreach ( array_keys( $head ) as $key ) {
131 if ( isset( $key, $bref ) &&
132 isset( $bref[ $key ] ) && is_array( $bref[ $key ] ) &&
133 isset( $head[ $key ] ) && is_array( $head[ $key ] )
135 $bref_stack[] = &$bref[ $key ];
136 $head_stack[] = $head[ $key ];
138 $bref[ $key ] = $head[ $key ];
141 } while ( count( $head_stack ) );
149 * If a JSON blob of navigation menu data is found, expand it and inject it
150 * into `$_POST` to avoid PHP `max_input_vars` limitations. See #14134.
152 _wp_expand_nav_menu_post_data();
155 case 'add-menu-item':
156 check_admin_referer( 'add-menu_item', 'menu-settings-column-nonce' );
157 if ( isset( $_REQUEST['nav-menu-locations'] ) )
158 set_theme_mod( 'nav_menu_locations', array_map( 'absint', $_REQUEST['menu-locations'] ) );
159 elseif ( isset( $_REQUEST['menu-item'] ) )
160 wp_save_nav_menu_items( $nav_menu_selected_id, $_REQUEST['menu-item'] );
162 case 'move-down-menu-item' :
164 // Moving down a menu item is the same as moving up the next in order.
165 check_admin_referer( 'move-menu_item' );
166 $menu_item_id = isset( $_REQUEST['menu-item'] ) ? (int) $_REQUEST['menu-item'] : 0;
167 if ( is_nav_menu_item( $menu_item_id ) ) {
168 $menus = isset( $_REQUEST['menu'] ) ? array( (int) $_REQUEST['menu'] ) : wp_get_object_terms( $menu_item_id, 'nav_menu', array( 'fields' => 'ids' ) );
169 if ( ! is_wp_error( $menus ) && ! empty( $menus[0] ) ) {
170 $menu_id = (int) $menus[0];
171 $ordered_menu_items = wp_get_nav_menu_items( $menu_id );
172 $menu_item_data = (array) wp_setup_nav_menu_item( get_post( $menu_item_id ) );
174 // Set up the data we need in one pass through the array of menu items.
175 $dbids_to_orders = array();
176 $orders_to_dbids = array();
177 foreach ( (array) $ordered_menu_items as $ordered_menu_item_object ) {
178 if ( isset( $ordered_menu_item_object->ID ) ) {
179 if ( isset( $ordered_menu_item_object->menu_order ) ) {
180 $dbids_to_orders[$ordered_menu_item_object->ID] = $ordered_menu_item_object->menu_order;
181 $orders_to_dbids[$ordered_menu_item_object->menu_order] = $ordered_menu_item_object->ID;
186 // Get next in order.
188 isset( $orders_to_dbids[$dbids_to_orders[$menu_item_id] + 1] )
190 $next_item_id = $orders_to_dbids[$dbids_to_orders[$menu_item_id] + 1];
191 $next_item_data = (array) wp_setup_nav_menu_item( get_post( $next_item_id ) );
193 // If not siblings of same parent, bubble menu item up but keep order.
195 ! empty( $menu_item_data['menu_item_parent'] ) &&
197 empty( $next_item_data['menu_item_parent'] ) ||
198 $next_item_data['menu_item_parent'] != $menu_item_data['menu_item_parent']
202 $parent_db_id = in_array( $menu_item_data['menu_item_parent'], $orders_to_dbids ) ? (int) $menu_item_data['menu_item_parent'] : 0;
204 $parent_object = wp_setup_nav_menu_item( get_post( $parent_db_id ) );
206 if ( ! is_wp_error( $parent_object ) ) {
207 $parent_data = (array) $parent_object;
208 $menu_item_data['menu_item_parent'] = $parent_data['menu_item_parent'];
209 update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
213 // Make menu item a child of its next sibling.
215 $next_item_data['menu_order'] = $next_item_data['menu_order'] - 1;
216 $menu_item_data['menu_order'] = $menu_item_data['menu_order'] + 1;
218 $menu_item_data['menu_item_parent'] = $next_item_data['ID'];
219 update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
221 wp_update_post($menu_item_data);
222 wp_update_post($next_item_data);
225 // The item is last but still has a parent, so bubble up.
227 ! empty( $menu_item_data['menu_item_parent'] ) &&
228 in_array( $menu_item_data['menu_item_parent'], $orders_to_dbids )
230 $menu_item_data['menu_item_parent'] = (int) get_post_meta( $menu_item_data['menu_item_parent'], '_menu_item_menu_item_parent', true);
231 update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
237 case 'move-up-menu-item' :
238 check_admin_referer( 'move-menu_item' );
239 $menu_item_id = isset( $_REQUEST['menu-item'] ) ? (int) $_REQUEST['menu-item'] : 0;
240 if ( is_nav_menu_item( $menu_item_id ) ) {
241 $menus = isset( $_REQUEST['menu'] ) ? array( (int) $_REQUEST['menu'] ) : wp_get_object_terms( $menu_item_id, 'nav_menu', array( 'fields' => 'ids' ) );
242 if ( ! is_wp_error( $menus ) && ! empty( $menus[0] ) ) {
243 $menu_id = (int) $menus[0];
244 $ordered_menu_items = wp_get_nav_menu_items( $menu_id );
245 $menu_item_data = (array) wp_setup_nav_menu_item( get_post( $menu_item_id ) );
247 // Set up the data we need in one pass through the array of menu items.
248 $dbids_to_orders = array();
249 $orders_to_dbids = array();
250 foreach ( (array) $ordered_menu_items as $ordered_menu_item_object ) {
251 if ( isset( $ordered_menu_item_object->ID ) ) {
252 if ( isset( $ordered_menu_item_object->menu_order ) ) {
253 $dbids_to_orders[$ordered_menu_item_object->ID] = $ordered_menu_item_object->menu_order;
254 $orders_to_dbids[$ordered_menu_item_object->menu_order] = $ordered_menu_item_object->ID;
259 // If this menu item is not first.
260 if ( ! empty( $dbids_to_orders[$menu_item_id] ) && ! empty( $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] ) ) {
262 // If this menu item is a child of the previous.
264 ! empty( $menu_item_data['menu_item_parent'] ) &&
265 in_array( $menu_item_data['menu_item_parent'], array_keys( $dbids_to_orders ) ) &&
266 isset( $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] ) &&
267 ( $menu_item_data['menu_item_parent'] == $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] )
269 $parent_db_id = in_array( $menu_item_data['menu_item_parent'], $orders_to_dbids ) ? (int) $menu_item_data['menu_item_parent'] : 0;
270 $parent_object = wp_setup_nav_menu_item( get_post( $parent_db_id ) );
272 if ( ! is_wp_error( $parent_object ) ) {
273 $parent_data = (array) $parent_object;
276 * If there is something before the parent and parent a child of it,
277 * make menu item a child also of it.
280 ! empty( $dbids_to_orders[$parent_db_id] ) &&
281 ! empty( $orders_to_dbids[$dbids_to_orders[$parent_db_id] - 1] ) &&
282 ! empty( $parent_data['menu_item_parent'] )
284 $menu_item_data['menu_item_parent'] = $parent_data['menu_item_parent'];
287 * Else if there is something before parent and parent not a child of it,
288 * make menu item a child of that something's parent
291 ! empty( $dbids_to_orders[$parent_db_id] ) &&
292 ! empty( $orders_to_dbids[$dbids_to_orders[$parent_db_id] - 1] )
294 $_possible_parent_id = (int) get_post_meta( $orders_to_dbids[$dbids_to_orders[$parent_db_id] - 1], '_menu_item_menu_item_parent', true);
295 if ( in_array( $_possible_parent_id, array_keys( $dbids_to_orders ) ) )
296 $menu_item_data['menu_item_parent'] = $_possible_parent_id;
298 $menu_item_data['menu_item_parent'] = 0;
300 // Else there isn't something before the parent.
302 $menu_item_data['menu_item_parent'] = 0;
305 // Set former parent's [menu_order] to that of menu-item's.
306 $parent_data['menu_order'] = $parent_data['menu_order'] + 1;
308 // Set menu-item's [menu_order] to that of former parent.
309 $menu_item_data['menu_order'] = $menu_item_data['menu_order'] - 1;
312 update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
313 wp_update_post($menu_item_data);
314 wp_update_post($parent_data);
317 // Else this menu item is not a child of the previous.
319 empty( $menu_item_data['menu_order'] ) ||
320 empty( $menu_item_data['menu_item_parent'] ) ||
321 ! in_array( $menu_item_data['menu_item_parent'], array_keys( $dbids_to_orders ) ) ||
322 empty( $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] ) ||
323 $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] != $menu_item_data['menu_item_parent']
325 // Just make it a child of the previous; keep the order.
326 $menu_item_data['menu_item_parent'] = (int) $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1];
327 update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
328 wp_update_post($menu_item_data);
335 case 'delete-menu-item':
336 $menu_item_id = (int) $_REQUEST['menu-item'];
338 check_admin_referer( 'delete-menu_item_' . $menu_item_id );
340 if ( is_nav_menu_item( $menu_item_id ) && wp_delete_post( $menu_item_id, true ) )
341 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __('The menu item has been successfully deleted.') . '</p></div>';
345 check_admin_referer( 'delete-nav_menu-' . $nav_menu_selected_id );
346 if ( is_nav_menu( $nav_menu_selected_id ) ) {
347 $deletion = wp_delete_nav_menu( $nav_menu_selected_id );
349 // Reset the selected menu.
350 $nav_menu_selected_id = 0;
351 unset( $_REQUEST['menu'] );
354 if ( ! isset( $deletion ) )
357 if ( is_wp_error( $deletion ) )
358 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . $deletion->get_error_message() . '</p></div>';
360 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __( 'The menu has been successfully deleted.' ) . '</p></div>';
364 check_admin_referer( 'nav_menus_bulk_actions' );
365 foreach ( $_REQUEST['delete_menus'] as $menu_id_to_delete ) {
366 if ( ! is_nav_menu( $menu_id_to_delete ) )
369 $deletion = wp_delete_nav_menu( $menu_id_to_delete );
370 if ( is_wp_error( $deletion ) ) {
371 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . $deletion->get_error_message() . '</p></div>';
372 $deletion_error = true;
376 if ( empty( $deletion_error ) )
377 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __( 'Selected menus have been successfully deleted.' ) . '</p></div>';
381 check_admin_referer( 'update-nav_menu', 'update-nav-menu-nonce' );
383 // Remove menu locations that have been unchecked.
384 foreach ( $locations as $location => $description ) {
385 if ( ( empty( $_POST['menu-locations'] ) || empty( $_POST['menu-locations'][ $location ] ) ) && isset( $menu_locations[ $location ] ) && $menu_locations[ $location ] == $nav_menu_selected_id )
386 unset( $menu_locations[ $location ] );
389 // Merge new and existing menu locations if any new ones are set.
390 if ( isset( $_POST['menu-locations'] ) ) {
391 $new_menu_locations = array_map( 'absint', $_POST['menu-locations'] );
392 $menu_locations = array_merge( $menu_locations, $new_menu_locations );
395 // Set menu locations.
396 set_theme_mod( 'nav_menu_locations', $menu_locations );
399 if ( 0 == $nav_menu_selected_id ) {
400 $new_menu_title = trim( esc_html( $_POST['menu-name'] ) );
402 if ( $new_menu_title ) {
403 $_nav_menu_selected_id = wp_update_nav_menu_object( 0, array('menu-name' => $new_menu_title) );
405 if ( is_wp_error( $_nav_menu_selected_id ) ) {
406 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . $_nav_menu_selected_id->get_error_message() . '</p></div>';
408 $_menu_object = wp_get_nav_menu_object( $_nav_menu_selected_id );
409 $nav_menu_selected_id = $_nav_menu_selected_id;
410 $nav_menu_selected_title = $_menu_object->name;
411 if ( isset( $_REQUEST['menu-item'] ) )
412 wp_save_nav_menu_items( $nav_menu_selected_id, absint( $_REQUEST['menu-item'] ) );
413 if ( isset( $_REQUEST['zero-menu-state'] ) ) {
414 // If there are menu items, add them
415 wp_nav_menu_update_menu_items( $nav_menu_selected_id, $nav_menu_selected_title );
416 // Auto-save nav_menu_locations
417 $locations = get_nav_menu_locations();
418 foreach ( $locations as $location => $menu_id ) {
419 $locations[ $location ] = $nav_menu_selected_id;
420 break; // There should only be 1
422 set_theme_mod( 'nav_menu_locations', $locations );
424 if ( isset( $_REQUEST['use-location'] ) ) {
425 $locations = get_registered_nav_menus();
426 $menu_locations = get_nav_menu_locations();
427 if ( isset( $locations[ $_REQUEST['use-location'] ] ) )
428 $menu_locations[ $_REQUEST['use-location'] ] = $nav_menu_selected_id;
429 set_theme_mod( 'nav_menu_locations', $menu_locations );
432 // $messages[] = '<div id="message" class="updated"><p>' . sprintf( __( '<strong>%s</strong> has been created.' ), $nav_menu_selected_title ) . '</p></div>';
433 wp_redirect( admin_url( 'nav-menus.php?menu=' . $_nav_menu_selected_id ) );
437 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . __( 'Please enter a valid menu name.' ) . '</p></div>';
440 // Update existing menu.
443 $_menu_object = wp_get_nav_menu_object( $nav_menu_selected_id );
445 $menu_title = trim( esc_html( $_POST['menu-name'] ) );
446 if ( ! $menu_title ) {
447 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . __( 'Please enter a valid menu name.' ) . '</p></div>';
448 $menu_title = $_menu_object->name;
451 if ( ! is_wp_error( $_menu_object ) ) {
452 $_nav_menu_selected_id = wp_update_nav_menu_object( $nav_menu_selected_id, array( 'menu-name' => $menu_title ) );
453 if ( is_wp_error( $_nav_menu_selected_id ) ) {
454 $_menu_object = $_nav_menu_selected_id;
455 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . $_nav_menu_selected_id->get_error_message() . '</p></div>';
457 $_menu_object = wp_get_nav_menu_object( $_nav_menu_selected_id );
458 $nav_menu_selected_title = $_menu_object->name;
462 // Update menu items.
463 if ( ! is_wp_error( $_menu_object ) ) {
464 $messages = array_merge( $messages, wp_nav_menu_update_menu_items( $_nav_menu_selected_id, $nav_menu_selected_title ) );
466 // If the menu ID changed, redirect to the new URL.
467 if ( $nav_menu_selected_id != $_nav_menu_selected_id ) {
468 wp_redirect( admin_url( 'nav-menus.php?menu=' . intval( $_nav_menu_selected_id ) ) );
475 if ( ! $num_locations ) {
476 wp_redirect( admin_url( 'nav-menus.php' ) );
480 add_filter( 'screen_options_show_screen', '__return_false' );
482 if ( isset( $_POST['menu-locations'] ) ) {
483 check_admin_referer( 'save-menu-locations' );
485 $new_menu_locations = array_map( 'absint', $_POST['menu-locations'] );
486 $menu_locations = array_merge( $menu_locations, $new_menu_locations );
487 // Set menu locations
488 set_theme_mod( 'nav_menu_locations', $menu_locations );
490 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __( 'Menu locations updated.' ) . '</p></div>';
495 // Get all nav menus.
496 $nav_menus = wp_get_nav_menus();
497 $menu_count = count( $nav_menus );
499 // Are we on the add new screen?
500 $add_new_screen = ( isset( $_GET['menu'] ) && 0 == $_GET['menu'] ) ? true : false;
502 $locations_screen = ( isset( $_GET['action'] ) && 'locations' == $_GET['action'] ) ? true : false;
505 * If we have one theme location, and zero menus, we take them right
506 * into editing their first menu.
508 $page_count = wp_count_posts( 'page' );
509 $one_theme_location_no_menus = ( 1 == count( get_registered_nav_menus() ) && ! $add_new_screen && empty( $nav_menus ) && ! empty( $page_count->publish ) ) ? true : false;
511 $nav_menus_l10n = array(
512 'oneThemeLocationNoMenus' => $one_theme_location_no_menus,
513 'moveUp' => __( 'Move up one' ),
514 'moveDown' => __( 'Move down one' ),
515 'moveToTop' => __( 'Move to the top' ),
516 /* translators: %s: previous item name */
517 'moveUnder' => __( 'Move under %s' ),
518 /* translators: %s: previous item name */
519 'moveOutFrom' => __( 'Move out from under %s' ),
520 /* translators: %s: previous item name */
521 'under' => __( 'Under %s' ),
522 /* translators: %s: previous item name */
523 'outFrom' => __( 'Out from under %s' ),
524 /* translators: 1: item name, 2: item position, 3: total number of items */
525 'menuFocus' => __( '%1$s. Menu item %2$d of %3$d.' ),
526 /* translators: 1: item name, 2: item position, 3: parent item name */
527 'subMenuFocus' => __( '%1$s. Sub item number %2$d under %3$s.' ),
529 wp_localize_script( 'nav-menu', 'menus', $nav_menus_l10n );
532 * Redirect to add screen if there are no menus and this users has either zero,
533 * or more than 1 theme locations.
535 if ( 0 == $menu_count && ! $add_new_screen && ! $one_theme_location_no_menus )
536 wp_redirect( admin_url( 'nav-menus.php?action=edit&menu=0' ) );
538 // Get recently edited nav menu.
539 $recently_edited = absint( get_user_option( 'nav_menu_recently_edited' ) );
540 if ( empty( $recently_edited ) && is_nav_menu( $nav_menu_selected_id ) )
541 $recently_edited = $nav_menu_selected_id;
543 // Use $recently_edited if none are selected.
544 if ( empty( $nav_menu_selected_id ) && ! isset( $_GET['menu'] ) && is_nav_menu( $recently_edited ) )
545 $nav_menu_selected_id = $recently_edited;
547 // On deletion of menu, if another menu exists, show it.
548 if ( ! $add_new_screen && 0 < $menu_count && isset( $_GET['action'] ) && 'delete' == $_GET['action'] )
549 $nav_menu_selected_id = $nav_menus[0]->term_id;
551 // Set $nav_menu_selected_id to 0 if no menus.
552 if ( $one_theme_location_no_menus ) {
553 $nav_menu_selected_id = 0;
554 } elseif ( empty( $nav_menu_selected_id ) && ! empty( $nav_menus ) && ! $add_new_screen ) {
555 // if we have no selection yet, and we have menus, set to the first one in the list.
556 $nav_menu_selected_id = $nav_menus[0]->term_id;
559 // Update the user's setting.
560 if ( $nav_menu_selected_id != $recently_edited && is_nav_menu( $nav_menu_selected_id ) )
561 update_user_meta( $current_user->ID, 'nav_menu_recently_edited', $nav_menu_selected_id );
563 // If there's a menu, get its name.
564 if ( ! $nav_menu_selected_title && is_nav_menu( $nav_menu_selected_id ) ) {
565 $_menu_object = wp_get_nav_menu_object( $nav_menu_selected_id );
566 $nav_menu_selected_title = ! is_wp_error( $_menu_object ) ? $_menu_object->name : '';
569 // Generate truncated menu names.
570 foreach ( (array) $nav_menus as $key => $_nav_menu ) {
571 $nav_menus[$key]->truncated_name = wp_html_excerpt( $_nav_menu->name, 40, '…' );
574 // Retrieve menu locations.
575 if ( current_theme_supports( 'menus' ) ) {
576 $locations = get_registered_nav_menus();
577 $menu_locations = get_nav_menu_locations();
581 * Ensure the user will be able to scroll horizontally
582 * by adding a class for the max menu depth.
584 * @global int $_wp_nav_menu_max_depth
586 global $_wp_nav_menu_max_depth;
587 $_wp_nav_menu_max_depth = 0;
589 // Calling wp_get_nav_menu_to_edit generates $_wp_nav_menu_max_depth.
590 if ( is_nav_menu( $nav_menu_selected_id ) ) {
591 $menu_items = wp_get_nav_menu_items( $nav_menu_selected_id, array( 'post_status' => 'any' ) );
592 $edit_markup = wp_get_nav_menu_to_edit( $nav_menu_selected_id );
597 * @global int $_wp_nav_menu_max_depth
599 * @param string $classes
602 function wp_nav_menu_max_depth( $classes ) {
603 global $_wp_nav_menu_max_depth;
604 return "$classes menu-max-depth-$_wp_nav_menu_max_depth";
607 add_filter('admin_body_class', 'wp_nav_menu_max_depth');
610 wp_initial_nav_menu_meta_boxes();
612 if ( ! current_theme_supports( 'menus' ) && ! $num_locations )
613 $messages[] = '<div id="message" class="updated"><p>' . sprintf( __( 'Your theme does not natively support menus, but you can use them in sidebars by adding a “Custom Menu” widget on the <a href="%s">Widgets</a> screen.' ), admin_url( 'widgets.php' ) ) . '</p></div>';
615 if ( ! $locations_screen ) : // Main tab
616 $overview = '<p>' . __( 'This screen is used for managing your custom navigation menus.' ) . '</p>';
617 $overview .= '<p>' . sprintf( __( 'Menus can be displayed in locations defined by your theme, even used in sidebars by adding a “Custom Menu” widget on the <a href="%1$s">Widgets</a> screen. If your theme does not support the custom menus feature (the default themes, %2$s and %3$s, do), you can learn about adding this support by following the Documentation link to the side.' ), admin_url( 'widgets.php' ), 'Twenty Fifteen', 'Twenty Fourteen' ) . '</p>';
618 $overview .= '<p>' . __( 'From this screen you can:' ) . '</p>';
619 $overview .= '<ul><li>' . __( 'Create, edit, and delete menus' ) . '</li>';
620 $overview .= '<li>' . __( 'Add, organize, and modify individual menu items' ) . '</li></ul>';
622 get_current_screen()->add_help_tab( array(
624 'title' => __( 'Overview' ),
625 'content' => $overview
628 $menu_management = '<p>' . __( 'The menu management box at the top of the screen is used to control which menu is opened in the editor below.' ) . '</p>';
629 $menu_management .= '<ul><li>' . __( 'To edit an existing menu, <strong>choose a menu from the drop down and click Select</strong>' ) . '</li>';
630 $menu_management .= '<li>' . __( 'If you haven’t yet created any menus, <strong>click the ’create a new menu’ link</strong> to get started' ) . '</li></ul>';
631 $menu_management .= '<p>' . __( 'You can assign theme locations to individual menus by <strong>selecting the desired settings</strong> at the bottom of the menu editor. To assign menus to all theme locations at once, <strong>visit the Manage Locations tab</strong> at the top of the screen.' ) . '</p>';
633 get_current_screen()->add_help_tab( array(
634 'id' => 'menu-management',
635 'title' => __( 'Menu Management' ),
636 'content' => $menu_management
639 $editing_menus = '<p>' . __( 'Each custom menu may contain a mix of links to pages, categories, custom URLs or other content types. Menu links are added by selecting items from the expanding boxes in the left-hand column below.' ) . '</p>';
640 $editing_menus .= '<p>' . __( '<strong>Clicking the arrow to the right of any menu item</strong> in the editor will reveal a standard group of settings. Additional settings such as link target, CSS classes, link relationships, and link descriptions can be enabled and disabled via the Screen Options tab.' ) . '</p>';
641 $editing_menus .= '<ul><li>' . __( 'Add one or several items at once by <strong>selecting the checkbox next to each item and clicking Add to Menu</strong>' ) . '</li>';
642 $editing_menus .= '<li>' . __( 'To add a custom link, <strong>expand the Custom Links section, enter a URL and link text, and click Add to Menu</strong>' ) .'</li>';
643 $editing_menus .= '<li>' . __( 'To reorganize menu items, <strong>drag and drop items with your mouse or use your keyboard</strong>. Drag or move a menu item a little to the right to make it a submenu' ) . '</li>';
644 $editing_menus .= '<li>' . __( 'Delete a menu item by <strong>expanding it and clicking the Remove link</strong>' ) . '</li></ul>';
646 get_current_screen()->add_help_tab( array(
647 'id' => 'editing-menus',
648 'title' => __( 'Editing Menus' ),
649 'content' => $editing_menus
651 else : // Locations Tab.
652 $locations_overview = '<p>' . __( 'This screen is used for globally assigning menus to locations defined by your theme.' ) . '</p>';
653 $locations_overview .= '<ul><li>' . __( 'To assign menus to one or more theme locations, <strong>select a menu from each location’s drop down.</strong> When you’re finished, <strong>click Save Changes</strong>' ) . '</li>';
654 $locations_overview .= '<li>' . __( 'To edit a menu currently assigned to a theme location, <strong>click the adjacent ’Edit’ link</strong>' ) . '</li>';
655 $locations_overview .= '<li>' . __( 'To add a new menu instead of assigning an existing one, <strong>click the ’Use new menu’ link</strong>. Your new menu will be automatically assigned to that theme location' ) . '</li></ul>';
657 get_current_screen()->add_help_tab( array(
658 'id' => 'locations-overview',
659 'title' => __( 'Overview' ),
660 'content' => $locations_overview
664 get_current_screen()->set_help_sidebar(
665 '<p><strong>' . __('For more information:') . '</strong></p>' .
666 '<p>' . __('<a href="https://codex.wordpress.org/Appearance_Menus_Screen" target="_blank">Documentation on Menus</a>') . '</p>' .
667 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
670 // Get the admin header.
671 require_once( ABSPATH . 'wp-admin/admin-header.php' );
674 <h1><?php echo esc_html( __( 'Menus' ) ); ?>
676 if ( current_user_can( 'customize' ) ) :
677 $focus = $locations_screen ? array( 'section' => 'menu_locations' ) : array( 'panel' => 'nav_menus' );
679 ' <a class="page-title-action hide-if-no-customize" href="%1$s">%2$s</a>',
680 esc_url( add_query_arg( array(
681 array( 'autofocus' => $focus ),
682 'return' => urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ),
683 ), admin_url( 'customize.php' ) ) ),
684 __( 'Manage in Customizer' )
689 <h2 class="nav-tab-wrapper wp-clearfix">
690 <a href="<?php echo admin_url( 'nav-menus.php' ); ?>" class="nav-tab<?php if ( ! isset( $_GET['action'] ) || isset( $_GET['action'] ) && 'locations' != $_GET['action'] ) echo ' nav-tab-active'; ?>"><?php esc_html_e( 'Edit Menus' ); ?></a>
691 <?php if ( $num_locations && $menu_count ) : ?>
692 <a href="<?php echo esc_url( add_query_arg( array( 'action' => 'locations' ), admin_url( 'nav-menus.php' ) ) ); ?>" class="nav-tab<?php if ( $locations_screen ) echo ' nav-tab-active'; ?>"><?php esc_html_e( 'Manage Locations' ); ?></a>
698 foreach ( $messages as $message ) :
699 echo $message . "\n";
703 if ( $locations_screen ) :
704 if ( 1 == $num_locations ) {
705 echo '<p>' . __( 'Your theme supports one menu. Select which menu you would like to use.' ) . '</p>';
707 echo '<p>' . sprintf( _n( 'Your theme supports %s menu. Select which menu appears in each location.', 'Your theme supports %s menus. Select which menu appears in each location.', $num_locations ), number_format_i18n( $num_locations ) ) . '</p>';
710 <div id="menu-locations-wrap">
711 <form method="post" action="<?php echo esc_url( add_query_arg( array( 'action' => 'locations' ), admin_url( 'nav-menus.php' ) ) ); ?>">
712 <table class="widefat fixed" id="menu-locations-table">
715 <th scope="col" class="manage-column column-locations"><?php _e( 'Theme Location' ); ?></th>
716 <th scope="col" class="manage-column column-menus"><?php _e( 'Assigned Menu' ); ?></th>
719 <tbody class="menu-locations">
720 <?php foreach ( $locations as $_location => $_name ) { ?>
721 <tr class="menu-locations-row">
722 <td class="menu-location-title"><label for="locations-<?php echo $_location; ?>"><?php echo $_name; ?></label></td>
723 <td class="menu-location-menus">
724 <select name="menu-locations[<?php echo $_location; ?>]" id="locations-<?php echo $_location; ?>">
725 <option value="0"><?php printf( '— %s —', esc_html__( 'Select a Menu' ) ); ?></option>
726 <?php foreach ( $nav_menus as $menu ) : ?>
727 <?php $selected = isset( $menu_locations[$_location] ) && $menu_locations[$_location] == $menu->term_id; ?>
728 <option <?php if ( $selected ) echo 'data-orig="true"'; ?> <?php selected( $selected ); ?> value="<?php echo $menu->term_id; ?>">
729 <?php echo wp_html_excerpt( $menu->name, 40, '…' ); ?>
733 <div class="locations-row-links">
734 <?php if ( isset( $menu_locations[ $_location ] ) && 0 != $menu_locations[ $_location ] ) : ?>
735 <span class="locations-edit-menu-link">
736 <a href="<?php echo esc_url( add_query_arg( array( 'action' => 'edit', 'menu' => $menu_locations[$_location] ), admin_url( 'nav-menus.php' ) ) ); ?>">
737 <span aria-hidden="true"><?php _ex( 'Edit', 'menu' ); ?></span><span class="screen-reader-text"><?php _e( 'Edit selected menu' ); ?></span>
741 <span class="locations-add-menu-link">
742 <a href="<?php echo esc_url( add_query_arg( array( 'action' => 'edit', 'menu' => 0, 'use-location' => $_location ), admin_url( 'nav-menus.php' ) ) ); ?>">
743 <?php _ex( 'Use new menu', 'menu' ); ?>
746 </div><!-- .locations-row-links -->
747 </td><!-- .menu-location-menus -->
748 </tr><!-- .menu-locations-row -->
749 <?php } // foreach ?>
752 <p class="button-controls wp-clearfix"><?php submit_button( __( 'Save Changes' ), 'primary left', 'nav-menu-locations', false ); ?></p>
753 <?php wp_nonce_field( 'save-menu-locations' ); ?>
754 <input type="hidden" name="menu" id="nav-menu-meta-object-id" value="<?php echo esc_attr( $nav_menu_selected_id ); ?>" />
756 </div><!-- #menu-locations-wrap -->
759 * Fires after the menu locations table is displayed.
763 do_action( 'after_menu_locations_table' ); ?>
765 <div class="manage-menus">
766 <?php if ( $menu_count < 2 ) : ?>
767 <span class="add-edit-menu-action">
768 <?php printf( __( 'Edit your menu below, or <a href="%s">create a new menu</a>.' ), esc_url( add_query_arg( array( 'action' => 'edit', 'menu' => 0 ), admin_url( 'nav-menus.php' ) ) ) ); ?>
769 </span><!-- /add-edit-menu-action -->
771 <form method="get" action="<?php echo admin_url( 'nav-menus.php' ); ?>">
772 <input type="hidden" name="action" value="edit" />
773 <label for="select-menu-to-edit" class="selected-menu"><?php _e( 'Select a menu to edit:' ); ?></label>
774 <select name="menu" id="select-menu-to-edit">
775 <?php if ( $add_new_screen ) : ?>
776 <option value="0" selected="selected"><?php _e( '— Select —' ); ?></option>
778 <?php foreach ( (array) $nav_menus as $_nav_menu ) : ?>
779 <option value="<?php echo esc_attr( $_nav_menu->term_id ); ?>" <?php selected( $_nav_menu->term_id, $nav_menu_selected_id ); ?>>
781 echo esc_html( $_nav_menu->truncated_name ) ;
783 if ( ! empty( $menu_locations ) && in_array( $_nav_menu->term_id, $menu_locations ) ) {
784 $locations_assigned_to_this_menu = array();
785 foreach ( array_keys( $menu_locations, $_nav_menu->term_id ) as $menu_location_key ) {
786 if ( isset( $locations[ $menu_location_key ] ) ) {
787 $locations_assigned_to_this_menu[] = $locations[ $menu_location_key ];
792 * Filter the number of locations listed per menu in the drop-down select.
796 * @param int $locations Number of menu locations to list. Default 3.
798 $assigned_locations = array_slice( $locations_assigned_to_this_menu, 0, absint( apply_filters( 'wp_nav_locations_listed_per_menu', 3 ) ) );
800 // Adds ellipses following the number of locations defined in $assigned_locations.
801 if ( ! empty( $assigned_locations ) ) {
802 printf( ' (%1$s%2$s)',
803 implode( ', ', $assigned_locations ),
804 count( $locations_assigned_to_this_menu ) > count( $assigned_locations ) ? ' …' : ''
812 <span class="submit-btn"><input type="submit" class="button-secondary" value="<?php esc_attr_e( 'Select' ); ?>"></span>
813 <span class="add-new-menu-action">
814 <?php printf( __( 'or <a href="%s">create a new menu</a>.' ), esc_url( add_query_arg( array( 'action' => 'edit', 'menu' => 0 ), admin_url( 'nav-menus.php' ) ) ) ); ?>
815 </span><!-- /add-new-menu-action -->
818 </div><!-- /manage-menus -->
819 <div id="nav-menus-frame" class="wp-clearfix">
820 <div id="menu-settings-column" class="metabox-holder<?php if ( isset( $_GET['menu'] ) && '0' == $_GET['menu'] ) { echo ' metabox-holder-disabled'; } ?>">
822 <div class="clear"></div>
824 <form id="nav-menu-meta" class="nav-menu-meta" method="post" enctype="multipart/form-data">
825 <input type="hidden" name="menu" id="nav-menu-meta-object-id" value="<?php echo esc_attr( $nav_menu_selected_id ); ?>" />
826 <input type="hidden" name="action" value="add-menu-item" />
827 <?php wp_nonce_field( 'add-menu_item', 'menu-settings-column-nonce' ); ?>
828 <?php do_accordion_sections( 'nav-menus', 'side', null ); ?>
831 </div><!-- /#menu-settings-column -->
832 <div id="menu-management-liquid">
833 <div id="menu-management">
834 <form id="update-nav-menu" method="post" enctype="multipart/form-data">
835 <div class="menu-edit <?php if ( $add_new_screen ) echo 'blank-slate'; ?>">
836 <input type="hidden" name="nav-menu-data">
838 wp_nonce_field( 'closedpostboxes', 'closedpostboxesnonce', false );
839 wp_nonce_field( 'meta-box-order', 'meta-box-order-nonce', false );
840 wp_nonce_field( 'update-nav_menu', 'update-nav-menu-nonce' );
842 $menu_name_aria_desc = $add_new_screen ? ' aria-describedby="menu-name-desc"' : '';
844 if ( $one_theme_location_no_menus ) {
845 $menu_name_val = 'value="' . esc_attr( 'Menu 1' ) . '"';
847 <input type="hidden" name="zero-menu-state" value="true" />
849 $menu_name_val = 'value="' . esc_attr( $nav_menu_selected_title ) . '"';
851 <input type="hidden" name="action" value="update" />
852 <input type="hidden" name="menu" id="menu" value="<?php echo esc_attr( $nav_menu_selected_id ); ?>" />
853 <div id="nav-menu-header">
854 <div class="major-publishing-actions wp-clearfix">
855 <label class="menu-name-label" for="menu-name"><?php _e( 'Menu Name' ); ?></label>
856 <input name="menu-name" id="menu-name" type="text" class="menu-name regular-text menu-item-textbox" <?php echo $menu_name_val . $menu_name_aria_desc; ?> />
857 <div class="publishing-action">
858 <?php submit_button( empty( $nav_menu_selected_id ) ? __( 'Create Menu' ) : __( 'Save Menu' ), 'button-primary menu-save', 'save_menu', false, array( 'id' => 'save_menu_header' ) ); ?>
859 </div><!-- END .publishing-action -->
860 </div><!-- END .major-publishing-actions -->
861 </div><!-- END .nav-menu-header -->
863 <div id="post-body-content" class="wp-clearfix">
864 <?php if ( ! $add_new_screen ) : ?>
865 <h3><?php _e( 'Menu Structure' ); ?></h3>
866 <?php $starter_copy = ( $one_theme_location_no_menus ) ? __( 'Edit your default menu by adding or removing items. Drag each item into the order you prefer. Click Create Menu to save your changes.' ) : __( 'Drag each item into the order you prefer. Click the arrow on the right of the item to reveal additional configuration options.' ); ?>
867 <div class="drag-instructions post-body-plain" <?php if ( isset( $menu_items ) && 0 == count( $menu_items ) ) { ?>style="display: none;"<?php } ?>>
868 <p><?php echo $starter_copy; ?></p>
871 if ( isset( $edit_markup ) && ! is_wp_error( $edit_markup ) ) {
875 <ul class="menu" id="menu-to-edit"></ul>
878 <?php if ( $add_new_screen ) : ?>
879 <p class="post-body-plain" id="menu-name-desc"><?php _e( 'Give your menu a name, then click Create Menu.' ); ?></p>
880 <?php if ( isset( $_GET['use-location'] ) ) : ?>
881 <input type="hidden" name="use-location" value="<?php echo esc_attr( $_GET['use-location'] ); ?>" />
884 <div class="menu-settings" <?php if ( $one_theme_location_no_menus ) { ?>style="display: none;"<?php } ?>>
885 <h3><?php _e( 'Menu Settings' ); ?></h3>
887 if ( ! isset( $auto_add ) ) {
888 $auto_add = get_option( 'nav_menu_options' );
889 if ( ! isset( $auto_add['auto_add'] ) )
891 elseif ( false !== array_search( $nav_menu_selected_id, $auto_add['auto_add'] ) )
897 <dl class="auto-add-pages">
898 <dt class="howto"><?php _e( 'Auto add pages' ); ?></dt>
899 <dd class="checkbox-input"><input type="checkbox"<?php checked( $auto_add ); ?> name="auto-add-pages" id="auto-add-pages" value="1" /> <label for="auto-add-pages"><?php printf( __('Automatically add new top-level pages to this menu' ), esc_url( admin_url( 'edit.php?post_type=page' ) ) ); ?></label></dd>
902 <?php if ( current_theme_supports( 'menus' ) ) : ?>
904 <dl class="menu-theme-locations">
905 <dt class="howto"><?php _e( 'Theme locations' ); ?></dt>
906 <?php foreach ( $locations as $location => $description ) : ?>
907 <dd class="checkbox-input">
908 <input type="checkbox"<?php checked( isset( $menu_locations[ $location ] ) && $menu_locations[ $location ] == $nav_menu_selected_id ); ?> name="menu-locations[<?php echo esc_attr( $location ); ?>]" id="locations-<?php echo esc_attr( $location ); ?>" value="<?php echo esc_attr( $nav_menu_selected_id ); ?>" />
909 <label for="locations-<?php echo esc_attr( $location ); ?>"><?php echo $description; ?></label>
910 <?php if ( ! empty( $menu_locations[ $location ] ) && $menu_locations[ $location ] != $nav_menu_selected_id ) : ?>
911 <span class="theme-location-set"><?php
912 /* translators: %s: menu name */
913 printf( _x( '(Currently set to: %s)', 'menu location' ),
914 wp_get_nav_menu_object( $menu_locations[ $location ] )->name
925 </div><!-- /#post-body-content -->
926 </div><!-- /#post-body -->
927 <div id="nav-menu-footer">
928 <div class="major-publishing-actions wp-clearfix">
929 <?php if ( 0 != $menu_count && ! $add_new_screen ) : ?>
930 <span class="delete-action">
931 <a class="submitdelete deletion menu-delete" href="<?php echo esc_url( wp_nonce_url( add_query_arg( array( 'action' => 'delete', 'menu' => $nav_menu_selected_id ), admin_url( 'nav-menus.php' ) ), 'delete-nav_menu-' . $nav_menu_selected_id) ); ?>"><?php _e('Delete Menu'); ?></a>
932 </span><!-- END .delete-action -->
934 <div class="publishing-action">
935 <?php submit_button( empty( $nav_menu_selected_id ) ? __( 'Create Menu' ) : __( 'Save Menu' ), 'button-primary menu-save', 'save_menu', false, array( 'id' => 'save_menu_footer' ) ); ?>
936 </div><!-- END .publishing-action -->
937 </div><!-- END .major-publishing-actions -->
938 </div><!-- /#nav-menu-footer -->
939 </div><!-- /.menu-edit -->
940 </form><!-- /#update-nav-menu -->
941 </div><!-- /#menu-management -->
942 </div><!-- /#menu-management-liquid -->
943 </div><!-- /#nav-menus-frame -->
946 <?php include( ABSPATH . 'wp-admin/admin-footer.php' ); ?>