get_nav_menu_locations()
Получает массив зарегистрированных областей меню (расположений меню) и 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();
Примеры
#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() get nav menu locations WP 6.7.1
function get_nav_menu_locations() { $locations = get_theme_mod( 'nav_menu_locations' ); return ( is_array( $locations ) ) ? $locations : array(); }