get_nav_menu_locations() │ WP 3.0.0

Получает массив зарегистрированных областей меню (расположений меню) и ID меню прикрепленных к каждой области.

Область меню регистрируются с помощью функции register_nav_menu(). Затем в админке создается меню и прикрепляется к имеющейся области.

Работает на основе: get_theme_mod()
Основа для: has_nav_menu()
1 раз — 0.000063 сек (очень быстро) | 50000 раз — 1 сек (очень быстро)

Хуков нет.

Возвращает

int[]. Массив вида: 'ярлык_области_меню' => id меню:

Array
(
	[location] => 694
	[location2] => 796
)

Использование

$locations = get_nav_menu_locations();

Примеры

0

#1 Получим ID меню которое прикреплено к указанной области

Мы зарегистрировали расположение меню с помощью register_nav_menu(). Расположение имеет ярлык my_location. Затем мы создали меню в админке и прикрепили его к этому расположению. Тогда след. код сработает так:

$locs = get_nav_menu_locations();

print_r( $locs );

/* Выведет:
Array
(
	[toolbar] => 694
)
*/

Список изменений

С версии 3.0.0 Введена.

Код get_nav_menu_locations() WP 6.5.2

wp-includes/nav-menu.php 
function get_nav_menu_locations() {
	$locations = get_theme_mod( 'nav_menu_locations' );
	return ( is_array( $locations ) ) ? $locations : array();
}

nav_menu (меню навигации)

Меню