wp_nav_menu_item_taxonomy_meta_box( string $data_object, array $box )

Parameters

$data_objectstring

Not used.

$boxarray

Taxonomy menu item meta box arguments.

• $idstring

  Meta box 'id' attribute.

• $titlestring

  Meta box title.

• $callbackcallable

  Meta box display callback.

• $argsobject

  Extra meta box arguments (the taxonomy object for this meta box).

Uses · 20

• get_taxonomy()Retrieves the taxonomy object of $taxonomy.
• absint()Converts a value to non-negative integer.
• get_terms()Retrieves the terms in a given taxonomy or list of taxonomies.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• __()Retrieves the translation of $text.
• wp_count_terms()Counts how many terms are in taxonomy.
• paginate_links()Retrieves paginated links for archive post pages.
• add_query_arg()Retrieves a modified URL query string.
• esc_attr__()Retrieves the translation of $text and escapes it for safe use in an attribute.
• is_taxonomy_hierarchical()Determines whether the taxonomy object is hierarchical.
• remove_query_arg()Removes an item or items from a query string.
• esc_attr()Escaping for HTML attributes.

Source

View on Trac ↗View on GitHub ↗

861function wp_nav_menu_item_taxonomy_meta_box( $data_object, $box ) {862	global $nav_menu_selected_id;863 864	$taxonomy_name = $box['args']->name;865	$taxonomy      = get_taxonomy( $taxonomy_name );866	$tab_name      = $taxonomy_name . '-tab';867 868	// Paginate browsing for large numbers of objects.869	$per_page = 50;870	$pagenum  = isset( $_REQUEST[ $tab_name ] ) && isset( $_REQUEST['paged'] ) ? absint( $_REQUEST['paged'] ) : 1;871	$offset   = 0 < $pagenum ? $per_page * ( $pagenum - 1 ) : 0;872 873	$args = array(874		'taxonomy'     => $taxonomy_name,875		'child_of'     => 0,876		'exclude'      => '',877		'hide_empty'   => false,878		'hierarchical' => 1,879		'include'      => '',880		'number'       => $per_page,881		'offset'       => $offset,882		'order'        => 'ASC',883		'orderby'      => 'name',884		'pad_counts'   => false,885	);886 887	$terms = get_terms( $args );888 889	if ( ! $terms || is_wp_error( $terms ) ) {890		echo '<p>' . __( 'No items.' ) . '</p>';891		return;892	}893 894	$num_pages = (int) ceil(895		(int) wp_count_terms(896			array_merge(897				$args,898				array(899					'number' => '',900					'offset' => '',901				)902			)903		) / $per_page904	);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	}

History

Introduced in 3.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-admin/includes/nav-menu.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.