wp_nav_menu_item_taxonomy_meta_box

Displays a meta box for a taxonomy menu item.

Description

wp_nav_menu_item_taxonomy_meta_box( (string) $object, (array) $box ); 

Parameters (2)

0. $object (string)
The object.
1. $box (array)
Taxonomy menu item meta box arguments.

Options

  • id (string) => ''

    Meta box id attribute.

  • title (string) => ''

    Meta box title.

  • callback (string) => ''

    Meta box display callback.

array(

    /**
     * Meta box 'id' attribute.
     *
     * @type string
     * @default ''
     */
    'id' => '',

    /**
     * Meta box title.
     *
     * @type string
     * @default ''
     */
    'title' => '',

    /**
     * Meta box display callback.
     *
     * @type string
     * @default ''
     */
    'callback' => ''
);

…

Usage

  1. if ( !function_exists( 'wp_nav_menu_item_taxonomy_meta_box' ) ) { 
  2.     require_once ABSPATH . '/wp-admin/includes/nav-menu.php'; 
  3. } 
  4.   
  5. // The object. 
  6. $object = ''; 
  7.   
  8. // Taxonomy menu item meta box arguments. 
  9. $box = array( 
  10.     'id' => '', 
  11.     'title' => '', 
  12.     'callback' => '' 
  13. ); 
  14.   
  15. // NOTICE! Understand what this does before running. 
  16. $result = wp_nav_menu_item_taxonomy_meta_box($object, $box); 
  17.     

Defined (1)

The function is defined in the following location(s).

