[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-admin/includes/ -> nav-menu.php (source)

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


Generated: Fri Nov 22 01:00:04 2019 Cross-referenced by PHPXref 0.7.1