W3cubDocs

/WordPress

WP_Customize_Nav_Menu_Item_Setting::sort_wp_get_nav_menu_items( WP_Post[] $items, WP_Term $menu, array $args )

Re-apply the tail logic also applied on $items by wp_get_nav_menu_items().

Description

See also

Parameters

$items

(WP_Post[]) (Required) An array of menu item post objects.

$menu

(WP_Term) (Required) The menu object.

$args

(array) (Required) An array of arguments used to retrieve menu item objects.

Return

(WP_Post[]) Array of menu item objects.

Source

File: wp-includes/customize/class-wp-customize-nav-menu-item-setting.php 

public static function sort_wp_get_nav_menu_items( $items, $menu, $args ) {
		// @todo We should probably re-apply some constraints imposed by $args.
		unset( $args['include'] );

		// Remove invalid items only in front end.
		if ( ! is_admin() ) {
			$items = array_filter( $items, '_is_valid_nav_menu_item' );
		}

		if ( ARRAY_A === $args['output'] ) {
			$items = wp_list_sort(
				$items,
				array(
					$args['output_key'] => 'ASC',
				)
			);
			$i     = 1;

			foreach ( $items as $k => $item ) {
				$items[ $k ]->{$args['output_key']} = $i++;
			}
		}

		return $items;
	}

Uses

Uses Description
wp-includes/functions.php: wp_list_sort()

Sorts a list of objects, based on one or more orderby arguments.
wp-includes/load.php: is_admin()

Determines whether the current request is for an administrative interface page.

Changelog

Version Description
4.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_nav_menu_item_setting/sort_wp_get_nav_menu_items