/wp-admin/includes/nav-menu.php  
  1. function wp_nav_menu_item_taxonomy_meta_box( $object, $box ) { 
  2.     global $nav_menu_selected_id; 
  3.     $taxonomy_name = $box['args']->name; 
  4.  
  5.     // Paginate browsing for large numbers of objects. 
  6.     $per_page = 50; 
  7.     $pagenum = isset( $_REQUEST[$taxonomy_name . '-tab'] ) && isset( $_REQUEST['paged'] ) ? absint( $_REQUEST['paged'] ) : 1; 
  8.     $offset = 0 < $pagenum ? $per_page * ( $pagenum - 1 ) : 0; 
  9.  
  10.     $args = array( 
  11.         'child_of' => 0,  
  12.         'exclude' => '',  
  13.         'hide_empty' => false,  
  14.         'hierarchical' => 1,  
  15.         'include' => '',  
  16.         'number' => $per_page,  
  17.         'offset' => $offset,  
  18.         'order' => 'ASC',  
  19.         'orderby' => 'name',  
  20.         'pad_counts' => false,  
  21.  ); 
  22.  
  23.     $terms = get_terms( $taxonomy_name, $args ); 
  24.  
  25.     if ( ! $terms || is_wp_error($terms) ) { 
  26.         echo '<p>' . __( 'No items.' ) . '</p>'; 
  27.         return; 
  28.     } 
  29.  
  30.     $num_pages = ceil( wp_count_terms( $taxonomy_name , array_merge( $args, array('number' => '', 'offset' => '') ) ) / $per_page ); 
  31.  
  32.     $page_links = paginate_links( array( 
  33.         'base' => add_query_arg( 
  34.             array( 
  35.                 $taxonomy_name . '-tab' => 'all',  
  36.                 'paged' => '%#%',  
  37.                 'item-type' => 'taxonomy',  
  38.                 'item-object' => $taxonomy_name,  
  39.  ) 
  40.  ),  
  41.         'format' => '',  
  42.         'prev_text' => '<span aria-label="' . esc_attr__( 'Previous page' ) . '">' . __( '«' ) . '</span>',  
  43.         'next_text' => '<span aria-label="' . esc_attr__( 'Next page' ) . '">' . __( '»' ) . '</span>',  
  44.         'before_page_number' => '<span class="screen-reader-text">' . __( 'Page' ) . '</span> ',  
  45.         'total' => $num_pages,  
  46.         'current' => $pagenum 
  47.  )); 
  48.  
  49.     $db_fields = false; 
  50.     if ( is_taxonomy_hierarchical( $taxonomy_name ) ) { 
  51.         $db_fields = array( 'parent' => 'parent', 'id' => 'term_id' ); 
  52.     } 
  53.  
  54.     $walker = new Walker_Nav_Menu_Checklist( $db_fields ); 
  55.  
  56.     $current_tab = 'most-used'; 
  57.     if ( isset( $_REQUEST[$taxonomy_name . '-tab'] ) && in_array( $_REQUEST[$taxonomy_name . '-tab'], array('all', 'most-used', 'search') ) ) { 
  58.         $current_tab = $_REQUEST[$taxonomy_name . '-tab']; 
  59.     } 
  60.  
  61.     if ( ! empty( $_REQUEST['quick-search-taxonomy-' . $taxonomy_name] ) ) { 
  62.         $current_tab = 'search'; 
  63.     } 
  64.  
  65.     $removed_args = array( 
  66.         'action',  
  67.         'customlink-tab',  
  68.         'edit-menu-item',  
  69.         'menu-item',  
  70.         'page-tab',  
  71.         '_wpnonce',  
  72.  ); 
  73.  
  74.     ?> 
  75.     <div id="taxonomy-<?php echo $taxonomy_name; ?>" class="taxonomydiv"> 
  76.         <ul id="taxonomy-<?php echo $taxonomy_name; ?>-tabs" class="taxonomy-tabs add-menu-item-tabs"> 
  77.             <li <?php echo ( 'most-used' == $current_tab ? ' class="tabs"' : '' ); ?>> 
  78.                 <a class="nav-tab-link" data-type="tabs-panel-<?php echo esc_attr( $taxonomy_name ); ?>-pop" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($taxonomy_name . '-tab', 'most-used', remove_query_arg($removed_args))); ?>#tabs-panel-<?php echo $taxonomy_name; ?>-pop"> 
  79.                     <?php _e( 'Most Used' ); ?> 
  80.                 </a> 
  81.             </li> 
  82.             <li <?php echo ( 'all' == $current_tab ? ' class="tabs"' : '' ); ?>> 
  83.                 <a class="nav-tab-link" data-type="tabs-panel-<?php echo esc_attr( $taxonomy_name ); ?>-all" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($taxonomy_name . '-tab', 'all', remove_query_arg($removed_args))); ?>#tabs-panel-<?php echo $taxonomy_name; ?>-all"> 
  84.                     <?php _e( 'View All' ); ?> 
  85.                 </a> 
  86.             </li> 
  87.             <li <?php echo ( 'search' == $current_tab ? ' class="tabs"' : '' ); ?>> 
  88.                 <a class="nav-tab-link" data-type="tabs-panel-search-taxonomy-<?php echo esc_attr( $taxonomy_name ); ?>" href="<?php if ( $nav_menu_selected_id ) echo esc_url(add_query_arg($taxonomy_name . '-tab', 'search', remove_query_arg($removed_args))); ?>#tabs-panel-search-taxonomy-<?php echo $taxonomy_name; ?>"> 
  89.                     <?php _e( 'Search' ); ?> 
  90.                 </a> 
  91.             </li> 
  92.         </ul><!-- .taxonomy-tabs --> 
  93.  
  94.         <div id="tabs-panel-<?php echo $taxonomy_name; ?>-pop" class="tabs-panel <?php 
  95.             echo ( 'most-used' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); 
  96.         ?>"> 
  97.             <ul id="<?php echo $taxonomy_name; ?>checklist-pop" class="categorychecklist form-no-clear" > 
  98.                 <?php 
  99.                 $popular_terms = get_terms( $taxonomy_name, array( 'orderby' => 'count', 'order' => 'DESC', 'number' => 10, 'hierarchical' => false ) ); 
  100.                 $args[walker] = $walker; 
  101.                 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $popular_terms), 0, (object) $args ); 
  102.                 ?> 
  103.             </ul> 
  104.         </div><!-- /.tabs-panel --> 
  105.  
  106.         <div id="tabs-panel-<?php echo $taxonomy_name; ?>-all" class="tabs-panel tabs-panel-view-all <?php 
  107.             echo ( 'all' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); 
  108.         ?>"> 
  109.             <?php if ( ! empty( $page_links ) ) : ?> 
  110.                 <div class="add-menu-item-pagelinks"> 
  111.                     <?php echo $page_links; ?> 
  112.                 </div> 
  113.             <?php endif; ?> 
  114.             <ul id="<?php echo $taxonomy_name; ?>checklist" data-wp-lists="list:<?php echo $taxonomy_name?>" class="categorychecklist form-no-clear"> 
  115.                 <?php 
  116.                 $args[walker] = $walker; 
  117.                 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $terms), 0, (object) $args ); 
  118.                 ?> 
  119.             </ul> 
  120.             <?php if ( ! empty( $page_links ) ) : ?> 
  121.                 <div class="add-menu-item-pagelinks"> 
  122.                     <?php echo $page_links; ?> 
  123.                 </div> 
  124.             <?php endif; ?> 
  125.         </div><!-- /.tabs-panel --> 
  126.  
  127.         <div class="tabs-panel <?php 
  128.             echo ( 'search' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); 
  129.         ?>" id="tabs-panel-search-taxonomy-<?php echo $taxonomy_name; ?>"> 
  130.             <?php 
  131.             if ( isset( $_REQUEST['quick-search-taxonomy-' . $taxonomy_name] ) ) { 
  132.                 $searched = esc_attr( $_REQUEST['quick-search-taxonomy-' . $taxonomy_name] ); 
  133.                 $search_results = get_terms( $taxonomy_name, array( 'name__like' => $searched, 'fields' => 'all', 'orderby' => 'count', 'order' => 'DESC', 'hierarchical' => false ) ); 
  134.             } else { 
  135.                 $searched = ''; 
  136.                 $search_results = array(); 
  137.             } 
  138.             ?> 
  139.             <p class="quick-search-wrap"> 
  140.                 <label for="quick-search-taxonomy-<?php echo $taxonomy_name; ?>" class="screen-reader-text"><?php _e( 'Search' ); ?></label> 
  141.                 <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; ?>" /> 
  142.                 <span class="spinner"></span> 
  143.                 <?php submit_button( __( 'Search' ), 'small quick-search-submit hide-if-js', 'submit', false, array( 'id' => 'submit-quick-search-taxonomy-' . $taxonomy_name ) ); ?> 
  144.             </p> 
  145.  
  146.             <ul id="<?php echo $taxonomy_name; ?>-search-checklist" data-wp-lists="list:<?php echo $taxonomy_name?>" class="categorychecklist form-no-clear"> 
  147.             <?php if ( ! empty( $search_results ) && ! is_wp_error( $search_results ) ) : ?> 
  148.                 <?php 
  149.                 $args[walker] = $walker; 
  150.                 echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $search_results), 0, (object) $args ); 
  151.                 ?> 
  152.             <?php elseif ( is_wp_error( $search_results ) ) : ?> 
  153.                 <li><?php echo $search_results->get_error_message(); ?></li> 
  154.             <?php elseif ( ! empty( $searched ) ) : ?> 
  155.                 <li><?php _e('No results found.'); ?></li> 
  156.             <?php endif; ?> 
  157.             </ul> 
  158.         </div><!-- /.tabs-panel --> 
  159.  
  160.         <p class="button-controls wp-clearfix"> 
  161.             <span class="list-controls"> 
  162.                 <a href="<?php 
  163.                     echo esc_url(add_query_arg( 
  164.                         array( 
  165.                             $taxonomy_name . '-tab' => 'all',  
  166.                             'selectall' => 1,  
  167.  ),  
  168.                         remove_query_arg($removed_args) 
  169.  )); 
  170.                 ?>#taxonomy-<?php echo $taxonomy_name; ?>" class="select-all aria-button-if-js"><?php _e( 'Select All' ); ?></a> 
  171.             </span> 
  172.  
  173.             <span class="add-to-menu"> 
  174.                 <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 ); ?>" /> 
  175.                 <span class="spinner"></span> 
  176.             </span> 
  177.         </p> 
  178.  
  179.     </div><!-- /.taxonomydiv --> 
  180.     <?php