wp_get_nav_menus() │ WP 3.0.0

Повертає масив (об’єктів) всіх збережених меню у базі даних.

wp_get_nav_menus() – це обгортка для функції get_terms() , яка отримує дані термінів таксономії ‘nav_menu’.

Працює на основі:
get_terms()

Хуки з функції

wp_get_nav_menus

Повертає

WP_Term[]. Масив, який містить об’єкти з даними про кожне меню.

Використання

wp_get_nav_menus ($ args);

$args (масив): Масив аргументів, за якими будуть отримані меню. Які аргументи можна передати дивіться у функції
get_terms() . За замовчуванням встановлюються:
array( 'hide_empty' => false, 'orderby' => 'name' );

За замовчуванням: array()

Приклади

#1 Демонстрація роботи функції

$menus = wp_get_nav_menus($args);
print_r($menus);

/*
Поверне:

Array
(
	[0] => stdClass Object
		(
			[term_id] => 3
			[name] => меню 1
			[slug] => %d0%bc%d0%b5%d0%bd%d1%8e-1
			[term_group] => 0
			[term_taxonomy_id] => 3
			[taxonomy] => nav_menu
			[description] =>
			[parent] => 0
			[count] => 1
		)

	[1] => stdClass Object
		(
			[term_id] => 4
			[name] => Меню 2
			[slug] => %d0%bc%d0%b5%d0%bd%d1%8e-2
			[term_group] => 0
			[term_taxonomy_id] => 4
			[taxonomy] => nav_menu
			[description] =>
			[parent] => 0
			[count] => 2
		)
)
*/

список змін

З версії 3.0.0	Введено.
З версії 4.1.0	Детальнiше значення ‘ orderby `‘` argument було змінено з `‘none’` to `‘name’` .

Код `wp_get_nav_menus() wp get nav menus` ^{WP 6.0.2}

wp-includes/nav-menu.php

function wp_get_nav_menus( $args = array() ) {
	$defaults = array(
		'taxonomy' => 'nav_menu',
		'hide_empty' => false,
		'orderby' => 'name',
	);
	$ args = wp_parse_args ($ args, $ defaults);

	/**
	 * Filters navigation menu objects being returned.
	 *
	 * @ Since 3.0.0
	 *
	 * @see get_terms()
	 *
	 * @param WP_Term[] $menus An array of menu objects.
	 * @param array $args На array of arguments use retrieve menu objects.
	 */
	return apply_filters( 'wp_get_nav_menus', get_terms( $args ), $args );
}