[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

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'] ) ? $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   */
 186  function 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   */
 226  function 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   */
 257  function 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   */
 301  function 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   */
 339  function 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   */
 357  function 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   */
 414  function 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' ) . '">' . __( '&laquo;' ) . '</span>',
 546              'next_text'          => '<span aria-label="' . esc_attr__( 'Next page' ) . '">' . __( '&raquo;' ) . '</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   */
 861  function 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' ) . '">' . __( '&laquo;' ) . '</span>',
 918              'next_text'          => '<span aria-label="' . esc_attr__( 'Next page' ) . '">' . __( '&raquo;' ) . '</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   */
1148  function 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   */
1219  function _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   */
1261  function 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   */
1352  function 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   */
1372  function _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   */
1402  function 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   */
1537  function _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  }


Generated : Wed Oct 22 08:20:04 2025 Cross-referenced by PHPXref