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') )
23
wp_die( __( 'Cheatin’ uh?' ) );
25
wp_enqueue_script( 'nav-menu' );
28
wp_enqueue_script( 'jquery-touch-punch' );
30
// Container for any messages displayed to the user
33
// Container that stores the name of the active menu
34
$nav_menu_selected_title = '';
36
// The menu id of the current menu being edited
37
$nav_menu_selected_id = isset( $_REQUEST['menu'] ) ? (int) $_REQUEST['menu'] : 0;
39
// Get existing menu locations assignments
40
$locations = get_registered_nav_menus();
41
$menu_locations = get_nav_menu_locations();
42
$num_locations = count( array_keys( $locations ) );
44
// Allowed actions: add, update, delete
45
$action = isset( $_REQUEST['action'] ) ? $_REQUEST['action'] : 'edit';
49
check_admin_referer( 'add-menu_item', 'menu-settings-column-nonce' );
50
if ( isset( $_REQUEST['nav-menu-locations'] ) )
51
set_theme_mod( 'nav_menu_locations', array_map( 'absint', $_REQUEST['menu-locations'] ) );
52
elseif ( isset( $_REQUEST['menu-item'] ) )
53
wp_save_nav_menu_items( $nav_menu_selected_id, $_REQUEST['menu-item'] );
55
case 'move-down-menu-item' :
57
// Moving down a menu item is the same as moving up the next in order.
58
check_admin_referer( 'move-menu_item' );
59
$menu_item_id = isset( $_REQUEST['menu-item'] ) ? (int) $_REQUEST['menu-item'] : 0;
60
if ( is_nav_menu_item( $menu_item_id ) ) {
61
$menus = isset( $_REQUEST['menu'] ) ? array( (int) $_REQUEST['menu'] ) : wp_get_object_terms( $menu_item_id, 'nav_menu', array( 'fields' => 'ids' ) );
62
if ( ! is_wp_error( $menus ) && ! empty( $menus[0] ) ) {
63
$menu_id = (int) $menus[0];
64
$ordered_menu_items = wp_get_nav_menu_items( $menu_id );
65
$menu_item_data = (array) wp_setup_nav_menu_item( get_post( $menu_item_id ) );
67
// Set up the data we need in one pass through the array of menu items.
68
$dbids_to_orders = array();
69
$orders_to_dbids = array();
70
foreach( (array) $ordered_menu_items as $ordered_menu_item_object ) {
71
if ( isset( $ordered_menu_item_object->ID ) ) {
72
if ( isset( $ordered_menu_item_object->menu_order ) ) {
73
$dbids_to_orders[$ordered_menu_item_object->ID] = $ordered_menu_item_object->menu_order;
74
$orders_to_dbids[$ordered_menu_item_object->menu_order] = $ordered_menu_item_object->ID;
81
isset( $orders_to_dbids[$dbids_to_orders[$menu_item_id] + 1] )
83
$next_item_id = $orders_to_dbids[$dbids_to_orders[$menu_item_id] + 1];
84
$next_item_data = (array) wp_setup_nav_menu_item( get_post( $next_item_id ) );
86
// If not siblings of same parent, bubble menu item up but keep order.
88
! empty( $menu_item_data['menu_item_parent'] ) &&
90
empty( $next_item_data['menu_item_parent'] ) ||
91
$next_item_data['menu_item_parent'] != $menu_item_data['menu_item_parent']
95
$parent_db_id = in_array( $menu_item_data['menu_item_parent'], $orders_to_dbids ) ? (int) $menu_item_data['menu_item_parent'] : 0;
97
$parent_object = wp_setup_nav_menu_item( get_post( $parent_db_id ) );
99
if ( ! is_wp_error( $parent_object ) ) {
100
$parent_data = (array) $parent_object;
101
$menu_item_data['menu_item_parent'] = $parent_data['menu_item_parent'];
102
update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
106
// Make menu item a child of its next sibling.
108
$next_item_data['menu_order'] = $next_item_data['menu_order'] - 1;
109
$menu_item_data['menu_order'] = $menu_item_data['menu_order'] + 1;
111
$menu_item_data['menu_item_parent'] = $next_item_data['ID'];
112
update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
114
wp_update_post($menu_item_data);
115
wp_update_post($next_item_data);
118
// The item is last but still has a parent, so bubble up.
120
! empty( $menu_item_data['menu_item_parent'] ) &&
121
in_array( $menu_item_data['menu_item_parent'], $orders_to_dbids )
123
$menu_item_data['menu_item_parent'] = (int) get_post_meta( $menu_item_data['menu_item_parent'], '_menu_item_menu_item_parent', true);
124
update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
130
case 'move-up-menu-item' :
131
check_admin_referer( 'move-menu_item' );
132
$menu_item_id = isset( $_REQUEST['menu-item'] ) ? (int) $_REQUEST['menu-item'] : 0;
133
if ( is_nav_menu_item( $menu_item_id ) ) {
134
$menus = isset( $_REQUEST['menu'] ) ? array( (int) $_REQUEST['menu'] ) : wp_get_object_terms( $menu_item_id, 'nav_menu', array( 'fields' => 'ids' ) );
135
if ( ! is_wp_error( $menus ) && ! empty( $menus[0] ) ) {
136
$menu_id = (int) $menus[0];
137
$ordered_menu_items = wp_get_nav_menu_items( $menu_id );
138
$menu_item_data = (array) wp_setup_nav_menu_item( get_post( $menu_item_id ) );
140
// Set up the data we need in one pass through the array of menu items.
141
$dbids_to_orders = array();
142
$orders_to_dbids = array();
143
foreach( (array) $ordered_menu_items as $ordered_menu_item_object ) {
144
if ( isset( $ordered_menu_item_object->ID ) ) {
145
if ( isset( $ordered_menu_item_object->menu_order ) ) {
146
$dbids_to_orders[$ordered_menu_item_object->ID] = $ordered_menu_item_object->menu_order;
147
$orders_to_dbids[$ordered_menu_item_object->menu_order] = $ordered_menu_item_object->ID;
152
// If this menu item is not first.
153
if ( ! empty( $dbids_to_orders[$menu_item_id] ) && ! empty( $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] ) ) {
155
// If this menu item is a child of the previous.
157
! empty( $menu_item_data['menu_item_parent'] ) &&
158
in_array( $menu_item_data['menu_item_parent'], array_keys( $dbids_to_orders ) ) &&
159
isset( $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] ) &&
160
( $menu_item_data['menu_item_parent'] == $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] )
162
$parent_db_id = in_array( $menu_item_data['menu_item_parent'], $orders_to_dbids ) ? (int) $menu_item_data['menu_item_parent'] : 0;
163
$parent_object = wp_setup_nav_menu_item( get_post( $parent_db_id ) );
165
if ( ! is_wp_error( $parent_object ) ) {
166
$parent_data = (array) $parent_object;
169
* If there is something before the parent and parent a child of it,
170
* make menu item a child also of it.
173
! empty( $dbids_to_orders[$parent_db_id] ) &&
174
! empty( $orders_to_dbids[$dbids_to_orders[$parent_db_id] - 1] ) &&
175
! empty( $parent_data['menu_item_parent'] )
177
$menu_item_data['menu_item_parent'] = $parent_data['menu_item_parent'];
180
* Else if there is something before parent and parent not a child of it,
181
* make menu item a child of that something's parent
184
! empty( $dbids_to_orders[$parent_db_id] ) &&
185
! empty( $orders_to_dbids[$dbids_to_orders[$parent_db_id] - 1] )
187
$_possible_parent_id = (int) get_post_meta( $orders_to_dbids[$dbids_to_orders[$parent_db_id] - 1], '_menu_item_menu_item_parent', true);
188
if ( in_array( $_possible_parent_id, array_keys( $dbids_to_orders ) ) )
189
$menu_item_data['menu_item_parent'] = $_possible_parent_id;
191
$menu_item_data['menu_item_parent'] = 0;
193
// Else there isn't something before the parent.
195
$menu_item_data['menu_item_parent'] = 0;
198
// Set former parent's [menu_order] to that of menu-item's.
199
$parent_data['menu_order'] = $parent_data['menu_order'] + 1;
201
// Set menu-item's [menu_order] to that of former parent.
202
$menu_item_data['menu_order'] = $menu_item_data['menu_order'] - 1;
205
update_post_meta( $menu_item_data['ID'], '_menu_item_menu_item_parent', (int) $menu_item_data['menu_item_parent'] );
206
wp_update_post($menu_item_data);
207
wp_update_post($parent_data);
210
// Else this menu item is not a child of the previous.
212
empty( $menu_item_data['menu_order'] ) ||
213
empty( $menu_item_data['menu_item_parent'] ) ||
214
! in_array( $menu_item_data['menu_item_parent'], array_keys( $dbids_to_orders ) ) ||
215
empty( $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] ) ||
216
$orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1] != $menu_item_data['menu_item_parent']
218
// Just make it a child of the previous; keep the order.
219
$menu_item_data['menu_item_parent'] = (int) $orders_to_dbids[$dbids_to_orders[$menu_item_id] - 1];
220
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);
228
case 'delete-menu-item':
229
$menu_item_id = (int) $_REQUEST['menu-item'];
231
check_admin_referer( 'delete-menu_item_' . $menu_item_id );
233
if ( is_nav_menu_item( $menu_item_id ) && wp_delete_post( $menu_item_id, true ) )
234
$messages[] = '<div id="message" class="updated"><p>' . __('The menu item has been successfully deleted.') . '</p></div>';
238
check_admin_referer( 'delete-nav_menu-' . $nav_menu_selected_id );
239
if ( is_nav_menu( $nav_menu_selected_id ) ) {
240
$deletion = wp_delete_nav_menu( $nav_menu_selected_id );
242
// Reset the selected menu.
243
$nav_menu_selected_id = 0;
244
unset( $_REQUEST['menu'] );
247
if ( ! isset( $deletion ) )
250
if ( is_wp_error( $deletion ) )
251
$messages[] = '<div id="message" class="error"><p>' . $deletion->get_error_message() . '</p></div>';
253
$messages[] = '<div id="message" class="updated"><p>' . __( 'The menu has been successfully deleted.' ) . '</p></div>';
257
check_admin_referer( 'nav_menus_bulk_actions' );
258
foreach ( $_REQUEST['delete_menus'] as $menu_id_to_delete ) {
259
if ( ! is_nav_menu( $menu_id_to_delete ) )
262
$deletion = wp_delete_nav_menu( $menu_id_to_delete );
263
if ( is_wp_error( $deletion ) ) {
264
$messages[] = '<div id="message" class="error"><p>' . $deletion->get_error_message() . '</p></div>';
265
$deletion_error = true;
269
if ( empty( $deletion_error ) )
270
$messages[] = '<div id="message" class="updated"><p>' . __( 'Selected menus have been successfully deleted.' ) . '</p></div>';
274
check_admin_referer( 'update-nav_menu', 'update-nav-menu-nonce' );
276
// Remove menu locations that have been unchecked.
277
foreach ( $locations as $location => $description ) {
278
if ( ( empty( $_POST['menu-locations'] ) || empty( $_POST['menu-locations'][ $location ] ) ) && isset( $menu_locations[ $location ] ) && $menu_locations[ $location ] == $nav_menu_selected_id )
279
unset( $menu_locations[ $location ] );
282
// Merge new and existing menu locations if any new ones are set.
283
if ( isset( $_POST['menu-locations'] ) ) {
284
$new_menu_locations = array_map( 'absint', $_POST['menu-locations'] );
285
$menu_locations = array_merge( $menu_locations, $new_menu_locations );
288
// Set menu locations.
289
set_theme_mod( 'nav_menu_locations', $menu_locations );
292
if ( 0 == $nav_menu_selected_id ) {
293
$new_menu_title = trim( esc_html( $_POST['menu-name'] ) );
295
if ( $new_menu_title ) {
296
$_nav_menu_selected_id = wp_update_nav_menu_object( 0, array('menu-name' => $new_menu_title) );
298
if ( is_wp_error( $_nav_menu_selected_id ) ) {
299
$messages[] = '<div id="message" class="error"><p>' . $_nav_menu_selected_id->get_error_message() . '</p></div>';
301
$_menu_object = wp_get_nav_menu_object( $_nav_menu_selected_id );
302
$nav_menu_selected_id = $_nav_menu_selected_id;
303
$nav_menu_selected_title = $_menu_object->name;
304
if ( isset( $_REQUEST['menu-item'] ) )
305
wp_save_nav_menu_items( $nav_menu_selected_id, absint( $_REQUEST['menu-item'] ) );
306
if ( isset( $_REQUEST['zero-menu-state'] ) ) {
307
// If there are menu items, add them
308
wp_nav_menu_update_menu_items( $nav_menu_selected_id, $nav_menu_selected_title );
309
// Auto-save nav_menu_locations
310
$locations = get_nav_menu_locations();
311
foreach ( $locations as $location => $menu_id ) {
312
$locations[ $location ] = $nav_menu_selected_id;
313
break; // There should only be 1
315
set_theme_mod( 'nav_menu_locations', $locations );
317
if ( isset( $_REQUEST['use-location'] ) ) {
318
$locations = get_registered_nav_menus();
319
$menu_locations = get_nav_menu_locations();
320
if ( isset( $locations[ $_REQUEST['use-location'] ] ) )
321
$menu_locations[ $_REQUEST['use-location'] ] = $nav_menu_selected_id;
322
set_theme_mod( 'nav_menu_locations', $menu_locations );
325
// $messages[] = '<div id="message" class="updated"><p>' . sprintf( __( '<strong>%s</strong> has been created.' ), $nav_menu_selected_title ) . '</p></div>';
326
wp_redirect( admin_url( 'nav-menus.php?menu=' . $_nav_menu_selected_id ) );
330
$messages[] = '<div id="message" class="error"><p>' . __( 'Please enter a valid menu name.' ) . '</p></div>';
333
// Update existing menu.
336
$_menu_object = wp_get_nav_menu_object( $nav_menu_selected_id );
338
$menu_title = trim( esc_html( $_POST['menu-name'] ) );
339
if ( ! $menu_title ) {
340
$messages[] = '<div id="message" class="error"><p>' . __( 'Please enter a valid menu name.' ) . '</p></div>';
341
$menu_title = $_menu_object->name;
344
if ( ! is_wp_error( $_menu_object ) ) {
345
$_nav_menu_selected_id = wp_update_nav_menu_object( $nav_menu_selected_id, array( 'menu-name' => $menu_title ) );
346
if ( is_wp_error( $_nav_menu_selected_id ) ) {
347
$_menu_object = $_nav_menu_selected_id;
348
$messages[] = '<div id="message" class="error"><p>' . $_nav_menu_selected_id->get_error_message() . '</p></div>';
350
$_menu_object = wp_get_nav_menu_object( $_nav_menu_selected_id );
351
$nav_menu_selected_title = $_menu_object->name;
355
// Update menu items.
356
if ( ! is_wp_error( $_menu_object ) ) {
357
$messages = array_merge( $messages, wp_nav_menu_update_menu_items( $nav_menu_selected_id, $nav_menu_selected_title ) );
362
if ( ! $num_locations ) {
363
wp_redirect( admin_url( 'nav-menus.php' ) );
367
add_filter( 'screen_options_show_screen', '__return_false' );
369
if ( isset( $_POST['menu-locations'] ) ) {
370
check_admin_referer( 'save-menu-locations' );
372
$new_menu_locations = array_map( 'absint', $_POST['menu-locations'] );
373
$menu_locations = array_merge( $menu_locations, $new_menu_locations );
374
// Set menu locations
375
set_theme_mod( 'nav_menu_locations', $menu_locations );
377
$messages[] = '<div id="message" class="updated"><p>' . __( 'Menu locations updated.' ) . '</p></div>';
382
// Get all nav menus.
383
$nav_menus = wp_get_nav_menus( array('orderby' => 'name') );
384
$menu_count = count( $nav_menus );
386
// Are we on the add new screen?
387
$add_new_screen = ( isset( $_GET['menu'] ) && 0 == $_GET['menu'] ) ? true : false;
389
$locations_screen = ( isset( $_GET['action'] ) && 'locations' == $_GET['action'] ) ? true : false;
392
* If we have one theme location, and zero menus, we take them right
393
* into editing their first menu.
395
$page_count = wp_count_posts( 'page' );
396
$one_theme_location_no_menus = ( 1 == count( get_registered_nav_menus() ) && ! $add_new_screen && empty( $nav_menus ) && ! empty( $page_count->publish ) ) ? true : false;
398
$nav_menus_l10n = array(
399
'oneThemeLocationNoMenus' => $one_theme_location_no_menus,
400
'moveUp' => __( 'Move up one' ),
401
'moveDown' => __( 'Move down one' ),
402
'moveToTop' => __( 'Move to the top' ),
403
/* translators: %s: previous item name */
404
'moveUnder' => __( 'Move under %s' ),
405
/* translators: %s: previous item name */
406
'moveOutFrom' => __( 'Move out from under %s' ),
407
/* translators: %s: previous item name */
408
'under' => __( 'Under %s' ),
409
/* translators: %s: previous item name */
410
'outFrom' => __( 'Out from under %s' ),
411
/* translators: 1: item name, 2: item position, 3: total number of items */
412
'menuFocus' => __( '%1$s. Menu item %2$d of %3$d.' ),
413
/* translators: 1: item name, 2: item position, 3: parent item name */
414
'subMenuFocus' => __( '%1$s. Sub item number %2$d under %3$s.' ),
416
wp_localize_script( 'nav-menu', 'menus', $nav_menus_l10n );
419
* Redirect to add screen if there are no menus and this users has either zero,
420
* or more than 1 theme locations.
422
if ( 0 == $menu_count && ! $add_new_screen && ! $one_theme_location_no_menus )
423
wp_redirect( admin_url( 'nav-menus.php?action=edit&menu=0' ) );
425
// Get recently edited nav menu.
426
$recently_edited = absint( get_user_option( 'nav_menu_recently_edited' ) );
427
if ( empty( $recently_edited ) && is_nav_menu( $nav_menu_selected_id ) )
428
$recently_edited = $nav_menu_selected_id;
430
// Use $recently_edited if none are selected.
431
if ( empty( $nav_menu_selected_id ) && ! isset( $_GET['menu'] ) && is_nav_menu( $recently_edited ) )
432
$nav_menu_selected_id = $recently_edited;
434
// On deletion of menu, if another menu exists, show it.
435
if ( ! $add_new_screen && 0 < $menu_count && isset( $_GET['action'] ) && 'delete' == $_GET['action'] )
436
$nav_menu_selected_id = $nav_menus[0]->term_id;
438
// Set $nav_menu_selected_id to 0 if no menus.
439
if ( $one_theme_location_no_menus ) {
440
$nav_menu_selected_id = 0;
441
} elseif ( empty( $nav_menu_selected_id ) && ! empty( $nav_menus ) && ! $add_new_screen ) {
442
// if we have no selection yet, and we have menus, set to the first one in the list.
443
$nav_menu_selected_id = $nav_menus[0]->term_id;
446
// Update the user's setting.
447
if ( $nav_menu_selected_id != $recently_edited && is_nav_menu( $nav_menu_selected_id ) )
448
update_user_meta( $current_user->ID, 'nav_menu_recently_edited', $nav_menu_selected_id );
450
// If there's a menu, get its name.
451
if ( ! $nav_menu_selected_title && is_nav_menu( $nav_menu_selected_id ) ) {
452
$_menu_object = wp_get_nav_menu_object( $nav_menu_selected_id );
453
$nav_menu_selected_title = ! is_wp_error( $_menu_object ) ? $_menu_object->name : '';
456
// Generate truncated menu names.
457
foreach( (array) $nav_menus as $key => $_nav_menu ) {
458
$nav_menus[$key]->truncated_name = wp_html_excerpt( $_nav_menu->name, 40, '…' );
461
// Retrieve menu locations.
462
if ( current_theme_supports( 'menus' ) ) {
463
$locations = get_registered_nav_menus();
464
$menu_locations = get_nav_menu_locations();
468
* Ensure the user will be able to scroll horizontally
469
* by adding a class for the max menu depth.
471
global $_wp_nav_menu_max_depth;
472
$_wp_nav_menu_max_depth = 0;
474
// Calling wp_get_nav_menu_to_edit generates $_wp_nav_menu_max_depth.
475
if ( is_nav_menu( $nav_menu_selected_id ) ) {
476
$menu_items = wp_get_nav_menu_items( $nav_menu_selected_id, array( 'post_status' => 'any' ) );
477
$edit_markup = wp_get_nav_menu_to_edit( $nav_menu_selected_id );
480
function wp_nav_menu_max_depth($classes) {
481
global $_wp_nav_menu_max_depth;
482
return "$classes menu-max-depth-$_wp_nav_menu_max_depth";
485
add_filter('admin_body_class', 'wp_nav_menu_max_depth');
488
wp_initial_nav_menu_meta_boxes();
490
if ( ! current_theme_supports( 'menus' ) && ! $num_locations )
491
$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>';
493
if ( ! $locations_screen ) : // Main tab
494
$overview = '<p>' . __( 'This screen is used for managing your custom navigation menus.' ) . '</p>';
495
$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 Fourteen', 'Twenty Thirteen' ) . '</p>';
496
$overview .= '<p>' . __( 'From this screen you can:' ) . '</p>';
497
$overview .= '<ul><li>' . __( 'Create, edit, and delete menus' ) . '</li>';
498
$overview .= '<li>' . __( 'Add, organize, and modify individual menu items' ) . '</li></ul>';
500
get_current_screen()->add_help_tab( array(
502
'title' => __( 'Overview' ),
503
'content' => $overview
506
$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>';
507
$menu_management .= '<ul><li>' . __( 'To edit an existing menu, <strong>choose a menu from the drop down and click Select</strong>' ) . '</li>';
508
$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>';
509
$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>';
511
get_current_screen()->add_help_tab( array(
512
'id' => 'menu-management',
513
'title' => __( 'Menu Management' ),
514
'content' => $menu_management
517
$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>';
518
$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>';
519
$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>';
520
$editing_menus .= '<li>' . __( 'To add a custom link, <strong>expand the Links section, enter a URL and link text, and click Add to Menu</strong>' ) .'</li>';
521
$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>';
522
$editing_menus .= '<li>' . __( 'Delete a menu item by <strong>expanding it and clicking the Remove link</strong>' ) . '</li></ul>';
524
get_current_screen()->add_help_tab( array(
525
'id' => 'editing-menus',
526
'title' => __( 'Editing Menus' ),
527
'content' => $editing_menus
529
else : // Locations Tab.
530
$locations_overview = '<p>' . __( 'This screen is used for globally assigning menus to locations defined by your theme.' ) . '</p>';
531
$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>';
532
$locations_overview .= '<li>' . __( 'To edit a menu currently assigned to a theme location, <strong>click the adjacent ’Edit’ link</strong>' ) . '</li>';
533
$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>';
535
get_current_screen()->add_help_tab( array(
536
'id' => 'locations-overview',
537
'title' => __( 'Overview' ),
538
'content' => $locations_overview
542
get_current_screen()->set_help_sidebar(
543
'<p><strong>' . __('For more information:') . '</strong></p>' .
544
'<p>' . __('<a href="http://codex.wordpress.org/Appearance_Menus_Screen" target="_blank">Documentation on Menus</a>') . '</p>' .
545
'<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
548
// Get the admin header.
549
require_once( ABSPATH . 'wp-admin/admin-header.php' );
552
<h2 class="nav-tab-wrapper">
553
<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>
554
<?php if ( $num_locations && $menu_count ) : ?>
555
<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>
559
foreach( $messages as $message ) :
560
echo $message . "\n";
564
if ( $locations_screen ) :
565
echo '<p>' . sprintf( _n( 'Your theme supports %s menu. Select which menu you would like to use.', 'Your theme supports %s menus. Select which menu appears in each location.', $num_locations ), number_format_i18n( $num_locations ) ) . '</p>';
567
<div id="menu-locations-wrap">
568
<form method="post" action="<?php echo esc_url( add_query_arg( array( 'action' => 'locations' ), admin_url( 'nav-menus.php' ) ) ); ?>">
569
<table class="widefat fixed" id="menu-locations-table">
572
<th scope="col" class="manage-column column-locations"><?php _e( 'Theme Location' ); ?></th>
573
<th scope="col" class="manage-column column-menus"><?php _e( 'Assigned Menu' ); ?></th>
578
<th scope="col" class="manage-column column-locations"><?php _e( 'Theme Location' ); ?></th>
579
<th scope="col" class="manage-column column-menus"><?php _e( 'Assigned Menu' ); ?></th>
582
<tbody class="menu-locations">
583
<?php foreach ( $locations as $_location => $_name ) { ?>
584
<tr id="menu-locations-row">
585
<td class="menu-location-title"><strong><?php echo $_name; ?></strong></td>
586
<td class="menu-location-menus">
587
<select name="menu-locations[<?php echo $_location; ?>]" id="locations-<?php echo $_location; ?>">
588
<option value="0"><?php printf( '— %s —', esc_html__( 'Select a Menu' ) ); ?></option>
589
<?php foreach ( $nav_menus as $menu ) : ?>
590
<?php $selected = isset( $menu_locations[$_location] ) && $menu_locations[$_location] == $menu->term_id; ?>
591
<option <?php if ( $selected ) echo 'data-orig="true"'; ?> <?php selected( $selected ); ?> value="<?php echo $menu->term_id; ?>">
592
<?php echo wp_html_excerpt( $menu->name, 40, '…' ); ?>
596
<div class="locations-row-links">
597
<?php if ( isset( $menu_locations[ $_location ] ) && 0 != $menu_locations[ $_location ] ) : ?>
598
<span class="locations-edit-menu-link">
599
<a href="<?php echo esc_url( add_query_arg( array( 'action' => 'edit', 'menu' => $menu_locations[$_location] ), admin_url( 'nav-menus.php' ) ) ); ?>">
600
<?php _ex( 'Edit', 'menu' ); ?>
604
<span class="locations-add-menu-link">
605
<a href="<?php echo esc_url( add_query_arg( array( 'action' => 'edit', 'menu' => 0, 'use-location' => $_location ), admin_url( 'nav-menus.php' ) ) ); ?>">
606
<?php _ex( 'Use new menu', 'menu' ); ?>
609
</div><!-- #locations-row-links -->
610
</td><!-- .menu-location-menus -->
611
</tr><!-- #menu-locations-row -->
612
<?php } // foreach ?>
615
<p class="button-controls"><?php submit_button( __( 'Save Changes' ), 'primary left', 'nav-menu-locations', false ); ?></p>
616
<?php wp_nonce_field( 'save-menu-locations' ); ?>
617
<input type="hidden" name="menu" id="nav-menu-meta-object-id" value="<?php echo esc_attr( $nav_menu_selected_id ); ?>" />
619
</div><!-- #menu-locations-wrap -->
622
* Fires after the menu locations table is displayed.
626
do_action( 'after_menu_locations_table' ); ?>
628
<div class="manage-menus">
629
<?php if ( $menu_count < 2 ) : ?>
630
<span class="add-edit-menu-action">
631
<?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' ) ) ) ); ?>
632
</span><!-- /add-edit-menu-action -->
634
<form method="get" action="<?php echo admin_url( 'nav-menus.php' ); ?>">
635
<input type="hidden" name="action" value="edit" />
636
<label for="menu" class="selected-menu"><?php _e( 'Select a menu to edit:' ); ?></label>
637
<select name="menu" id="menu">
638
<?php if ( $add_new_screen ) : ?>
639
<option value="0" selected="selected"><?php _e( '— Select —' ); ?></option>
641
<?php foreach( (array) $nav_menus as $_nav_menu ) : ?>
642
<option value="<?php echo esc_attr( $_nav_menu->term_id ); ?>" <?php selected( $_nav_menu->term_id, $nav_menu_selected_id ); ?>>
644
echo esc_html( $_nav_menu->truncated_name ) ;
646
if ( ! empty( $menu_locations ) && in_array( $_nav_menu->term_id, $menu_locations ) ) {
647
$locations_assigned_to_this_menu = array();
648
foreach ( array_keys( $menu_locations, $_nav_menu->term_id ) as $menu_location_key ) {
649
if ( isset( $locations[ $menu_location_key ] ) ) {
650
$locations_assigned_to_this_menu[] = $locations[ $menu_location_key ];
655
* Filter the number of locations listed per menu in the drop-down select.
659
* @param int $locations Number of menu locations to list. Default 3.
661
$assigned_locations = array_slice( $locations_assigned_to_this_menu, 0, absint( apply_filters( 'wp_nav_locations_listed_per_menu', 3 ) ) );
663
// Adds ellipses following the number of locations defined in $assigned_locations.
664
if ( ! empty( $assigned_locations ) ) {
665
printf( ' (%1$s%2$s)',
666
implode( ', ', $assigned_locations ),
667
count( $locations_assigned_to_this_menu ) > count( $assigned_locations ) ? ' …' : ''
675
<span class="submit-btn"><input type="submit" class="button-secondary" value="<?php esc_attr_e( 'Select' ); ?>"></span>
676
<span class="add-new-menu-action">
677
<?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' ) ) ) ); ?>
678
</span><!-- /add-new-menu-action -->
681
</div><!-- /manage-menus -->
682
<div id="nav-menus-frame">
683
<div id="menu-settings-column" class="metabox-holder<?php if ( isset( $_GET['menu'] ) && '0' == $_GET['menu'] ) { echo ' metabox-holder-disabled'; } ?>">
685
<div class="clear"></div>
687
<form id="nav-menu-meta" action="" class="nav-menu-meta" method="post" enctype="multipart/form-data">
688
<input type="hidden" name="menu" id="nav-menu-meta-object-id" value="<?php echo esc_attr( $nav_menu_selected_id ); ?>" />
689
<input type="hidden" name="action" value="add-menu-item" />
690
<?php wp_nonce_field( 'add-menu_item', 'menu-settings-column-nonce' ); ?>
691
<?php do_accordion_sections( 'nav-menus', 'side', null ); ?>
694
</div><!-- /#menu-settings-column -->
695
<div id="menu-management-liquid">
696
<div id="menu-management">
697
<form id="update-nav-menu" action="" method="post" enctype="multipart/form-data">
698
<div class="menu-edit <?php if ( $add_new_screen ) echo 'blank-slate'; ?>">
700
wp_nonce_field( 'closedpostboxes', 'closedpostboxesnonce', false );
701
wp_nonce_field( 'meta-box-order', 'meta-box-order-nonce', false );
702
wp_nonce_field( 'update-nav_menu', 'update-nav-menu-nonce' );
704
if ( $one_theme_location_no_menus ) { ?>
705
<input type="hidden" name="zero-menu-state" value="true" />
707
<input type="hidden" name="action" value="update" />
708
<input type="hidden" name="menu" id="menu" value="<?php echo esc_attr( $nav_menu_selected_id ); ?>" />
709
<div id="nav-menu-header">
710
<div class="major-publishing-actions">
711
<label class="menu-name-label howto open-label" for="menu-name">
712
<span><?php _e( 'Menu Name' ); ?></span>
713
<input name="menu-name" id="menu-name" type="text" class="menu-name regular-text menu-item-textbox input-with-default-title" title="<?php esc_attr_e( 'Enter menu name here' ); ?>" value="<?php if ( $one_theme_location_no_menus ) _e( 'Menu 1' ); else echo esc_attr( $nav_menu_selected_title ); ?>" />
715
<div class="publishing-action">
716
<?php submit_button( empty( $nav_menu_selected_id ) ? __( 'Create Menu' ) : __( 'Save Menu' ), 'button-primary menu-save', 'save_menu', false, array( 'id' => 'save_menu_header' ) ); ?>
717
</div><!-- END .publishing-action -->
718
</div><!-- END .major-publishing-actions -->
719
</div><!-- END .nav-menu-header -->
721
<div id="post-body-content">
722
<?php if ( ! $add_new_screen ) : ?>
723
<h3><?php _e( 'Menu Structure' ); ?></h3>
724
<?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.' ); ?>
725
<div class="drag-instructions post-body-plain" <?php if ( isset( $menu_items ) && 0 == count( $menu_items ) ) { ?>style="display: none;"<?php } ?>>
726
<p><?php echo $starter_copy; ?></p>
729
if ( isset( $edit_markup ) && ! is_wp_error( $edit_markup ) ) {
733
<ul class="menu" id="menu-to-edit"></ul>
736
<?php if ( $add_new_screen ) : ?>
737
<p class="post-body-plain"><?php _e( 'Give your menu a name above, then click Create Menu.' ); ?></p>
738
<?php if ( isset( $_GET['use-location'] ) ) : ?>
739
<input type="hidden" name="use-location" value="<?php echo esc_attr( $_GET['use-location'] ); ?>" />
742
<div class="menu-settings" <?php if ( $one_theme_location_no_menus ) { ?>style="display: none;"<?php } ?>>
743
<h3><?php _e( 'Menu Settings' ); ?></h3>
745
if ( ! isset( $auto_add ) ) {
746
$auto_add = get_option( 'nav_menu_options' );
747
if ( ! isset( $auto_add['auto_add'] ) )
749
elseif ( false !== array_search( $nav_menu_selected_id, $auto_add['auto_add'] ) )
755
<dl class="auto-add-pages">
756
<dt class="howto"><?php _e( 'Auto add pages' ); ?></dt>
757
<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>
760
<?php if ( current_theme_supports( 'menus' ) ) : ?>
762
<dl class="menu-theme-locations">
763
<dt class="howto"><?php _e( 'Theme locations' ); ?></dt>
764
<?php foreach ( $locations as $location => $description ) : ?>
765
<dd class="checkbox-input">
766
<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 ); ?>" /> <label for="locations-<?php echo esc_attr( $location ); ?>"><?php echo $description; ?></label>
767
<?php if ( ! empty( $menu_locations[ $location ] ) && $menu_locations[ $location ] != $nav_menu_selected_id ) : ?>
768
<span class="theme-location-set"> <?php printf( __( "(Currently set to: %s)" ), wp_get_nav_menu_object( $menu_locations[ $location ] )->name ); ?> </span>
777
</div><!-- /#post-body-content -->
778
</div><!-- /#post-body -->
779
<div id="nav-menu-footer">
780
<div class="major-publishing-actions">
781
<?php if ( 0 != $menu_count && ! $add_new_screen ) : ?>
782
<span class="delete-action">
783
<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() ) ), 'delete-nav_menu-' . $nav_menu_selected_id) ); ?>"><?php _e('Delete Menu'); ?></a>
784
</span><!-- END .delete-action -->
786
<div class="publishing-action">
787
<?php submit_button( empty( $nav_menu_selected_id ) ? __( 'Create Menu' ) : __( 'Save Menu' ), 'button-primary menu-save', 'save_menu', false, array( 'id' => 'save_menu_header' ) ); ?>
788
</div><!-- END .publishing-action -->
789
</div><!-- END .major-publishing-actions -->
790
</div><!-- /#nav-menu-footer -->
791
</div><!-- /.menu-edit -->
792
</form><!-- /#update-nav-menu -->
793
</div><!-- /#menu-management -->
794
</div><!-- /#menu-management-liquid -->
795
</div><!-- /#nav-menus-frame -->
798
<?php include( ABSPATH . 'wp-admin/admin-footer.php' ); ?>
added
removed
wp-admin/nav-menus.php
