# wp_get_nav_menu_items()

URL: https://chugunov.pro/api-wordpress/functions/wp_get_nav_menu_items/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.0.0.

## Сигнатура

```php
wp_get_nav_menu_items( int|string|WP_Term $menu, array $args = array() ): array|false
```

## Описание

Примечание: большинство аргументов, передаваемых в параметр $args (кроме 'output_key'), предназначены именно для получения записей nav_menu_item из get_posts() и могут лишь косвенно влиять на итоговый порядок и содержимое элементов меню навигации, возвращаемых этой функцией.

## Параметры

- `$menu` `int|string|WP_Term` — обязательный. ID меню, слаг, имя или объект.
- `$args` `array` — необязательный, по умолчанию `array()`. Аргументы для передачи в get_posts() .
  
  order stringКак упорядочить элементы меню навигации при запросе через get_posts() .
  
  Будет проигнорировано, если 'output' равно ARRAY_A. По умолчанию 'ASC'.
  
  orderby stringПоле, по которому упорядочиваются элементы меню при получении из get_posts() .
  
  Укажите поле сортировки через 'output_key', чтобы повлиять на порядок вывода элементов меню навигации. По умолчанию 'menu_order'.
  
  post_type stringТип записи элементов меню. По умолчанию 'nav_menu_item'.
  
  post_status stringСтатус записи элементов меню. По умолчанию 'publish'.
  
  output stringКак упорядочить выводимые элементы меню. По умолчанию ARRAY_A.
  
  output_key stringКлюч, используемый для упорядочивания фактически возвращаемых элементов меню. Обратите внимание, что это не аргумент get_posts() и он влияет только на вывод элементов меню, обработанных этой функцией. По умолчанию 'menu_order'.
  
  nopaging boolПолучать все элементы меню (true) или разбивать на страницы (false). По умолчанию true.
  
  update_menu_item_cache boolОбновлять ли кэш элементов меню. По умолчанию true.

## Возвращаемое значение

`array|false`

## Исходный код

Файл: `wp-includes/nav-menu.php:712`

```php
function wp_get_nav_menu_items( $menu, $args = array() ) {
	$menu = wp_get_nav_menu_object( $menu );

	if ( ! $menu ) {
		return false;
	}

	if ( ! taxonomy_exists( 'nav_menu' ) ) {
		return false;
	}

	$defaults = array(
		'order'                  => 'ASC',
		'orderby'                => 'menu_order',
		'post_type'              => 'nav_menu_item',
		'post_status'            => 'publish',
		'output'                 => ARRAY_A,
		'output_key'             => 'menu_order',
		'nopaging'               => true,
		'update_menu_item_cache' => true,
		'tax_query'              => array(
			array(
				'taxonomy' => 'nav_menu',
				'field'    => 'term_taxonomy_id',
				'terms'    => $menu->term_taxonomy_id,
			),
		),
	);
	$args     = wp_parse_args( $args, $defaults );
	if ( $menu->count > 0 ) {
		$items = get_posts( $args );
	} else {
		$items = array();
	}

	$items = array_map( 'wp_setup_nav_menu_item', $items );

	if ( ! is_admin() ) { // Remove invalid items only on front end.
		$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++;
		}
	}

	/**
	 * Filters the navigation menu items being returned.
	 *
	 * @since 3.0.0
	 *
	 * @param array  $items An array of menu item post objects.
	 * @param object $menu  The menu object.
	 * @param array  $args  An array of arguments used to retrieve menu item objects.
	 */
	return apply_filters( 'wp_get_nav_menu_items', $items, $menu, $args );
}
```

## История изменений

- 3.0.0 — Introduced.

## Связанные

Использует: [`wp_list_sort`](https://chugunov.pro/api-wordpress/functions/wp_list_sort/), [`taxonomy_exists`](https://chugunov.pro/api-wordpress/functions/taxonomy_exists/), [`get_posts`](https://chugunov.pro/api-wordpress/functions/get_posts/), [`wp_get_nav_menu_object`](https://chugunov.pro/api-wordpress/functions/wp_get_nav_menu_object/), [`is_admin`](https://chugunov.pro/api-wordpress/functions/is_admin/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: `WP_Classic_To_Block_Menu_Converter::convert`, `WP_Customize_Nav_Menus::customize_register`, [`wp_nav_menu_update_menu_items`](https://chugunov.pro/api-wordpress/functions/wp_nav_menu_update_menu_items/), [`wp_get_nav_menu_to_edit`](https://chugunov.pro/api-wordpress/functions/wp_get_nav_menu_to_edit/), [`wp_nav_menu`](https://chugunov.pro/api-wordpress/functions/wp_nav_menu/), [`_wp_auto_add_pages_to_menu`](https://chugunov.pro/api-wordpress/functions/_wp_auto_add_pages_to_menu/), [`wp_update_nav_menu_item`](https://chugunov.pro/api-wordpress/functions/wp_update_nav_menu_item/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_get_nav_menu_items/