wp_get_nav_menus()
Повертає масив (об’єктів) всіх збережених меню у базі даних.
wp_get_nav_menus() – це обгортка для функції get_terms() , яка отримує дані термінів таксономії ‘nav_menu’.
Працює на основі:
get_terms()
get_terms()
Хуки з функції
Повертає
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
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 );
}