3 * Core Navigation Menu API
6 * @subpackage Nav_Menus
10 /** Walker_Nav_Menu_Edit class */
11 require_once( ABSPATH . 'wp-admin/includes/class-walker-nav-menu-edit.php' );
13 /** Walker_Nav_Menu_Checklist class */
14 require_once( ABSPATH . 'wp-admin/includes/class-walker-nav-menu-checklist.php' );
17 * Prints the appropriate response to a menu quick search.
21 * @param array $request The unsanitized request values.
23 function _wp_ajax_menu_quick_search( $request = array() ) {
25 $type = isset( $request['type'] ) ? $request['type'] : '';
26 $object_type = isset( $request['object_type'] ) ? $request['object_type'] : '';
27 $query = isset( $request['q'] ) ? $request['q'] : '';
28 $response_format = isset( $request['response-format'] ) && in_array( $request['response-format'], array( 'json', 'markup' ) ) ? $request['response-format'] : 'json';
30 if ( 'markup' == $response_format ) {
31 $args['walker'] = new Walker_Nav_Menu_Checklist;
34 if ( 'get-post-item' == $type ) {
35 if ( post_type_exists( $object_type ) ) {
36 if ( isset( $request['ID'] ) ) {
37 $object_id = (int) $request['ID'];
38 if ( 'markup' == $response_format ) {
39 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', array( get_post( $object_id ) ) ), 0, (object) $args );
40 } elseif ( 'json' == $response_format ) {
44 'post_title' => get_the_title( $object_id ),
45 'post_type' => get_post_type( $object_id ),
51 } elseif ( taxonomy_exists( $object_type ) ) {
52 if ( isset( $request['ID'] ) ) {
53 $object_id = (int) $request['ID'];
54 if ( 'markup' == $response_format ) {
55 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', array( get_term( $object_id, $object_type ) ) ), 0, (object) $args );
56 } elseif ( 'json' == $response_format ) {
57 $post_obj = get_term( $object_id, $object_type );
61 'post_title' => $post_obj->name,
62 'post_type' => $object_type,
71 } elseif ( preg_match('/quick-search-(posttype|taxonomy)-([a-zA-Z_-]*\b)/', $type, $matches) ) {
72 if ( 'posttype' == $matches[1] && get_post_type_object( $matches[2] ) ) {
73 $search_results_query = new WP_Query( array(
74 'no_found_rows' => true,
75 'update_post_meta_cache' => false,
76 'update_post_term_cache' => false,
77 'posts_per_page' => 10,
78 'post_type' => $matches[2],
81 if ( ! $search_results_query->have_posts() ) {
84 while ( $search_results_query->have_posts() ) {
85 $post = $search_results_query->next_post();
86 if ( 'markup' == $response_format ) {
87 $var_by_ref = $post->ID;
88 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', array( get_post( $var_by_ref ) ) ), 0, (object) $args );
89 } elseif ( 'json' == $response_format ) {
93 'post_title' => get_the_title( $post->ID ),
94 'post_type' => $matches[2],
100 } elseif ( 'taxonomy' == $matches[1] ) {
101 $terms = get_terms( $matches[2], array(
102 'name__like' => $query,
105 if ( empty( $terms ) || is_wp_error( $terms ) )
107 foreach ( (array) $terms as $term ) {
108 if ( 'markup' == $response_format ) {
109 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', array( $term ) ), 0, (object) $args );
110 } elseif ( 'json' == $response_format ) {
113 'ID' => $term->term_id,
114 'post_title' => $term->name,
115 'post_type' => $matches[2],
126 * Register nav menu meta boxes and advanced menu items.
130 function wp_nav_menu_setup() {
131 // Register meta boxes
132 wp_nav_menu_post_type_meta_boxes();
133 add_meta_box( 'add-custom-links', __( 'Custom Links' ), 'wp_nav_menu_item_link_meta_box', 'nav-menus', 'side', 'default' );
134 wp_nav_menu_taxonomy_meta_boxes();
136 // Register advanced menu items (columns)
137 add_filter( 'manage_nav-menus_columns', 'wp_nav_menu_manage_columns' );
139 // If first time editing, disable advanced items by default.
140 if ( false === get_user_option( 'managenav-menuscolumnshidden' ) ) {
141 $user = wp_get_current_user();
142 update_user_option($user->ID, 'managenav-menuscolumnshidden',
143 array( 0 => 'link-target', 1 => 'css-classes', 2 => 'xfn', 3 => 'description', 4 => 'title-attribute', ),
149 * Limit the amount of meta boxes to pages, posts, links, and categories for first time users.
153 * @global array $wp_meta_boxes
155 function wp_initial_nav_menu_meta_boxes() {
156 global $wp_meta_boxes;
158 if ( get_user_option( 'metaboxhidden_nav-menus' ) !== false || ! is_array($wp_meta_boxes) )
161 $initial_meta_boxes = array( 'add-post-type-page', 'add-post-type-post', 'add-custom-links', 'add-category' );
162 $hidden_meta_boxes = array();
164 foreach ( array_keys($wp_meta_boxes['nav-menus']) as $context ) {
165 foreach ( array_keys($wp_meta_boxes['nav-menus'][$context]) as $priority ) {
166 foreach ( $wp_meta_boxes['nav-menus'][$context][$priority] as $box ) {
167 if ( in_array( $box['id'], $initial_meta_boxes ) ) {
170 $hidden_meta_boxes[] = $box['id'];
176 $user = wp_get_current_user();
177 update_user_option( $user->ID, 'metaboxhidden_nav-menus', $hidden_meta_boxes, true );
181 * Creates meta boxes for any post type menu item..
185 function wp_nav_menu_post_type_meta_boxes() {
186 $post_types = get_post_types( array( 'show_in_nav_menus' => true ), 'object' );
191 foreach ( $post_types as $post_type ) {
193 * Filters whether a menu items meta box will be added for the current
196 * If a falsey value is returned instead of an object, the menu items
197 * meta box for the current meta box object will not be added.
201 * @param object $meta_box_object The current object to add a menu items
204 $post_type = apply_filters( 'nav_menu_meta_box_object', $post_type );
206 $id = $post_type->name;
207 // Give pages a higher priority.
208 $priority = ( 'page' == $post_type->name ? 'core' : 'default' );
209 add_meta_box( "add-post-type-{$id}", $post_type->labels->name, 'wp_nav_menu_item_post_type_meta_box', 'nav-menus', 'side', $priority, $post_type );
215 * Creates meta boxes for any taxonomy menu item.
219 function wp_nav_menu_taxonomy_meta_boxes() {
220 $taxonomies = get_taxonomies( array( 'show_in_nav_menus' => true ), 'object' );
225 foreach ( $taxonomies as $tax ) {
226 /** This filter is documented in wp-admin/includes/nav-menu.php */
227 $tax = apply_filters( 'nav_menu_meta_box_object', $tax );
230 add_meta_box( "add-{$id}", $tax->labels->name, 'wp_nav_menu_item_taxonomy_meta_box', 'nav-menus', 'side', 'default', $tax );
236 * Check whether to disable the Menu Locations meta box submit button
240 * @global bool $one_theme_location_no_menus to determine if no menus exist
242 * @param int|string $nav_menu_selected_id (id, name or slug) of the currently-selected menu
243 * @return string Disabled attribute if at least one menu exists, false if not
245 function wp_nav_menu_disabled_check( $nav_menu_selected_id ) {
246 global $one_theme_location_no_menus;
248 if ( $one_theme_location_no_menus )
251 return disabled( $nav_menu_selected_id, 0 );
255 * Displays a meta box for the custom links menu item.
259 * @global int $_nav_menu_placeholder
260 * @global int|string $nav_menu_selected_id
262 function wp_nav_menu_item_link_meta_box() {
263 global $_nav_menu_placeholder, $nav_menu_selected_id;
265 $_nav_menu_placeholder = 0 > $_nav_menu_placeholder ? $_nav_menu_placeholder - 1 : -1;
268 <div class="customlinkdiv" id="customlinkdiv">
269 <input type="hidden" value="custom" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-type]" />
270 <p id="menu-item-url-wrap" class="wp-clearfix">
271 <label class="howto" for="custom-menu-item-url"><?php _e( 'URL' ); ?></label>
272 <input id="custom-menu-item-url" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-url]" type="text" class="code menu-item-textbox" value="http://" />
275 <p id="menu-item-name-wrap" class="wp-clearfix">
276 <label class="howto" for="custom-menu-item-name"><?php _e( 'Link Text' ); ?></label>
277 <input id="custom-menu-item-name" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-title]" type="text" class="regular-text menu-item-textbox" />
280 <p class="button-controls wp-clearfix">
281 <span class="add-to-menu">
282 <input type="submit"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?> class="button-secondary submit-add-to-menu right" value="<?php esc_attr_e('Add to Menu'); ?>" name="add-custom-menu-item" id="submit-customlinkdiv" />
283 <span class="spinner"></span>
287 </div><!-- /.customlinkdiv -->
292 * Displays a meta box for a post type menu item.
296 * @global int $_nav_menu_placeholder
297 * @global int|string $nav_menu_selected_id
299 * @param string $object Not used.
300 * @param array $box {
301 * Post type menu item meta box arguments.
303 * @type string $id Meta box 'id' attribute.
304 * @type string $title Meta box title.
305 * @type string $callback Meta box display callback.
306 * @type WP_Post_Type $args Extra meta box arguments (the post type object for this meta box).
309 function wp_nav_menu_item_post_type_meta_box( $object, $box ) {
310 global $_nav_menu_placeholder, $nav_menu_selected_id;
312 $post_type_name = $box['args']->name;
314 // Paginate browsing for large numbers of post objects.
316 $pagenum = isset( $_REQUEST[$post_type_name . '-tab'] ) && isset( $_REQUEST['paged'] ) ? absint( $_REQUEST['paged'] ) : 1;
317 $offset = 0 < $pagenum ? $per_page * ( $pagenum - 1 ) : 0;
322 'orderby' => 'title',
323 'posts_per_page' => $per_page,
324 'post_type' => $post_type_name,
325 'suppress_filters' => true,
326 'update_post_term_cache' => false,
327 'update_post_meta_cache' => false
330 if ( isset( $box['args']->_default_query ) )
331 $args = array_merge($args, (array) $box['args']->_default_query );
333 // @todo transient caching of these results with proper invalidation on updating of a post of this type
334 $get_posts = new WP_Query;
335 $posts = $get_posts->query( $args );
336 if ( ! $get_posts->post_count ) {
337 echo '<p>' . __( 'No items.' ) . '</p>';
341 $num_pages = $get_posts->max_num_pages;
343 $page_links = paginate_links( array(
344 'base' => add_query_arg(
346 $post_type_name . '-tab' => 'all',
348 'item-type' => 'post_type',
349 'item-object' => $post_type_name,
353 'prev_text' => __('«'),
354 'next_text' => __('»'),
355 'total' => $num_pages,
356 'current' => $pagenum
360 if ( is_post_type_hierarchical( $post_type_name ) ) {
361 $db_fields = array( 'parent' => 'post_parent', 'id' => 'ID' );
364 $walker = new Walker_Nav_Menu_Checklist( $db_fields );
366 $current_tab = 'most-recent';
367 if ( isset( $_REQUEST[$post_type_name . '-tab'] ) && in_array( $_REQUEST[$post_type_name . '-tab'], array('all', 'search') ) ) {
368 $current_tab = $_REQUEST[$post_type_name . '-tab'];
371 if ( ! empty( $_REQUEST['quick-search-posttype-' . $post_type_name] ) ) {
372 $current_tab = 'search';
375 $removed_args = array(
385 <div id="posttype-<?php echo $post_type_name; ?>" class="posttypediv">
386 <ul id="posttype-<?php echo $post_type_name; ?>-tabs" class="posttype-tabs add-menu-item-tabs">
387 <li <?php echo ( 'most-recent' == $current_tab ? ' class="tabs"' : '' ); ?>>
388 <a class="nav-tab-link" data-type="tabs-panel-posttype-<?php echo esc_attr( $post_type_name ); ?>-most-recent" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($post_type_name . '-tab', 'most-recent', remove_query_arg($removed_args))); ?>#tabs-panel-posttype-<?php echo $post_type_name; ?>-most-recent">
389 <?php _e( 'Most Recent' ); ?>
392 <li <?php echo ( 'all' == $current_tab ? ' class="tabs"' : '' ); ?>>
393 <a class="nav-tab-link" data-type="<?php echo esc_attr( $post_type_name ); ?>-all" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($post_type_name . '-tab', 'all', remove_query_arg($removed_args))); ?>#<?php echo $post_type_name; ?>-all">
394 <?php _e( 'View All' ); ?>
397 <li <?php echo ( 'search' == $current_tab ? ' class="tabs"' : '' ); ?>>
398 <a class="nav-tab-link" data-type="tabs-panel-posttype-<?php echo esc_attr( $post_type_name ); ?>-search" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($post_type_name . '-tab', 'search', remove_query_arg($removed_args))); ?>#tabs-panel-posttype-<?php echo $post_type_name; ?>-search">
399 <?php _e( 'Search'); ?>
402 </ul><!-- .posttype-tabs -->
404 <div id="tabs-panel-posttype-<?php echo $post_type_name; ?>-most-recent" class="tabs-panel <?php
405 echo ( 'most-recent' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
407 <ul id="<?php echo $post_type_name; ?>checklist-most-recent" class="categorychecklist form-no-clear">
409 $recent_args = array_merge( $args, array( 'orderby' => 'post_date', 'order' => 'DESC', 'posts_per_page' => 15 ) );
410 $most_recent = $get_posts->query( $recent_args );
411 $args['walker'] = $walker;
414 * Filters the posts displayed in the 'Most Recent' tab of the current
415 * post type's menu items meta box.
417 * The dynamic portion of the hook name, `$post_type_name`, refers to the post type name.
421 * @param array $most_recent An array of post objects being listed.
422 * @param array $args An array of WP_Query arguments.
423 * @param array $box Arguments passed to wp_nav_menu_item_post_type_meta_box().
425 $most_recent = apply_filters( "nav_menu_items_{$post_type_name}_recent", $most_recent, $args, $box );
427 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $most_recent), 0, (object) $args );
430 </div><!-- /.tabs-panel -->
432 <div class="tabs-panel <?php
433 echo ( 'search' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
434 ?>" id="tabs-panel-posttype-<?php echo $post_type_name; ?>-search">
436 if ( isset( $_REQUEST['quick-search-posttype-' . $post_type_name] ) ) {
437 $searched = esc_attr( $_REQUEST['quick-search-posttype-' . $post_type_name] );
438 $search_results = get_posts( array( 's' => $searched, 'post_type' => $post_type_name, 'fields' => 'all', 'order' => 'DESC', ) );
441 $search_results = array();
444 <p class="quick-search-wrap">
445 <label for="quick-search-posttype-<?php echo $post_type_name; ?>" class="screen-reader-text"><?php _e( 'Search' ); ?></label>
446 <input type="search" class="quick-search" value="<?php echo $searched; ?>" name="quick-search-posttype-<?php echo $post_type_name; ?>" id="quick-search-posttype-<?php echo $post_type_name; ?>" />
447 <span class="spinner"></span>
448 <?php submit_button( __( 'Search' ), 'button-small quick-search-submit button-secondary hide-if-js', 'submit', false, array( 'id' => 'submit-quick-search-posttype-' . $post_type_name ) ); ?>
451 <ul id="<?php echo $post_type_name; ?>-search-checklist" data-wp-lists="list:<?php echo $post_type_name?>" class="categorychecklist form-no-clear">
452 <?php if ( ! empty( $search_results ) && ! is_wp_error( $search_results ) ) : ?>
454 $args['walker'] = $walker;
455 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $search_results), 0, (object) $args );
457 <?php elseif ( is_wp_error( $search_results ) ) : ?>
458 <li><?php echo $search_results->get_error_message(); ?></li>
459 <?php elseif ( ! empty( $searched ) ) : ?>
460 <li><?php _e('No results found.'); ?></li>
463 </div><!-- /.tabs-panel -->
465 <div id="<?php echo $post_type_name; ?>-all" class="tabs-panel tabs-panel-view-all <?php
466 echo ( 'all' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
468 <?php if ( ! empty( $page_links ) ) : ?>
469 <div class="add-menu-item-pagelinks">
470 <?php echo $page_links; ?>
473 <ul id="<?php echo $post_type_name; ?>checklist" data-wp-lists="list:<?php echo $post_type_name?>" class="categorychecklist form-no-clear">
475 $args['walker'] = $walker;
478 * If we're dealing with pages, let's put a checkbox for the front
479 * page at the top of the list.
481 if ( 'page' == $post_type_name ) {
482 $front_page = 'page' == get_option('show_on_front') ? (int) get_option( 'page_on_front' ) : 0;
483 if ( ! empty( $front_page ) ) {
484 $front_page_obj = get_post( $front_page );
485 $front_page_obj->front_or_home = true;
486 array_unshift( $posts, $front_page_obj );
488 $_nav_menu_placeholder = ( 0 > $_nav_menu_placeholder ) ? intval($_nav_menu_placeholder) - 1 : -1;
489 array_unshift( $posts, (object) array(
490 'front_or_home' => true,
492 'object_id' => $_nav_menu_placeholder,
493 'post_content' => '',
494 'post_excerpt' => '',
496 'post_title' => _x('Home', 'nav menu home label'),
497 'post_type' => 'nav_menu_item',
499 'url' => home_url('/'),
504 $post_type = get_post_type_object( $post_type_name );
505 $archive_link = get_post_type_archive_link( $post_type_name );
506 if ( $post_type->has_archive ) {
507 $_nav_menu_placeholder = ( 0 > $_nav_menu_placeholder ) ? intval($_nav_menu_placeholder) - 1 : -1;
508 array_unshift( $posts, (object) array(
510 'object_id' => $_nav_menu_placeholder,
511 'object' => $post_type_name,
512 'post_content' => '',
513 'post_excerpt' => '',
514 'post_title' => $post_type->labels->archives,
515 'post_type' => 'nav_menu_item',
516 'type' => 'post_type_archive',
517 'url' => get_post_type_archive_link( $post_type_name ),
522 * Filters the posts displayed in the 'View All' tab of the current
523 * post type's menu items meta box.
525 * The dynamic portion of the hook name, `$post_type_name`, refers
526 * to the slug of the current post type.
529 * @since 4.6.0 Converted the `$post_type` parameter to accept a WP_Post_Type object.
531 * @see WP_Query::query()
533 * @param array $posts The posts for the current post type.
534 * @param array $args An array of WP_Query arguments.
535 * @param WP_Post_Type $post_type The current post type object for this menu item meta box.
537 $posts = apply_filters( "nav_menu_items_{$post_type_name}", $posts, $args, $post_type );
539 $checkbox_items = walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $posts), 0, (object) $args );
541 if ( 'all' == $current_tab && ! empty( $_REQUEST['selectall'] ) ) {
542 $checkbox_items = preg_replace('/(type=(.)checkbox(\2))/', '$1 checked=$2checked$2', $checkbox_items);
546 echo $checkbox_items;
549 <?php if ( ! empty( $page_links ) ) : ?>
550 <div class="add-menu-item-pagelinks">
551 <?php echo $page_links; ?>
554 </div><!-- /.tabs-panel -->
556 <p class="button-controls wp-clearfix">
557 <span class="list-controls">
559 echo esc_url( add_query_arg(
561 $post_type_name . '-tab' => 'all',
564 remove_query_arg( $removed_args )
566 ?>#posttype-<?php echo $post_type_name; ?>" class="select-all"><?php _e('Select All'); ?></a>
569 <span class="add-to-menu">
570 <input type="submit"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?> class="button-secondary submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu' ); ?>" name="add-post-type-menu-item" id="<?php echo esc_attr( 'submit-posttype-' . $post_type_name ); ?>" />
571 <span class="spinner"></span>
575 </div><!-- /.posttypediv -->
580 * Displays a meta box for a taxonomy menu item.
584 * @global int|string $nav_menu_selected_id
586 * @param string $object Not used.
587 * @param array $box {
588 * Taxonomy menu item meta box arguments.
590 * @type string $id Meta box 'id' attribute.
591 * @type string $title Meta box title.
592 * @type string $callback Meta box display callback.
593 * @type object $args Extra meta box arguments (the taxonomy object for this meta box).
596 function wp_nav_menu_item_taxonomy_meta_box( $object, $box ) {
597 global $nav_menu_selected_id;
598 $taxonomy_name = $box['args']->name;
600 // Paginate browsing for large numbers of objects.
602 $pagenum = isset( $_REQUEST[$taxonomy_name . '-tab'] ) && isset( $_REQUEST['paged'] ) ? absint( $_REQUEST['paged'] ) : 1;
603 $offset = 0 < $pagenum ? $per_page * ( $pagenum - 1 ) : 0;
608 'hide_empty' => false,
611 'number' => $per_page,
615 'pad_counts' => false,
618 $terms = get_terms( $taxonomy_name, $args );
620 if ( ! $terms || is_wp_error($terms) ) {
621 echo '<p>' . __( 'No items.' ) . '</p>';
625 $num_pages = ceil( wp_count_terms( $taxonomy_name , array_merge( $args, array('number' => '', 'offset' => '') ) ) / $per_page );
627 $page_links = paginate_links( array(
628 'base' => add_query_arg(
630 $taxonomy_name . '-tab' => 'all',
632 'item-type' => 'taxonomy',
633 'item-object' => $taxonomy_name,
637 'prev_text' => __('«'),
638 'next_text' => __('»'),
639 'total' => $num_pages,
640 'current' => $pagenum
644 if ( is_taxonomy_hierarchical( $taxonomy_name ) ) {
645 $db_fields = array( 'parent' => 'parent', 'id' => 'term_id' );
648 $walker = new Walker_Nav_Menu_Checklist( $db_fields );
650 $current_tab = 'most-used';
651 if ( isset( $_REQUEST[$taxonomy_name . '-tab'] ) && in_array( $_REQUEST[$taxonomy_name . '-tab'], array('all', 'most-used', 'search') ) ) {
652 $current_tab = $_REQUEST[$taxonomy_name . '-tab'];
655 if ( ! empty( $_REQUEST['quick-search-taxonomy-' . $taxonomy_name] ) ) {
656 $current_tab = 'search';
659 $removed_args = array(
669 <div id="taxonomy-<?php echo $taxonomy_name; ?>" class="taxonomydiv">
670 <ul id="taxonomy-<?php echo $taxonomy_name; ?>-tabs" class="taxonomy-tabs add-menu-item-tabs">
671 <li <?php echo ( 'most-used' == $current_tab ? ' class="tabs"' : '' ); ?>>
672 <a class="nav-tab-link" data-type="tabs-panel-<?php echo esc_attr( $taxonomy_name ); ?>-pop" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($taxonomy_name . '-tab', 'most-used', remove_query_arg($removed_args))); ?>#tabs-panel-<?php echo $taxonomy_name; ?>-pop">
673 <?php _e( 'Most Used' ); ?>
676 <li <?php echo ( 'all' == $current_tab ? ' class="tabs"' : '' ); ?>>
677 <a class="nav-tab-link" data-type="tabs-panel-<?php echo esc_attr( $taxonomy_name ); ?>-all" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($taxonomy_name . '-tab', 'all', remove_query_arg($removed_args))); ?>#tabs-panel-<?php echo $taxonomy_name; ?>-all">
678 <?php _e( 'View All' ); ?>
681 <li <?php echo ( 'search' == $current_tab ? ' class="tabs"' : '' ); ?>>
682 <a class="nav-tab-link" data-type="tabs-panel-search-taxonomy-<?php echo esc_attr( $taxonomy_name ); ?>" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($taxonomy_name . '-tab', 'search', remove_query_arg($removed_args))); ?>#tabs-panel-search-taxonomy-<?php echo $taxonomy_name; ?>">
683 <?php _e( 'Search' ); ?>
686 </ul><!-- .taxonomy-tabs -->
688 <div id="tabs-panel-<?php echo $taxonomy_name; ?>-pop" class="tabs-panel <?php
689 echo ( 'most-used' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
691 <ul id="<?php echo $taxonomy_name; ?>checklist-pop" class="categorychecklist form-no-clear" >
693 $popular_terms = get_terms( $taxonomy_name, array( 'orderby' => 'count', 'order' => 'DESC', 'number' => 10, 'hierarchical' => false ) );
694 $args['walker'] = $walker;
695 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $popular_terms), 0, (object) $args );
698 </div><!-- /.tabs-panel -->
700 <div id="tabs-panel-<?php echo $taxonomy_name; ?>-all" class="tabs-panel tabs-panel-view-all <?php
701 echo ( 'all' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
703 <?php if ( ! empty( $page_links ) ) : ?>
704 <div class="add-menu-item-pagelinks">
705 <?php echo $page_links; ?>
708 <ul id="<?php echo $taxonomy_name; ?>checklist" data-wp-lists="list:<?php echo $taxonomy_name?>" class="categorychecklist form-no-clear">
710 $args['walker'] = $walker;
711 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $terms), 0, (object) $args );
714 <?php if ( ! empty( $page_links ) ) : ?>
715 <div class="add-menu-item-pagelinks">
716 <?php echo $page_links; ?>
719 </div><!-- /.tabs-panel -->
721 <div class="tabs-panel <?php
722 echo ( 'search' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
723 ?>" id="tabs-panel-search-taxonomy-<?php echo $taxonomy_name; ?>">
725 if ( isset( $_REQUEST['quick-search-taxonomy-' . $taxonomy_name] ) ) {
726 $searched = esc_attr( $_REQUEST['quick-search-taxonomy-' . $taxonomy_name] );
727 $search_results = get_terms( $taxonomy_name, array( 'name__like' => $searched, 'fields' => 'all', 'orderby' => 'count', 'order' => 'DESC', 'hierarchical' => false ) );
730 $search_results = array();
733 <p class="quick-search-wrap">
734 <label for="quick-search-taxonomy-<?php echo $taxonomy_name; ?>" class="screen-reader-text"><?php _e( 'Search' ); ?></label>
735 <input type="search" class="quick-search" value="<?php echo $searched; ?>" name="quick-search-taxonomy-<?php echo $taxonomy_name; ?>" id="quick-search-taxonomy-<?php echo $taxonomy_name; ?>" />
736 <span class="spinner"></span>
737 <?php submit_button( __( 'Search' ), 'button-small quick-search-submit button-secondary hide-if-js', 'submit', false, array( 'id' => 'submit-quick-search-taxonomy-' . $taxonomy_name ) ); ?>
740 <ul id="<?php echo $taxonomy_name; ?>-search-checklist" data-wp-lists="list:<?php echo $taxonomy_name?>" class="categorychecklist form-no-clear">
741 <?php if ( ! empty( $search_results ) && ! is_wp_error( $search_results ) ) : ?>
743 $args['walker'] = $walker;
744 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $search_results), 0, (object) $args );
746 <?php elseif ( is_wp_error( $search_results ) ) : ?>
747 <li><?php echo $search_results->get_error_message(); ?></li>
748 <?php elseif ( ! empty( $searched ) ) : ?>
749 <li><?php _e('No results found.'); ?></li>
752 </div><!-- /.tabs-panel -->
754 <p class="button-controls wp-clearfix">
755 <span class="list-controls">
757 echo esc_url(add_query_arg(
759 $taxonomy_name . '-tab' => 'all',
762 remove_query_arg($removed_args)
764 ?>#taxonomy-<?php echo $taxonomy_name; ?>" class="select-all"><?php _e('Select All'); ?></a>
767 <span class="add-to-menu">
768 <input type="submit"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?> class="button-secondary submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu' ); ?>" name="add-taxonomy-menu-item" id="<?php echo esc_attr( 'submit-taxonomy-' . $taxonomy_name ); ?>" />
769 <span class="spinner"></span>
773 </div><!-- /.taxonomydiv -->
778 * Save posted nav menu item data.
782 * @param int $menu_id The menu ID for which to save this item. $menu_id of 0 makes a draft, orphaned menu item.
783 * @param array $menu_data The unsanitized posted menu item data.
784 * @return array The database IDs of the items saved
786 function wp_save_nav_menu_items( $menu_id = 0, $menu_data = array() ) {
787 $menu_id = (int) $menu_id;
788 $items_saved = array();
790 if ( 0 == $menu_id || is_nav_menu( $menu_id ) ) {
792 // Loop through all the menu items' POST values.
793 foreach ( (array) $menu_data as $_possible_db_id => $_item_object_data ) {
795 // Checkbox is not checked.
796 empty( $_item_object_data['menu-item-object-id'] ) &&
798 // And item type either isn't set.
799 ! isset( $_item_object_data['menu-item-type'] ) ||
800 // Or URL is the default.
801 in_array( $_item_object_data['menu-item-url'], array( 'http://', '' ) ) ||
802 ! ( 'custom' == $_item_object_data['menu-item-type'] && ! isset( $_item_object_data['menu-item-db-id'] ) ) || // or it's not a custom menu item (but not the custom home page)
803 // Or it *is* a custom menu item that already exists.
804 ! empty( $_item_object_data['menu-item-db-id'] )
807 // Then this potential menu item is not getting added to this menu.
811 // If this possible menu item doesn't actually have a menu database ID yet.
813 empty( $_item_object_data['menu-item-db-id'] ) ||
814 ( 0 > $_possible_db_id ) ||
815 $_possible_db_id != $_item_object_data['menu-item-db-id']
819 $_actual_db_id = (int) $_item_object_data['menu-item-db-id'];
823 'menu-item-db-id' => ( isset( $_item_object_data['menu-item-db-id'] ) ? $_item_object_data['menu-item-db-id'] : '' ),
824 'menu-item-object-id' => ( isset( $_item_object_data['menu-item-object-id'] ) ? $_item_object_data['menu-item-object-id'] : '' ),
825 'menu-item-object' => ( isset( $_item_object_data['menu-item-object'] ) ? $_item_object_data['menu-item-object'] : '' ),
826 'menu-item-parent-id' => ( isset( $_item_object_data['menu-item-parent-id'] ) ? $_item_object_data['menu-item-parent-id'] : '' ),
827 'menu-item-position' => ( isset( $_item_object_data['menu-item-position'] ) ? $_item_object_data['menu-item-position'] : '' ),
828 'menu-item-type' => ( isset( $_item_object_data['menu-item-type'] ) ? $_item_object_data['menu-item-type'] : '' ),
829 'menu-item-title' => ( isset( $_item_object_data['menu-item-title'] ) ? $_item_object_data['menu-item-title'] : '' ),
830 'menu-item-url' => ( isset( $_item_object_data['menu-item-url'] ) ? $_item_object_data['menu-item-url'] : '' ),
831 'menu-item-description' => ( isset( $_item_object_data['menu-item-description'] ) ? $_item_object_data['menu-item-description'] : '' ),
832 'menu-item-attr-title' => ( isset( $_item_object_data['menu-item-attr-title'] ) ? $_item_object_data['menu-item-attr-title'] : '' ),
833 'menu-item-target' => ( isset( $_item_object_data['menu-item-target'] ) ? $_item_object_data['menu-item-target'] : '' ),
834 'menu-item-classes' => ( isset( $_item_object_data['menu-item-classes'] ) ? $_item_object_data['menu-item-classes'] : '' ),
835 'menu-item-xfn' => ( isset( $_item_object_data['menu-item-xfn'] ) ? $_item_object_data['menu-item-xfn'] : '' ),
838 $items_saved[] = wp_update_nav_menu_item( $menu_id, $_actual_db_id, $args );
846 * Adds custom arguments to some of the meta box object types.
852 * @param object $object The post type or taxonomy meta-object.
853 * @return object The post type of taxonomy object.
855 function _wp_nav_menu_meta_box_object( $object = null ) {
856 if ( isset( $object->name ) ) {
858 if ( 'page' == $object->name ) {
859 $object->_default_query = array(
860 'orderby' => 'menu_order title',
861 'post_status' => 'publish',
864 // Posts should show only published items.
865 } elseif ( 'post' == $object->name ) {
866 $object->_default_query = array(
867 'post_status' => 'publish',
870 // Categories should be in reverse chronological order.
871 } elseif ( 'category' == $object->name ) {
872 $object->_default_query = array(
877 // Custom post types should show only published items.
879 $object->_default_query = array(
880 'post_status' => 'publish',
889 * Returns the menu formatted to edit.
893 * @param int $menu_id Optional. The ID of the menu to format. Default 0.
894 * @return string|WP_Error $output The menu formatted to edit or error object on failure.
896 function wp_get_nav_menu_to_edit( $menu_id = 0 ) {
897 $menu = wp_get_nav_menu_object( $menu_id );
899 // If the menu exists, get its items.
900 if ( is_nav_menu( $menu ) ) {
901 $menu_items = wp_get_nav_menu_items( $menu->term_id, array('post_status' => 'any') );
902 $result = '<div id="menu-instructions" class="post-body-plain';
903 $result .= ( ! empty($menu_items) ) ? ' menu-instructions-inactive">' : '">';
904 $result .= '<p>' . __( 'Add menu items from the column on the left.' ) . '</p>';
907 if ( empty($menu_items) )
908 return $result . ' <ul class="menu" id="menu-to-edit"> </ul>';
911 * Filters the Walker class used when adding nav menu items.
915 * @param string $class The walker class to use. Default 'Walker_Nav_Menu_Edit'.
916 * @param int $menu_id ID of the menu being rendered.
918 $walker_class_name = apply_filters( 'wp_edit_nav_menu_walker', 'Walker_Nav_Menu_Edit', $menu_id );
920 if ( class_exists( $walker_class_name ) ) {
921 $walker = new $walker_class_name;
923 return new WP_Error( 'menu_walker_not_exist',
924 /* translators: %s: walker class name */
925 sprintf( __( 'The Walker class named %s does not exist.' ),
926 '<strong>' . $walker_class_name . '</strong>'
931 $some_pending_menu_items = $some_invalid_menu_items = false;
932 foreach ( (array) $menu_items as $menu_item ) {
933 if ( isset( $menu_item->post_status ) && 'draft' == $menu_item->post_status )
934 $some_pending_menu_items = true;
935 if ( ! empty( $menu_item->_invalid ) )
936 $some_invalid_menu_items = true;
939 if ( $some_pending_menu_items ) {
940 $result .= '<div class="notice notice-info notice-alt inline"><p>' . __( 'Click Save Menu to make pending menu items public.' ) . '</p></div>';
943 if ( $some_invalid_menu_items ) {
944 $result .= '<div class="notice notice-error notice-alt inline"><p>' . __( 'There are some invalid menu items. Please check or delete them.' ) . '</p></div>';
947 $result .= '<ul class="menu" id="menu-to-edit"> ';
948 $result .= walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $menu_items), 0, (object) array('walker' => $walker ) );
949 $result .= ' </ul> ';
951 } elseif ( is_wp_error( $menu ) ) {
958 * Returns the columns for the nav menus page.
962 * @return array Columns.
964 function wp_nav_menu_manage_columns() {
966 '_title' => __( 'Show advanced menu properties' ),
967 'cb' => '<input type="checkbox" />',
968 'link-target' => __( 'Link Target' ),
969 'title-attribute' => __( 'Title Attribute' ),
970 'css-classes' => __( 'CSS Classes' ),
971 'xfn' => __( 'Link Relationship (XFN)' ),
972 'description' => __( 'Description' ),
977 * Deletes orphaned draft menu items
982 * @global wpdb $wpdb WordPress database abstraction object.
984 function _wp_delete_orphaned_draft_menu_items() {
986 $delete_timestamp = time() - ( DAY_IN_SECONDS * EMPTY_TRASH_DAYS );
988 // Delete orphaned draft menu items.
989 $menu_items_to_delete = $wpdb->get_col($wpdb->prepare("SELECT ID FROM $wpdb->posts AS p LEFT JOIN $wpdb->postmeta AS m ON p.ID = m.post_id WHERE post_type = 'nav_menu_item' AND post_status = 'draft' AND meta_key = '_menu_item_orphaned' AND meta_value < '%d'", $delete_timestamp ) );
991 foreach ( (array) $menu_items_to_delete as $menu_item_id )
992 wp_delete_post( $menu_item_id, true );
996 * Saves nav menu items
1000 * @param int|string $nav_menu_selected_id (id, slug, or name ) of the currently-selected menu
1001 * @param string $nav_menu_selected_title Title of the currently-selected menu
1002 * @return array $messages The menu updated message
1004 function wp_nav_menu_update_menu_items ( $nav_menu_selected_id, $nav_menu_selected_title ) {
1005 $unsorted_menu_items = wp_get_nav_menu_items( $nav_menu_selected_id, array( 'orderby' => 'ID', 'output' => ARRAY_A, 'output_key' => 'ID', 'post_status' => 'draft,publish' ) );
1006 $messages = array();
1007 $menu_items = array();
1008 // Index menu items by db ID
1009 foreach ( $unsorted_menu_items as $_item )
1010 $menu_items[$_item->db_id] = $_item;
1012 $post_fields = array(
1013 'menu-item-db-id', 'menu-item-object-id', 'menu-item-object',
1014 'menu-item-parent-id', 'menu-item-position', 'menu-item-type',
1015 'menu-item-title', 'menu-item-url', 'menu-item-description',
1016 'menu-item-attr-title', 'menu-item-target', 'menu-item-classes', 'menu-item-xfn'
1019 wp_defer_term_counting( true );
1020 // Loop through all the menu items' POST variables
1021 if ( ! empty( $_POST['menu-item-db-id'] ) ) {
1022 foreach ( (array) $_POST['menu-item-db-id'] as $_key => $k ) {
1024 // Menu item title can't be blank
1025 if ( ! isset( $_POST['menu-item-title'][ $_key ] ) || '' == $_POST['menu-item-title'][ $_key ] )
1029 foreach ( $post_fields as $field )
1030 $args[$field] = isset( $_POST[$field][$_key] ) ? $_POST[$field][$_key] : '';
1032 $menu_item_db_id = wp_update_nav_menu_item( $nav_menu_selected_id, ( $_POST['menu-item-db-id'][$_key] != $_key ? 0 : $_key ), $args );
1034 if ( is_wp_error( $menu_item_db_id ) ) {
1035 $messages[] = '<div id="message" class="error"><p>' . $menu_item_db_id->get_error_message() . '</p></div>';
1037 unset( $menu_items[ $menu_item_db_id ] );
1042 // Remove menu items from the menu that weren't in $_POST
1043 if ( ! empty( $menu_items ) ) {
1044 foreach ( array_keys( $menu_items ) as $menu_item_id ) {
1045 if ( is_nav_menu_item( $menu_item_id ) ) {
1046 wp_delete_post( $menu_item_id );
1051 // Store 'auto-add' pages.
1052 $auto_add = ! empty( $_POST['auto-add-pages'] );
1053 $nav_menu_option = (array) get_option( 'nav_menu_options' );
1054 if ( ! isset( $nav_menu_option['auto_add'] ) )
1055 $nav_menu_option['auto_add'] = array();
1057 if ( ! in_array( $nav_menu_selected_id, $nav_menu_option['auto_add'] ) )
1058 $nav_menu_option['auto_add'][] = $nav_menu_selected_id;
1060 if ( false !== ( $key = array_search( $nav_menu_selected_id, $nav_menu_option['auto_add'] ) ) )
1061 unset( $nav_menu_option['auto_add'][$key] );
1063 // Remove nonexistent/deleted menus
1064 $nav_menu_option['auto_add'] = array_intersect( $nav_menu_option['auto_add'], wp_get_nav_menus( array( 'fields' => 'ids' ) ) );
1065 update_option( 'nav_menu_options', $nav_menu_option );
1067 wp_defer_term_counting( false );
1069 /** This action is documented in wp-includes/nav-menu.php */
1070 do_action( 'wp_update_nav_menu', $nav_menu_selected_id );
1072 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' .
1073 /* translators: %s: nav menu title */
1074 sprintf( __( '%s has been updated.' ),
1075 '<strong>' . $nav_menu_selected_title . '</strong>'
1078 unset( $menu_items, $unsorted_menu_items );
1084 * If a JSON blob of navigation menu data is in POST data, expand it and inject
1085 * it into `$_POST` to avoid PHP `max_input_vars` limitations. See #14134.
1091 function _wp_expand_nav_menu_post_data() {
1092 if ( ! isset( $_POST['nav-menu-data'] ) ) {
1096 $data = json_decode( stripslashes( $_POST['nav-menu-data'] ) );
1098 if ( ! is_null( $data ) && $data ) {
1099 foreach ( $data as $post_input_data ) {
1100 // For input names that are arrays (e.g. `menu-item-db-id[3][4][5]`),
1101 // derive the array path keys via regex and set the value in $_POST.
1102 preg_match( '#([^\[]*)(\[(.+)\])?#', $post_input_data->name, $matches );
1104 $array_bits = array( $matches[1] );
1106 if ( isset( $matches[3] ) ) {
1107 $array_bits = array_merge( $array_bits, explode( '][', $matches[3] ) );
1110 $new_post_data = array();
1112 // Build the new array value from leaf to trunk.
1113 for ( $i = count( $array_bits ) - 1; $i >= 0; $i -- ) {
1114 if ( $i == count( $array_bits ) - 1 ) {
1115 $new_post_data[ $array_bits[ $i ] ] = wp_slash( $post_input_data->value );
1117 $new_post_data = array( $array_bits[ $i ] => $new_post_data );
1121 $_POST = array_replace_recursive( $_POST, $new_post_data );