1<?php
2/**
3 * Core Navigation Menu API
4 *
5 * @package WordPress
6 * @subpackage Nav_Menus
7 * @since 3.0.0
8 */
9
10/** Walker_Nav_Menu_Edit class */
11require_once ABSPATH . 'wp-admin/includes/class-walker-nav-menu-edit.php';
12
13/** Walker_Nav_Menu_Checklist class */
14require_once ABSPATH . 'wp-admin/includes/class-walker-nav-menu-checklist.php';
15
16/**
17 * Prints the appropriate response to a menu quick search.
18 *
19 * @since 3.0.0
20 *
21 * @param array $request The unsanitized request values.
22 */
23function _wp_ajax_menu_quick_search( $request = array() ) {
24 $args = 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'] ) ? $request['response-format'] : '';
29
30 if ( ! $response_format || ! in_array( $response_format, array( 'json', 'markup' ), true ) ) {
31 $response_format = 'json';
32 }
33
34 if ( 'markup' === $response_format ) {
35 $args['walker'] = new Walker_Nav_Menu_Checklist();
36 }
37
38 if ( 'get-post-item' === $type ) {
39 if ( post_type_exists( $object_type ) ) {
40 if ( isset( $request['ID'] ) ) {
41 $object_id = (int) $request['ID'];
42
43 if ( 'markup' === $response_format ) {
44 echo walk_nav_menu_tree(
45 array_map( 'wp_setup_nav_menu_item', array( get_post( $object_id ) ) ),
46 0,
47 (object) $args
48 );
49 } elseif ( 'json' === $response_format ) {
50 echo wp_json_encode(
51 array(
52 'ID' => $object_id,
53 'post_title' => get_the_title( $object_id ),
54 'post_type' => get_post_type( $object_id ),
55 )
56 );
57 echo "\n";
58 }
59 }
60 } elseif ( taxonomy_exists( $object_type ) ) {
61 if ( isset( $request['ID'] ) ) {
62 $object_id = (int) $request['ID'];
63
64 if ( 'markup' === $response_format ) {
65 echo walk_nav_menu_tree(
66 array_map( 'wp_setup_nav_menu_item', array( get_term( $object_id, $object_type ) ) ),
67 0,
68 (object) $args
69 );
70 } elseif ( 'json' === $response_format ) {
71 $post_obj = get_term( $object_id, $object_type );
72 echo wp_json_encode(
73 array(
74 'ID' => $object_id,
75 'post_title' => $post_obj->name,
76 'post_type' => $object_type,
77 )
78 );
79 echo "\n";
80 }
81 }
82 }
83 } elseif ( preg_match( '/quick-search-(posttype|taxonomy)-([a-zA-Z0-9_-]*\b)/', $type, $matches ) ) {
84 if ( 'posttype' === $matches[1] && get_post_type_object( $matches[2] ) ) {
85 $post_type_obj = _wp_nav_menu_meta_box_object( get_post_type_object( $matches[2] ) );
86 $query_args = array(
87 'no_found_rows' => true,
88 'update_post_meta_cache' => false,
89 'update_post_term_cache' => false,
90 'posts_per_page' => 10,
91 'post_type' => $matches[2],
92 's' => $query,
93 'search_columns' => array( 'post_title' ),
94 );
95 /**
96 * Filter the menu quick search arguments.
97 *
98 * @since 6.9.0
99 *
100 * @param array $args {
101 * Menu quick search arguments.
102 *
103 * @type boolean $no_found_rows Whether to return found rows data. Default true.
104 * @type boolean $update_post_meta_cache Whether to update post meta cache. Default false.
105 * @type boolean $update_post_term_cache Whether to update post term cache. Default false.
106 * @type int $posts_per_page Number of posts to return. Default 10.
107 * @type string $post_type Type of post to return.
108 * @type string $s Search query.
109 * @type array $search_columns Which post table columns to query.
110 * }
111 */
112 $query_args = apply_filters( 'wp_ajax_menu_quick_search_args', $query_args );
113 $args = array_merge( $args, $query_args );
114
115 if ( isset( $post_type_obj->_default_query ) ) {
116 $args = array_merge( $args, (array) $post_type_obj->_default_query );
117 }
118
119 $search_results_query = new WP_Query( $args );
120 if ( ! $search_results_query->have_posts() ) {
121 return;
122 }
123
124 while ( $search_results_query->have_posts() ) {
125 $post = $search_results_query->next_post();
126
127 if ( 'markup' === $response_format ) {
128 $var_by_ref = $post->ID;
129 echo walk_nav_menu_tree(
130 array_map( 'wp_setup_nav_menu_item', array( get_post( $var_by_ref ) ) ),
131 0,
132 (object) $args
133 );
134 } elseif ( 'json' === $response_format ) {
135 echo wp_json_encode(
136 array(
137 'ID' => $post->ID,
138 'post_title' => get_the_title( $post->ID ),
139 'post_type' => $matches[2],
140 )
141 );
142 echo "\n";
143 }
144 }
145 } elseif ( 'taxonomy' === $matches[1] ) {
146 $terms = get_terms(
147 array(
148 'taxonomy' => $matches[2],
149 'name__like' => $query,
150 'number' => 10,
151 'hide_empty' => false,
152 )
153 );
154
155 if ( empty( $terms ) || is_wp_error( $terms ) ) {
156 return;
157 }
158
159 foreach ( (array) $terms as $term ) {
160 if ( 'markup' === $response_format ) {
161 echo walk_nav_menu_tree(
162 array_map( 'wp_setup_nav_menu_item', array( $term ) ),
163 0,
164 (object) $args
165 );
166 } elseif ( 'json' === $response_format ) {
167 echo wp_json_encode(
168 array(
169 'ID' => $term->term_id,
170 'post_title' => $term->name,
171 'post_type' => $matches[2],
172 )
173 );
174 echo "\n";
175 }
176 }
177 }
178 }
179}
180
181/**
182 * Register nav menu meta boxes and advanced menu items.
183 *
184 * @since 3.0.0
185 */
186function wp_nav_menu_setup() {
187 // Register meta boxes.
188 wp_nav_menu_post_type_meta_boxes();
189 add_meta_box(
190 'add-custom-links',
191 __( 'Custom Links' ),
192 'wp_nav_menu_item_link_meta_box',
193 'nav-menus',
194 'side',
195 'default'
196 );
197 wp_nav_menu_taxonomy_meta_boxes();
198
199 // Register advanced menu items (columns).
200 add_filter( 'manage_nav-menus_columns', 'wp_nav_menu_manage_columns' );
201
202 // If first time editing, disable advanced items by default.
203 if ( false === get_user_option( 'managenav-menuscolumnshidden' ) ) {
204 $user = wp_get_current_user();
205 update_user_meta(
206 $user->ID,
207 'managenav-menuscolumnshidden',
208 array(
209 0 => 'link-target',
210 1 => 'css-classes',
211 2 => 'xfn',
212 3 => 'description',
213 4 => 'title-attribute',
214 )
215 );
216 }
217}
218
219/**
220 * Limit the amount of meta boxes to pages, posts, links, and categories for first time users.
221 *
222 * @since 3.0.0
223 *
224 * @global array $wp_meta_boxes Global meta box state.
225 */
226function wp_initial_nav_menu_meta_boxes() {
227 global $wp_meta_boxes;
228
229 if ( get_user_option( 'metaboxhidden_nav-menus' ) !== false || ! is_array( $wp_meta_boxes ) ) {
230 return;
231 }
232
233 $initial_meta_boxes = array( 'add-post-type-page', 'add-post-type-post', 'add-custom-links', 'add-category' );
234 $hidden_meta_boxes = array();
235
236 foreach ( array_keys( $wp_meta_boxes['nav-menus'] ) as $context ) {
237 foreach ( array_keys( $wp_meta_boxes['nav-menus'][ $context ] ) as $priority ) {
238 foreach ( $wp_meta_boxes['nav-menus'][ $context ][ $priority ] as $box ) {
239 if ( in_array( $box['id'], $initial_meta_boxes, true ) ) {
240 unset( $box['id'] );
241 } else {
242 $hidden_meta_boxes[] = $box['id'];
243 }
244 }
245 }
246 }
247
248 $user = wp_get_current_user();
249 update_user_meta( $user->ID, 'metaboxhidden_nav-menus', $hidden_meta_boxes );
250}
251
252/**
253 * Creates meta boxes for any post type menu item..
254 *
255 * @since 3.0.0
256 */
257function wp_nav_menu_post_type_meta_boxes() {
258 $post_types = get_post_types( array( 'show_in_nav_menus' => true ), 'object' );
259
260 if ( ! $post_types ) {
261 return;
262 }
263
264 foreach ( $post_types as $post_type ) {
265 /**
266 * Filters whether a menu items meta box will be added for the current
267 * object type.
268 *
269 * If a falsey value is returned instead of an object, the menu items
270 * meta box for the current meta box object will not be added.
271 *
272 * @since 3.0.0
273 *
274 * @param WP_Post_Type|false $post_type The current object to add a menu items
275 * meta box for.
276 */
277 $post_type = apply_filters( 'nav_menu_meta_box_object', $post_type );
278
279 if ( $post_type ) {
280 $id = $post_type->name;
281 // Give pages a higher priority.
282 $priority = ( 'page' === $post_type->name ? 'core' : 'default' );
283 add_meta_box(
284 "add-post-type-{$id}",
285 $post_type->labels->name,
286 'wp_nav_menu_item_post_type_meta_box',
287 'nav-menus',
288 'side',
289 $priority,
290 $post_type
291 );
292 }
293 }
294}
295
296/**
297 * Creates meta boxes for any taxonomy menu item.
298 *
299 * @since 3.0.0
300 */
301function wp_nav_menu_taxonomy_meta_boxes() {
302 $taxonomies = get_taxonomies( array( 'show_in_nav_menus' => true ), 'object' );
303
304 if ( ! $taxonomies ) {
305 return;
306 }
307
308 foreach ( $taxonomies as $tax ) {
309 /** This filter is documented in wp-admin/includes/nav-menu.php */
310 $tax = apply_filters( 'nav_menu_meta_box_object', $tax );
311
312 if ( $tax ) {
313 $id = $tax->name;
314 add_meta_box(
315 "add-{$id}",
316 $tax->labels->name,
317 'wp_nav_menu_item_taxonomy_meta_box',
318 'nav-menus',
319 'side',
320 'default',
321 $tax
322 );
323 }
324 }
325}
326
327/**
328 * Check whether to disable the Menu Locations meta box submit button and inputs.
329 *
330 * @since 3.6.0
331 * @since 5.3.1 The `$display` parameter was added.
332 *
333 * @global bool $one_theme_location_no_menus to determine if no menus exist
334 *
335 * @param int|string $nav_menu_selected_id ID, name, or slug of the currently selected menu.
336 * @param bool $display Whether to display or just return the string.
337 * @return string|false Disabled attribute if at least one menu exists, false if not.
338 */
339function wp_nav_menu_disabled_check( $nav_menu_selected_id, $display = true ) {
340 global $one_theme_location_no_menus;
341
342 if ( $one_theme_location_no_menus ) {
343 return false;
344 }
345
346 return disabled( $nav_menu_selected_id, 0, $display );
347}
348
349/**
350 * Displays a meta box for the custom links menu item.
351 *
352 * @since 3.0.0
353 *
354 * @global int $_nav_menu_placeholder
355 * @global int|string $nav_menu_selected_id
356 */
357function wp_nav_menu_item_link_meta_box() {
358 global $_nav_menu_placeholder, $nav_menu_selected_id;
359
360 $_nav_menu_placeholder = 0 > $_nav_menu_placeholder ? $_nav_menu_placeholder - 1 : -1;
361
362 ?>
363 <div class="customlinkdiv" id="customlinkdiv">
364 <input type="hidden" value="custom" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-type]" />
365 <p id="menu-item-url-wrap" class="wp-clearfix">
366 <label class="howto" for="custom-menu-item-url"><?php _e( 'URL' ); ?></label>
367 <input id="custom-menu-item-url" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-url]"
368 type="text"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?>
369 class="code menu-item-textbox form-required" placeholder="https://"
370 />
371 <span id="custom-url-error" class="error-message" style="display: none;"><?php _e( 'Please provide a valid link.' ); ?></span>
372 </p>
373
374 <p id="menu-item-name-wrap" class="wp-clearfix">
375 <label class="howto" for="custom-menu-item-name"><?php _e( 'Link Text' ); ?></label>
376 <input id="custom-menu-item-name" name="menu-item[<?php echo $_nav_menu_placeholder; ?>][menu-item-title]"
377 type="text"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?>
378 class="regular-text menu-item-textbox"
379 />
380 </p>
381
382 <p class="button-controls wp-clearfix">
383 <span class="add-to-menu">
384 <input id="submit-customlinkdiv" name="add-custom-menu-item"
385 type="submit"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?>
386 class="button submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu' ); ?>"
387 />
388 <span class="spinner"></span>
389 </span>
390 </p>
391
392 </div><!-- /.customlinkdiv -->
393 <?php
394}
395
396/**
397 * Displays a meta box for a post type menu item.
398 *
399 * @since 3.0.0
400 *
401 * @global int $_nav_menu_placeholder
402 * @global int|string $nav_menu_selected_id
403 *
404 * @param string $data_object Not used.
405 * @param array $box {
406 * Post type menu item meta box arguments.
407 *
408 * @type string $id Meta box 'id' attribute.
409 * @type string $title Meta box title.
410 * @type callable $callback Meta box display callback.
411 * @type WP_Post_Type $args Extra meta box arguments (the post type object for this meta box).
412 * }
413 */
414function wp_nav_menu_item_post_type_meta_box( $data_object, $box ) {
415 global $_nav_menu_placeholder, $nav_menu_selected_id;
416
417 $post_type_name = $box['args']->name;
418 $post_type = get_post_type_object( $post_type_name );
419 $tab_name = $post_type_name . '-tab';
420
421 // Paginate browsing for large numbers of post objects.
422 $per_page = 50;
423 $pagenum = isset( $_REQUEST[ $tab_name ] ) && isset( $_REQUEST['paged'] ) ? absint( $_REQUEST['paged'] ) : 1;
424 $offset = 0 < $pagenum ? $per_page * ( $pagenum - 1 ) : 0;
425
426 $args = array(
427 'offset' => $offset,
428 'order' => 'ASC',
429 'orderby' => 'title',
430 'posts_per_page' => $per_page,
431 'post_type' => $post_type_name,
432 'suppress_filters' => true,
433 'update_post_term_cache' => false,
434 'update_post_meta_cache' => false,
435 );
436
437 if ( isset( $box['args']->_default_query ) ) {
438 $args = array_merge( $args, (array) $box['args']->_default_query );
439 }
440
441 /*
442 * If we're dealing with pages, let's prioritize the Front Page,
443 * Posts Page and Privacy Policy Page at the top of the list.
444 */
445 $important_pages = array();
446 if ( 'page' === $post_type_name ) {
447 $suppress_page_ids = array();
448
449 // Insert Front Page or custom Home link.
450 $front_page = 'page' === get_option( 'show_on_front' ) ? (int) get_option( 'page_on_front' ) : 0;
451
452 $front_page_obj = null;
453
454 if ( ! empty( $front_page ) ) {
455 $front_page_obj = get_post( $front_page );
456 }
457
458 if ( $front_page_obj ) {
459 $front_page_obj->front_or_home = true;
460
461 $important_pages[] = $front_page_obj;
462 $suppress_page_ids[] = $front_page_obj->ID;
463 } else {
464 $_nav_menu_placeholder = ( 0 > $_nav_menu_placeholder ) ? (int) $_nav_menu_placeholder - 1 : -1;
465 $front_page_obj = (object) array(
466 'front_or_home' => true,
467 'ID' => 0,
468 'object_id' => $_nav_menu_placeholder,
469 'post_content' => '',
470 'post_excerpt' => '',
471 'post_parent' => '',
472 'post_title' => _x( 'Home', 'nav menu home label' ),
473 'post_type' => 'nav_menu_item',
474 'type' => 'custom',
475 'url' => home_url( '/' ),
476 );
477
478 $important_pages[] = $front_page_obj;
479 }
480
481 // Insert Posts Page.
482 $posts_page = 'page' === get_option( 'show_on_front' ) ? (int) get_option( 'page_for_posts' ) : 0;
483
484 if ( ! empty( $posts_page ) ) {
485 $posts_page_obj = get_post( $posts_page );
486
487 if ( $posts_page_obj ) {
488 $front_page_obj->posts_page = true;
489
490 $important_pages[] = $posts_page_obj;
491 $suppress_page_ids[] = $posts_page_obj->ID;
492 }
493 }
494
495 // Insert Privacy Policy Page.
496 $privacy_policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' );
497
498 if ( ! empty( $privacy_policy_page_id ) ) {
499 $privacy_policy_page = get_post( $privacy_policy_page_id );
500
501 if ( $privacy_policy_page instanceof WP_Post && 'publish' === $privacy_policy_page->post_status ) {
502 $privacy_policy_page->privacy_policy_page = true;
503
504 $important_pages[] = $privacy_policy_page;
505 $suppress_page_ids[] = $privacy_policy_page->ID;
506 }
507 }
508
509 // Add suppression array to arguments for WP_Query.
510 if ( ! empty( $suppress_page_ids ) ) {
511 $args['post__not_in'] = $suppress_page_ids;
512 }
513 }
514
515 $get_posts = new WP_Query();
516 $posts = $get_posts->query( $args );
517
518 // Only suppress and insert when more than just suppression pages available.
519 if ( ! $get_posts->post_count ) {
520 if ( ! empty( $suppress_page_ids ) ) {
521 unset( $args['post__not_in'] );
522 $get_posts = new WP_Query();
523 $posts = $get_posts->query( $args );
524 } else {
525 echo '<p>' . __( 'No items.' ) . '</p>';
526 return;
527 }
528 } elseif ( ! empty( $important_pages ) ) {
529 $posts = array_merge( $important_pages, $posts );
530 }
531
532 $num_pages = $get_posts->max_num_pages;
533
534 $page_links = paginate_links(
535 array(
536 'base' => add_query_arg(
537 array(
538 $tab_name => 'all',
539 'paged' => '%#%',
540 'item-type' => 'post_type',
541 'item-object' => $post_type_name,
542 )
543 ),
544 'format' => '',
545 'prev_text' => '<span aria-label="' . esc_attr__( 'Previous page' ) . '">' . __( '«' ) . '</span>',
546 'next_text' => '<span aria-label="' . esc_attr__( 'Next page' ) . '">' . __( '»' ) . '</span>',
547 /* translators: Hidden accessibility text. */
548 'before_page_number' => '<span class="screen-reader-text">' . __( 'Page' ) . '</span> ',
549 'total' => $num_pages,
550 'current' => $pagenum,
551 )
552 );
553
554 $db_fields = false;
555 if ( is_post_type_hierarchical( $post_type_name ) ) {
556 $db_fields = array(
557 'parent' => 'post_parent',
558 'id' => 'ID',
559 );
560 }
561
562 $walker = new Walker_Nav_Menu_Checklist( $db_fields );
563
564 $current_tab = 'most-recent';
565
566 if ( isset( $_REQUEST[ $tab_name ] ) && in_array( $_REQUEST[ $tab_name ], array( 'all', 'search' ), true ) ) {
567 $current_tab = $_REQUEST[ $tab_name ];
568 }
569
570 if ( ! empty( $_REQUEST[ "quick-search-posttype-{$post_type_name}" ] ) ) {
571 $current_tab = 'search';
572 }
573
574 $removed_args = array(
575 'action',
576 'customlink-tab',
577 'edit-menu-item',
578 'menu-item',
579 'page-tab',
580 '_wpnonce',
581 );
582
583 $most_recent_url = '';
584 $view_all_url = '';
585 $search_url = '';
586
587 if ( $nav_menu_selected_id ) {
588 $most_recent_url = add_query_arg( $tab_name, 'most-recent', remove_query_arg( $removed_args ) );
589 $view_all_url = add_query_arg( $tab_name, 'all', remove_query_arg( $removed_args ) );
590 $search_url = add_query_arg( $tab_name, 'search', remove_query_arg( $removed_args ) );
591 }
592 ?>
593 <div id="<?php echo esc_attr( "posttype-{$post_type_name}" ); ?>" class="posttypediv">
594 <ul id="<?php echo esc_attr( "posttype-{$post_type_name}-tabs" ); ?>" class="posttype-tabs add-menu-item-tabs">
595 <li <?php echo ( 'most-recent' === $current_tab ? ' class="tabs"' : '' ); ?>>
596 <a class="nav-tab-link"
597 data-type="<?php echo esc_attr( "tabs-panel-posttype-{$post_type_name}-most-recent" ); ?>"
598 href="<?php echo esc_url( $most_recent_url . "#tabs-panel-posttype-{$post_type_name}-most-recent" ); ?>"
599 >
600 <?php _e( 'Most Recent' ); ?>
601 </a>
602 </li>
603 <li <?php echo ( 'all' === $current_tab ? ' class="tabs"' : '' ); ?>>
604 <a class="nav-tab-link"
605 data-type="<?php echo esc_attr( "{$post_type_name}-all" ); ?>"
606 href="<?php echo esc_url( $view_all_url . "#{$post_type_name}-all" ); ?>"
607 >
608 <?php _e( 'View All' ); ?>
609 </a>
610 </li>
611 <li <?php echo ( 'search' === $current_tab ? ' class="tabs"' : '' ); ?>>
612 <a class="nav-tab-link"
613 data-type="<?php echo esc_attr( "tabs-panel-posttype-{$post_type_name}-search" ); ?>"
614 href="<?php echo esc_url( $search_url . "#tabs-panel-posttype-{$post_type_name}-search" ); ?>"
615 >
616 <?php _e( 'Search' ); ?>
617 </a>
618 </li>
619 </ul><!-- .posttype-tabs -->
620
621 <div id="<?php echo esc_attr( "tabs-panel-posttype-{$post_type_name}-most-recent" ); ?>"
622 class="tabs-panel <?php echo ( 'most-recent' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?>"
623 role="region" aria-label="<?php esc_attr_e( 'Most Recent' ); ?>" tabindex="0"
624 >
625 <ul id="<?php echo esc_attr( "{$post_type_name}checklist-most-recent" ); ?>"
626 class="categorychecklist form-no-clear"
627 >
628 <?php
629 $recent_args = array_merge(
630 $args,
631 array(
632 'orderby' => 'post_date',
633 'order' => 'DESC',
634 'posts_per_page' => 15,
635 )
636 );
637 $most_recent = $get_posts->query( $recent_args );
638
639 $args['walker'] = $walker;
640
641 /**
642 * Filters the posts displayed in the 'Most Recent' tab of the current
643 * post type's menu items meta box.
644 *
645 * The dynamic portion of the hook name, `$post_type_name`, refers to the post type name.
646 *
647 * Possible hook names include:
648 *
649 * - `nav_menu_items_post_recent`
650 * - `nav_menu_items_page_recent`
651 *
652 * @since 4.3.0
653 * @since 4.9.0 Added the `$recent_args` parameter.
654 *
655 * @param WP_Post[] $most_recent An array of post objects being listed.
656 * @param array $args An array of `WP_Query` arguments for the meta box.
657 * @param array $box Arguments passed to `wp_nav_menu_item_post_type_meta_box()`.
658 * @param array $recent_args An array of `WP_Query` arguments for 'Most Recent' tab.
659 */
660 $most_recent = apply_filters(
661 "nav_menu_items_{$post_type_name}_recent",
662 $most_recent,
663 $args,
664 $box,
665 $recent_args
666 );
667
668 echo walk_nav_menu_tree(
669 array_map( 'wp_setup_nav_menu_item', $most_recent ),
670 0,
671 (object) $args
672 );
673 ?>
674 </ul>
675 </div><!-- /.tabs-panel -->
676
677 <div id="<?php echo esc_attr( "tabs-panel-posttype-{$post_type_name}-search" ); ?>"
678 class="tabs-panel <?php echo ( 'search' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?>"
679 role="region" aria-label="<?php echo esc_attr( $post_type->labels->search_items ); ?>" tabindex="0"
680 >
681 <?php
682 if ( isset( $_REQUEST[ "quick-search-posttype-{$post_type_name}" ] ) ) {
683 $searched = esc_attr( $_REQUEST[ "quick-search-posttype-{$post_type_name}" ] );
684 $search_results = get_posts(
685 array(
686 's' => $searched,
687 'post_type' => $post_type_name,
688 'fields' => 'all',
689 'order' => 'DESC',
690 )
691 );
692 } else {
693 $searched = '';
694 $search_results = array();
695 }
696 ?>
697 <p class="quick-search-wrap">
698 <label for="<?php echo esc_attr( "quick-search-posttype-{$post_type_name}" ); ?>" class="screen-reader-text">
699 <?php
700 /* translators: Hidden accessibility text. */
701 _e( 'Search' );
702 ?>
703 </label>
704 <input type="search"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?>
705 class="quick-search" value="<?php echo $searched; ?>"
706 name="<?php echo esc_attr( "quick-search-posttype-{$post_type_name}" ); ?>"
707 id="<?php echo esc_attr( "quick-search-posttype-{$post_type_name}" ); ?>"
708 />
709 <span class="spinner"></span>
710 <?php
711 submit_button(
712 __( 'Search' ),
713 'small quick-search-submit hide-if-js',
714 'submit',
715 false,
716 array( 'id' => "submit-quick-search-posttype-{$post_type_name}" )
717 );
718 ?>
719 </p>
720
721 <ul id="<?php echo esc_attr( "{$post_type_name}-search-checklist" ); ?>"
722 data-wp-lists="<?php echo esc_attr( "list:{$post_type_name}" ); ?>"
723 class="categorychecklist form-no-clear"
724 >
725 <?php if ( ! empty( $search_results ) && ! is_wp_error( $search_results ) ) : ?>
726 <?php
727 $args['walker'] = $walker;
728 echo walk_nav_menu_tree(
729 array_map( 'wp_setup_nav_menu_item', $search_results ),
730 0,
731 (object) $args
732 );
733 ?>
734 <?php elseif ( is_wp_error( $search_results ) ) : ?>
735 <li><?php echo $search_results->get_error_message(); ?></li>
736 <?php elseif ( ! empty( $searched ) ) : ?>
737 <li><?php _e( 'No results found.' ); ?></li>
738 <?php endif; ?>
739 </ul>
740 </div><!-- /.tabs-panel -->
741
742 <div id="<?php echo esc_attr( "{$post_type_name}-all" ); ?>"
743 class="tabs-panel tabs-panel-view-all <?php echo ( 'all' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?>"
744 role="region" aria-label="<?php echo esc_attr( $post_type->labels->all_items ); ?>" tabindex="0"
745 >
746 <?php if ( ! empty( $page_links ) ) : ?>
747 <div class="add-menu-item-pagelinks">
748 <?php echo $page_links; ?>
749 </div>
750 <?php endif; ?>
751
752 <ul id="<?php echo esc_attr( "{$post_type_name}checklist" ); ?>"
753 data-wp-lists="<?php echo esc_attr( "list:{$post_type_name}" ); ?>"
754 class="categorychecklist form-no-clear"
755 >
756 <?php
757 $args['walker'] = $walker;
758
759 if ( $post_type->has_archive ) {
760 $_nav_menu_placeholder = ( 0 > $_nav_menu_placeholder ) ? (int) $_nav_menu_placeholder - 1 : -1;
761 array_unshift(
762 $posts,
763 (object) array(
764 'ID' => 0,
765 'object_id' => $_nav_menu_placeholder,
766 'object' => $post_type_name,
767 'post_content' => '',
768 'post_excerpt' => '',
769 'post_title' => $post_type->labels->archives,
770 'post_type' => 'nav_menu_item',
771 'type' => 'post_type_archive',
772 'url' => get_post_type_archive_link( $post_type_name ),
773 )
774 );
775 }
776
777 /**
778 * Filters the posts displayed in the 'View All' tab of the current
779 * post type's menu items meta box.
780 *
781 * The dynamic portion of the hook name, `$post_type_name`, refers
782 * to the slug of the current post type.
783 *
784 * Possible hook names include:
785 *
786 * - `nav_menu_items_post`
787 * - `nav_menu_items_page`
788 *
789 * @since 3.2.0
790 * @since 4.6.0 Converted the `$post_type` parameter to accept a WP_Post_Type object.
791 *
792 * @see WP_Query::query()
793 *
794 * @param object[] $posts The posts for the current post type. Mostly `WP_Post` objects, but
795 * can also contain "fake" post objects to represent other menu items.
796 * @param array $args An array of `WP_Query` arguments.
797 * @param WP_Post_Type $post_type The current post type object for this menu item meta box.
798 */
799 $posts = apply_filters(
800 "nav_menu_items_{$post_type_name}",
801 $posts,
802 $args,
803 $post_type
804 );
805
806 $checkbox_items = walk_nav_menu_tree(
807 array_map( 'wp_setup_nav_menu_item', $posts ),
808 0,
809 (object) $args
810 );
811
812 echo $checkbox_items;
813 ?>
814 </ul>
815
816 <?php if ( ! empty( $page_links ) ) : ?>
817 <div class="add-menu-item-pagelinks">
818 <?php echo $page_links; ?>
819 </div>
820 <?php endif; ?>
821 </div><!-- /.tabs-panel -->
822
823 <p class="button-controls wp-clearfix" data-items-type="<?php echo esc_attr( "posttype-{$post_type_name}" ); ?>">
824 <span class="list-controls hide-if-no-js">
825 <input type="checkbox"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?>
826 id="<?php echo esc_attr( $tab_name ); ?>" class="select-all"
827 />
828 <label for="<?php echo esc_attr( $tab_name ); ?>"><?php _e( 'Select All' ); ?></label>
829 </span>
830
831 <span class="add-to-menu">
832 <input type="submit"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?>
833 class="button submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu' ); ?>"
834 name="add-post-type-menu-item" id="<?php echo esc_attr( "submit-posttype-{$post_type_name}" ); ?>"
835 />
836 <span class="spinner"></span>
837 </span>
838 </p>
839
840 </div><!-- /.posttypediv -->
841 <?php
842}
843
844/**
845 * Displays a meta box for a taxonomy menu item.
846 *
847 * @since 3.0.0
848 *
849 * @global int|string $nav_menu_selected_id
850 *
851 * @param string $data_object Not used.
852 * @param array $box {
853 * Taxonomy menu item meta box arguments.
854 *
855 * @type string $id Meta box 'id' attribute.
856 * @type string $title Meta box title.
857 * @type callable $callback Meta box display callback.
858 * @type object $args Extra meta box arguments (the taxonomy object for this meta box).
859 * }
860 */
861function wp_nav_menu_item_taxonomy_meta_box( $data_object, $box ) {
862 global $nav_menu_selected_id;
863
864 $taxonomy_name = $box['args']->name;
865 $taxonomy = get_taxonomy( $taxonomy_name );
866 $tab_name = $taxonomy_name . '-tab';
867
868 // Paginate browsing for large numbers of objects.
869 $per_page = 50;
870 $pagenum = isset( $_REQUEST[ $tab_name ] ) && isset( $_REQUEST['paged'] ) ? absint( $_REQUEST['paged'] ) : 1;
871 $offset = 0 < $pagenum ? $per_page * ( $pagenum - 1 ) : 0;
872
873 $args = array(
874 'taxonomy' => $taxonomy_name,
875 'child_of' => 0,
876 'exclude' => '',
877 'hide_empty' => false,
878 'hierarchical' => 1,
879 'include' => '',
880 'number' => $per_page,
881 'offset' => $offset,
882 'order' => 'ASC',
883 'orderby' => 'name',
884 'pad_counts' => false,
885 );
886
887 $terms = get_terms( $args );
888
889 if ( ! $terms || is_wp_error( $terms ) ) {
890 echo '<p>' . __( 'No items.' ) . '</p>';
891 return;
892 }
893
894 $num_pages = (int) ceil(
895 (int) wp_count_terms(
896 array_merge(
897 $args,
898 array(
899 'number' => '',
900 'offset' => '',
901 )
902 )
903 ) / $per_page
904 );
905
906 $page_links = paginate_links(
907 array(
908 'base' => add_query_arg(
909 array(
910 $tab_name => 'all',
911 'paged' => '%#%',
912 'item-type' => 'taxonomy',
913 'item-object' => $taxonomy_name,
914 )
915 ),
916 'format' => '',
917 'prev_text' => '<span aria-label="' . esc_attr__( 'Previous page' ) . '">' . __( '«' ) . '</span>',
918 'next_text' => '<span aria-label="' . esc_attr__( 'Next page' ) . '">' . __( '»' ) . '</span>',
919 /* translators: Hidden accessibility text. */
920 'before_page_number' => '<span class="screen-reader-text">' . __( 'Page' ) . '</span> ',
921 'total' => $num_pages,
922 'current' => $pagenum,
923 )
924 );
925
926 $db_fields = false;
927 if ( is_taxonomy_hierarchical( $taxonomy_name ) ) {
928 $db_fields = array(
929 'parent' => 'parent',
930 'id' => 'term_id',
931 );
932 }
933
934 $walker = new Walker_Nav_Menu_Checklist( $db_fields );
935
936 $current_tab = 'most-used';
937
938 if ( isset( $_REQUEST[ $tab_name ] ) && in_array( $_REQUEST[ $tab_name ], array( 'all', 'most-used', 'search' ), true ) ) {
939 $current_tab = $_REQUEST[ $tab_name ];
940 }
941
942 if ( ! empty( $_REQUEST[ "quick-search-taxonomy-{$taxonomy_name}" ] ) ) {
943 $current_tab = 'search';
944 }
945
946 $removed_args = array(
947 'action',
948 'customlink-tab',
949 'edit-menu-item',
950 'menu-item',
951 'page-tab',
952 '_wpnonce',
953 );
954
955 $most_used_url = '';
956 $view_all_url = '';
957 $search_url = '';
958
959 if ( $nav_menu_selected_id ) {
960 $most_used_url = add_query_arg( $tab_name, 'most-used', remove_query_arg( $removed_args ) );
961 $view_all_url = add_query_arg( $tab_name, 'all', remove_query_arg( $removed_args ) );
962 $search_url = add_query_arg( $tab_name, 'search', remove_query_arg( $removed_args ) );
963 }
964 ?>
965 <div id="<?php echo esc_attr( "taxonomy-{$taxonomy_name}" ); ?>" class="taxonomydiv">
966 <ul id="<?php echo esc_attr( "taxonomy-{$taxonomy_name}-tabs" ); ?>" class="taxonomy-tabs add-menu-item-tabs">
967 <li <?php echo ( 'most-used' === $current_tab ? ' class="tabs"' : '' ); ?>>
968 <a class="nav-tab-link"
969 data-type="<?php echo esc_attr( "tabs-panel-{$taxonomy_name}-pop" ); ?>"
970 href="<?php echo esc_url( $most_used_url . "#tabs-panel-{$taxonomy_name}-pop" ); ?>"
971 >
972 <?php echo esc_html( $taxonomy->labels->most_used ); ?>
973 </a>
974 </li>
975 <li <?php echo ( 'all' === $current_tab ? ' class="tabs"' : '' ); ?>>
976 <a class="nav-tab-link"
977 data-type="<?php echo esc_attr( "tabs-panel-{$taxonomy_name}-all" ); ?>"
978 href="<?php echo esc_url( $view_all_url . "#tabs-panel-{$taxonomy_name}-all" ); ?>"
979 >
980 <?php _e( 'View All' ); ?>
981 </a>
982 </li>
983 <li <?php echo ( 'search' === $current_tab ? ' class="tabs"' : '' ); ?>>
984 <a class="nav-tab-link"
985 data-type="<?php echo esc_attr( "tabs-panel-search-taxonomy-{$taxonomy_name}" ); ?>"
986 href="<?php echo esc_url( $search_url . "#tabs-panel-search-taxonomy-{$taxonomy_name}" ); ?>"
987 >
988 <?php _e( 'Search' ); ?>
989 </a>
990 </li>
991 </ul><!-- .taxonomy-tabs -->
992
993 <div id="<?php echo esc_attr( "tabs-panel-{$taxonomy_name}-pop" ); ?>"
994 class="tabs-panel <?php echo ( 'most-used' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?>"
995 role="region" aria-label="<?php echo esc_attr( $taxonomy->labels->most_used ); ?>" tabindex="0"
996 >
997 <ul id="<?php echo esc_attr( "{$taxonomy_name}checklist-pop" ); ?>"
998 class="categorychecklist form-no-clear"
999 >
1000 <?php
1001 $popular_terms = get_terms(
1002 array(
1003 'taxonomy' => $taxonomy_name,
1004 'orderby' => 'count',
1005 'order' => 'DESC',
1006 'number' => 10,
1007 'hierarchical' => false,
1008 )
1009 );
1010
1011 $args['walker'] = $walker;
1012 echo walk_nav_menu_tree(
1013 array_map( 'wp_setup_nav_menu_item', $popular_terms ),
1014 0,
1015 (object) $args
1016 );
1017 ?>
1018 </ul>
1019 </div><!-- /.tabs-panel -->
1020
1021 <div id="<?php echo esc_attr( "tabs-panel-{$taxonomy_name}-all" ); ?>"
1022 class="tabs-panel tabs-panel-view-all <?php echo ( 'all' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?>"
1023 role="region" aria-label="<?php echo esc_attr( $taxonomy->labels->all_items ); ?>" tabindex="0"
1024 >
1025 <?php if ( ! empty( $page_links ) ) : ?>
1026 <div class="add-menu-item-pagelinks">
1027 <?php echo $page_links; ?>
1028 </div>
1029 <?php endif; ?>
1030
1031 <ul id="<?php echo esc_attr( "{$taxonomy_name}checklist" ); ?>"
1032 data-wp-lists="<?php echo esc_attr( "list:{$taxonomy_name}" ); ?>"
1033 class="categorychecklist form-no-clear"
1034 >
1035 <?php
1036 $args['walker'] = $walker;
1037 echo walk_nav_menu_tree(
1038 array_map( 'wp_setup_nav_menu_item', $terms ),
1039 0,
1040 (object) $args
1041 );
1042 ?>
1043 </ul>
1044
1045 <?php if ( ! empty( $page_links ) ) : ?>
1046 <div class="add-menu-item-pagelinks">
1047 <?php echo $page_links; ?>
1048 </div>
1049 <?php endif; ?>
1050 </div><!-- /.tabs-panel -->
1051
1052 <div id="<?php echo esc_attr( "tabs-panel-search-taxonomy-{$taxonomy_name}" ); ?>"
1053 class="tabs-panel <?php echo ( 'search' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?>"
1054 role="region" aria-label="<?php echo esc_attr( $taxonomy->labels->search_items ); ?>" tabindex="0">
1055 <?php
1056 if ( isset( $_REQUEST[ "quick-search-taxonomy-{$taxonomy_name}" ] ) ) {
1057 $searched = esc_attr( $_REQUEST[ "quick-search-taxonomy-{$taxonomy_name}" ] );
1058 $search_results = get_terms(
1059 array(
1060 'taxonomy' => $taxonomy_name,
1061 'name__like' => $searched,
1062 'fields' => 'all',
1063 'orderby' => 'count',
1064 'order' => 'DESC',
1065 'hierarchical' => false,
1066 )
1067 );
1068 } else {
1069 $searched = '';
1070 $search_results = array();
1071 }
1072 ?>
1073 <p class="quick-search-wrap">
1074 <label for="<?php echo esc_attr( "quick-search-taxonomy-{$taxonomy_name}" ); ?>" class="screen-reader-text">
1075 <?php
1076 /* translators: Hidden accessibility text. */
1077 _e( 'Search' );
1078 ?>
1079 </label>
1080 <input type="search"
1081 class="quick-search" value="<?php echo $searched; ?>"
1082 name="<?php echo esc_attr( "quick-search-taxonomy-{$taxonomy_name}" ); ?>"
1083 id="<?php echo esc_attr( "quick-search-taxonomy-{$taxonomy_name}" ); ?>"
1084 />
1085 <span class="spinner"></span>
1086 <?php
1087 submit_button(
1088 __( 'Search' ),
1089 'small quick-search-submit hide-if-js',
1090 'submit',
1091 false,
1092 array( 'id' => "submit-quick-search-taxonomy-{$taxonomy_name}" )
1093 );
1094 ?>
1095 </p>
1096
1097 <ul id="<?php echo esc_attr( "{$taxonomy_name}-search-checklist" ); ?>"
1098 data-wp-lists="<?php echo esc_attr( "list:{$taxonomy_name}" ); ?>"
1099 class="categorychecklist form-no-clear"
1100 >
1101 <?php if ( ! empty( $search_results ) && ! is_wp_error( $search_results ) ) : ?>
1102 <?php
1103 $args['walker'] = $walker;
1104 echo walk_nav_menu_tree(
1105 array_map( 'wp_setup_nav_menu_item', $search_results ),
1106 0,
1107 (object) $args
1108 );
1109 ?>
1110 <?php elseif ( is_wp_error( $search_results ) ) : ?>
1111 <li><?php echo $search_results->get_error_message(); ?></li>
1112 <?php elseif ( ! empty( $searched ) ) : ?>
1113 <li><?php _e( 'No results found.' ); ?></li>
1114 <?php endif; ?>
1115 </ul>
1116 </div><!-- /.tabs-panel -->
1117
1118 <p class="button-controls wp-clearfix" data-items-type="<?php echo esc_attr( "taxonomy-{$taxonomy_name}" ); ?>">
1119 <span class="list-controls hide-if-no-js">
1120 <input type="checkbox"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?>
1121 id="<?php echo esc_attr( $tab_name ); ?>" class="select-all"
1122 />
1123 <label for="<?php echo esc_attr( $tab_name ); ?>"><?php _e( 'Select All' ); ?></label>
1124 </span>
1125
1126 <span class="add-to-menu">
1127 <input type="submit"<?php wp_nav_menu_disabled_check( $nav_menu_selected_id ); ?>
1128 class="button submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu' ); ?>"
1129 name="add-taxonomy-menu-item" id="<?php echo esc_attr( "submit-taxonomy-{$taxonomy_name}" ); ?>"
1130 />
1131 <span class="spinner"></span>
1132 </span>
1133 </p>
1134
1135 </div><!-- /.taxonomydiv -->
1136 <?php
1137}
1138
1139/**
1140 * Save posted nav menu item data.
1141 *
1142 * @since 3.0.0
1143 *
1144 * @param int $menu_id The menu ID for which to save this item. Value of 0 makes a draft, orphaned menu item. Default 0.
1145 * @param array[] $menu_data The unsanitized POSTed menu item data.
1146 * @return int[] The database IDs of the items saved
1147 */
1148function wp_save_nav_menu_items( $menu_id = 0, $menu_data = array() ) {
1149 $menu_id = (int) $menu_id;
1150 $items_saved = array();
1151
1152 if ( 0 === $menu_id || is_nav_menu( $menu_id ) ) {
1153
1154 // Loop through all the menu items' POST values.
1155 foreach ( (array) $menu_data as $_possible_db_id => $_item_object_data ) {
1156 if (
1157 // Checkbox is not checked.
1158 empty( $_item_object_data['menu-item-object-id'] ) &&
1159 (
1160 // And item type either isn't set.
1161 ! isset( $_item_object_data['menu-item-type'] ) ||
1162 // Or URL is the default.
1163 in_array( $_item_object_data['menu-item-url'], array( 'https://', 'http://', '' ), true ) ||
1164 // Or it's not a custom menu item (but not the custom home page).
1165 ! ( 'custom' === $_item_object_data['menu-item-type'] && ! isset( $_item_object_data['menu-item-db-id'] ) ) ||
1166 // Or it *is* a custom menu item that already exists.
1167 ! empty( $_item_object_data['menu-item-db-id'] )
1168 )
1169 ) {
1170 // Then this potential menu item is not getting added to this menu.
1171 continue;
1172 }
1173
1174 // If this possible menu item doesn't actually have a menu database ID yet.
1175 if (
1176 empty( $_item_object_data['menu-item-db-id'] ) ||
1177 ( 0 > $_possible_db_id ) ||
1178 $_possible_db_id !== (int) $_item_object_data['menu-item-db-id']
1179 ) {
1180 $_actual_db_id = 0;
1181 } else {
1182 $_actual_db_id = (int) $_item_object_data['menu-item-db-id'];
1183 }
1184
1185 $args = array(
1186 'menu-item-db-id' => ( isset( $_item_object_data['menu-item-db-id'] ) ? $_item_object_data['menu-item-db-id'] : '' ),
1187 'menu-item-object-id' => ( isset( $_item_object_data['menu-item-object-id'] ) ? $_item_object_data['menu-item-object-id'] : '' ),
1188 'menu-item-object' => ( isset( $_item_object_data['menu-item-object'] ) ? $_item_object_data['menu-item-object'] : '' ),
1189 'menu-item-parent-id' => ( isset( $_item_object_data['menu-item-parent-id'] ) ? $_item_object_data['menu-item-parent-id'] : '' ),
1190 'menu-item-position' => ( isset( $_item_object_data['menu-item-position'] ) ? $_item_object_data['menu-item-position'] : '' ),
1191 'menu-item-type' => ( isset( $_item_object_data['menu-item-type'] ) ? $_item_object_data['menu-item-type'] : '' ),
1192 'menu-item-title' => ( isset( $_item_object_data['menu-item-title'] ) ? $_item_object_data['menu-item-title'] : '' ),
1193 'menu-item-url' => ( isset( $_item_object_data['menu-item-url'] ) ? $_item_object_data['menu-item-url'] : '' ),
1194 'menu-item-description' => ( isset( $_item_object_data['menu-item-description'] ) ? $_item_object_data['menu-item-description'] : '' ),
1195 'menu-item-attr-title' => ( isset( $_item_object_data['menu-item-attr-title'] ) ? $_item_object_data['menu-item-attr-title'] : '' ),
1196 'menu-item-target' => ( isset( $_item_object_data['menu-item-target'] ) ? $_item_object_data['menu-item-target'] : '' ),
1197 'menu-item-classes' => ( isset( $_item_object_data['menu-item-classes'] ) ? $_item_object_data['menu-item-classes'] : '' ),
1198 'menu-item-xfn' => ( isset( $_item_object_data['menu-item-xfn'] ) ? $_item_object_data['menu-item-xfn'] : '' ),
1199 );
1200
1201 $items_saved[] = wp_update_nav_menu_item( $menu_id, $_actual_db_id, $args );
1202
1203 }
1204 }
1205
1206 return $items_saved;
1207}
1208
1209/**
1210 * Adds custom arguments to some of the meta box object types.
1211 *
1212 * @since 3.0.0
1213 *
1214 * @access private
1215 *
1216 * @param object $data_object The post type or taxonomy meta-object.
1217 * @return object The post type or taxonomy object.
1218 */
1219function _wp_nav_menu_meta_box_object( $data_object = null ) {
1220 if ( isset( $data_object->name ) ) {
1221
1222 if ( 'page' === $data_object->name ) {
1223 $data_object->_default_query = array(
1224 'orderby' => 'menu_order title',
1225 'post_status' => 'publish',
1226 );
1227
1228 // Posts should show only published items.
1229 } elseif ( 'post' === $data_object->name ) {
1230 $data_object->_default_query = array(
1231 'post_status' => 'publish',
1232 );
1233
1234 // Categories should be in reverse chronological order.
1235 } elseif ( 'category' === $data_object->name ) {
1236 $data_object->_default_query = array(
1237 'orderby' => 'id',
1238 'order' => 'DESC',
1239 );
1240
1241 // Custom post types should show only published items.
1242 } else {
1243 $data_object->_default_query = array(
1244 'post_status' => 'publish',
1245 );
1246 }
1247 }
1248
1249 return $data_object;
1250}
1251
1252/**
1253 * Returns the menu formatted to edit.
1254 *
1255 * @since 3.0.0
1256 *
1257 * @param int $menu_id Optional. The ID of the menu to format. Default 0.
1258 * @return string|WP_Error|null The menu formatted to edit or error object on failure.
1259 * Null if the `$menu_id` parameter is not supplied or the term does not exist.
1260 */
1261function wp_get_nav_menu_to_edit( $menu_id = 0 ) {
1262 $menu = wp_get_nav_menu_object( $menu_id );
1263
1264 // If the menu exists, get its items.
1265 if ( is_nav_menu( $menu ) ) {
1266 $menu_items = wp_get_nav_menu_items( $menu->term_id, array( 'post_status' => 'any' ) );
1267 $result = '<div id="menu-instructions" class="post-body-plain';
1268 $result .= ( ! empty( $menu_items ) ) ? ' menu-instructions-inactive">' : '">';
1269 $result .= '<p>' . __( 'Add menu items from the column on the left.' ) . '</p>';
1270 $result .= '</div>';
1271
1272 if ( empty( $menu_items ) ) {
1273 return $result . ' <ul class="menu" id="menu-to-edit"> </ul>';
1274 }
1275
1276 /**
1277 * Filters the Walker class used when adding nav menu items.
1278 *
1279 * @since 3.0.0
1280 *
1281 * @param string $class The walker class to use. Default 'Walker_Nav_Menu_Edit'.
1282 * @param int $menu_id ID of the menu being rendered.
1283 */
1284 $walker_class_name = apply_filters( 'wp_edit_nav_menu_walker', 'Walker_Nav_Menu_Edit', $menu_id );
1285
1286 if ( class_exists( $walker_class_name ) ) {
1287 $walker = new $walker_class_name();
1288 } else {
1289 return new WP_Error(
1290 'menu_walker_not_exist',
1291 sprintf(
1292 /* translators: %s: Walker class name. */
1293 __( 'The Walker class named %s does not exist.' ),
1294 '<strong>' . $walker_class_name . '</strong>'
1295 )
1296 );
1297 }
1298
1299 $some_pending_menu_items = false;
1300 $some_invalid_menu_items = false;
1301
1302 foreach ( (array) $menu_items as $menu_item ) {
1303 if ( isset( $menu_item->post_status ) && 'draft' === $menu_item->post_status ) {
1304 $some_pending_menu_items = true;
1305 }
1306 if ( ! empty( $menu_item->_invalid ) ) {
1307 $some_invalid_menu_items = true;
1308 }
1309 }
1310
1311 if ( $some_pending_menu_items ) {
1312 $message = __( 'Click Save Menu to make pending menu items public.' );
1313 $notice_args = array(
1314 'type' => 'info',
1315 'additional_classes' => array( 'notice-alt', 'inline' ),
1316 );
1317 $result .= wp_get_admin_notice( $message, $notice_args );
1318 }
1319
1320 if ( $some_invalid_menu_items ) {
1321 $message = __( 'There are some invalid menu items. Please check or delete them.' );
1322 $notice_args = array(
1323 'type' => 'error',
1324 'additional_classes' => array( 'notice-alt', 'inline' ),
1325 );
1326 $result .= wp_get_admin_notice( $message, $notice_args );
1327 }
1328
1329 $result .= '<ul class="menu" id="menu-to-edit"> ';
1330 $result .= walk_nav_menu_tree(
1331 array_map( 'wp_setup_nav_menu_item', $menu_items ),
1332 0,
1333 (object) array( 'walker' => $walker )
1334 );
1335 $result .= ' </ul> ';
1336
1337 return $result;
1338 } elseif ( is_wp_error( $menu ) ) {
1339 return $menu;
1340 }
1341
1342 return null;
1343}
1344
1345/**
1346 * Returns the columns for the nav menus page.
1347 *
1348 * @since 3.0.0
1349 *
1350 * @return string[] Array of column titles keyed by their column name.
1351 */
1352function wp_nav_menu_manage_columns() {
1353 return array(
1354 '_title' => __( 'Show advanced menu properties' ),
1355 'cb' => '<input type="checkbox" />',
1356 'link-target' => __( 'Link Target' ),
1357 'title-attribute' => __( 'Title Attribute' ),
1358 'css-classes' => __( 'CSS Classes' ),
1359 'xfn' => __( 'Link Relationship (XFN)' ),
1360 'description' => __( 'Description' ),
1361 );
1362}
1363
1364/**
1365 * Deletes orphaned draft menu items
1366 *
1367 * @access private
1368 * @since 3.0.0
1369 *
1370 * @global wpdb $wpdb WordPress database abstraction object.
1371 */
1372function _wp_delete_orphaned_draft_menu_items() {
1373 global $wpdb;
1374
1375 $delete_timestamp = time() - ( DAY_IN_SECONDS * EMPTY_TRASH_DAYS );
1376
1377 // Delete orphaned draft menu items.
1378 $menu_items_to_delete = $wpdb->get_col(
1379 $wpdb->prepare(
1380 "SELECT ID FROM $wpdb->posts AS p
1381 LEFT JOIN $wpdb->postmeta AS m ON p.ID = m.post_id
1382 WHERE post_type = 'nav_menu_item' AND post_status = 'draft'
1383 AND meta_key = '_menu_item_orphaned' AND meta_value < %d",
1384 $delete_timestamp
1385 )
1386 );
1387
1388 foreach ( (array) $menu_items_to_delete as $menu_item_id ) {
1389 wp_delete_post( $menu_item_id, true );
1390 }
1391}
1392
1393/**
1394 * Saves nav menu items.
1395 *
1396 * @since 3.6.0
1397 *
1398 * @param int|string $nav_menu_selected_id ID, slug, or name of the currently-selected menu.
1399 * @param string $nav_menu_selected_title Title of the currently-selected menu.
1400 * @return string[] The menu updated messages.
1401 */
1402function wp_nav_menu_update_menu_items( $nav_menu_selected_id, $nav_menu_selected_title ) {
1403 $unsorted_menu_items = wp_get_nav_menu_items(
1404 $nav_menu_selected_id,
1405 array(
1406 'orderby' => 'ID',
1407 'output' => ARRAY_A,
1408 'output_key' => 'ID',
1409 'post_status' => 'draft,publish',
1410 )
1411 );
1412
1413 $messages = array();
1414 $menu_items = array();
1415
1416 // Index menu items by DB ID.
1417 foreach ( $unsorted_menu_items as $_item ) {
1418 $menu_items[ $_item->db_id ] = $_item;
1419 }
1420
1421 $post_fields = array(
1422 'menu-item-db-id',
1423 'menu-item-object-id',
1424 'menu-item-object',
1425 'menu-item-parent-id',
1426 'menu-item-position',
1427 'menu-item-type',
1428 'menu-item-title',
1429 'menu-item-url',
1430 'menu-item-description',
1431 'menu-item-attr-title',
1432 'menu-item-target',
1433 'menu-item-classes',
1434 'menu-item-xfn',
1435 );
1436
1437 wp_defer_term_counting( true );
1438
1439 // Loop through all the menu items' POST variables.
1440 if ( ! empty( $_POST['menu-item-db-id'] ) ) {
1441 foreach ( (array) $_POST['menu-item-db-id'] as $_key => $k ) {
1442
1443 // Menu item title can't be blank.
1444 if ( ! isset( $_POST['menu-item-title'][ $_key ] ) || '' === $_POST['menu-item-title'][ $_key ] ) {
1445 continue;
1446 }
1447
1448 $args = array();
1449 foreach ( $post_fields as $field ) {
1450 $args[ $field ] = isset( $_POST[ $field ][ $_key ] ) ? $_POST[ $field ][ $_key ] : '';
1451 }
1452
1453 $menu_item_db_id = wp_update_nav_menu_item(
1454 $nav_menu_selected_id,
1455 ( (int) $_POST['menu-item-db-id'][ $_key ] !== $_key ? 0 : $_key ),
1456 $args
1457 );
1458
1459 if ( is_wp_error( $menu_item_db_id ) ) {
1460 $messages[] = wp_get_admin_notice(
1461 $menu_item_db_id->get_error_message(),
1462 array(
1463 'id' => 'message',
1464 'additional_classes' => array( 'error' ),
1465 )
1466 );
1467 } else {
1468 unset( $menu_items[ $menu_item_db_id ] );
1469 }
1470 }
1471 }
1472
1473 // Remove menu items from the menu that weren't in $_POST.
1474 if ( ! empty( $menu_items ) ) {
1475 foreach ( array_keys( $menu_items ) as $menu_item_id ) {
1476 if ( is_nav_menu_item( $menu_item_id ) ) {
1477 wp_delete_post( $menu_item_id );
1478 }
1479 }
1480 }
1481
1482 // Store 'auto-add' pages.
1483 $auto_add = ! empty( $_POST['auto-add-pages'] );
1484 $nav_menu_option = (array) get_option( 'nav_menu_options' );
1485
1486 if ( ! isset( $nav_menu_option['auto_add'] ) ) {
1487 $nav_menu_option['auto_add'] = array();
1488 }
1489
1490 if ( $auto_add ) {
1491 if ( ! in_array( $nav_menu_selected_id, $nav_menu_option['auto_add'], true ) ) {
1492 $nav_menu_option['auto_add'][] = $nav_menu_selected_id;
1493 }
1494 } else {
1495 $key = array_search( $nav_menu_selected_id, $nav_menu_option['auto_add'], true );
1496 if ( false !== $key ) {
1497 unset( $nav_menu_option['auto_add'][ $key ] );
1498 }
1499 }
1500
1501 // Remove non-existent/deleted menus.
1502 $nav_menu_option['auto_add'] = array_intersect(
1503 $nav_menu_option['auto_add'],
1504 wp_get_nav_menus( array( 'fields' => 'ids' ) )
1505 );
1506
1507 update_option( 'nav_menu_options', $nav_menu_option, false );
1508
1509 wp_defer_term_counting( false );
1510
1511 /** This action is documented in wp-includes/nav-menu.php */
1512 do_action( 'wp_update_nav_menu', $nav_menu_selected_id );
1513
1514 /* translators: %s: Nav menu title. */
1515 $message = sprintf( __( '%s has been updated.' ), '<strong>' . $nav_menu_selected_title . '</strong>' );
1516 $notice_args = array(
1517 'id' => 'message',
1518 'dismissible' => true,
1519 'additional_classes' => array( 'updated' ),
1520 );
1521
1522 $messages[] = wp_get_admin_notice( $message, $notice_args );
1523
1524 unset( $menu_items, $unsorted_menu_items );
1525
1526 return $messages;
1527}
1528
1529/**
1530 * If a JSON blob of navigation menu data is in POST data, expand it and inject
1531 * it into `$_POST` to avoid PHP `max_input_vars` limitations. See #14134.
1532 *
1533 * @ignore
1534 * @since 4.5.3
1535 * @access private
1536 */
1537function _wp_expand_nav_menu_post_data() {
1538 if ( ! isset( $_POST['nav-menu-data'] ) ) {
1539 return;
1540 }
1541
1542 $data = json_decode( stripslashes( $_POST['nav-menu-data'] ) );
1543
1544 if ( ! is_null( $data ) && $data ) {
1545 foreach ( $data as $post_input_data ) {
1546 /*
1547 * For input names that are arrays (e.g. `menu-item-db-id[3][4][5]`),
1548 * derive the array path keys via regex and set the value in $_POST.
1549 */
1550 preg_match( '#([^\[]*)(\[(.+)\])?#', $post_input_data->name, $matches );
1551
1552 $array_bits = array( $matches[1] );
1553
1554 if ( isset( $matches[3] ) ) {
1555 $array_bits = array_merge( $array_bits, explode( '][', $matches[3] ) );
1556 }
1557
1558 $new_post_data = array();
1559
1560 // Build the new array value from leaf to trunk.
1561 for ( $i = count( $array_bits ) - 1; $i >= 0; $i-- ) {
1562 if ( count( $array_bits ) - 1 === $i ) {
1563 $new_post_data[ $array_bits[ $i ] ] = wp_slash( $post_input_data->value );
1564 } else {
1565 $new_post_data = array( $array_bits[ $i ] => $new_post_data );
1566 }
1567 }
1568
1569 $_POST = array_replace_recursive( $_POST, $new_post_data );
1570 }
1571 }
1572}
1573