wp_get_nav_menu_object

函数
wp_get_nav_menu_object ( $menu )
参数
  • (int|string|WP_Term) $menu Menu ID, slug, name, or object.
    Required:
返回值
  • (WP_Term|false) Menu object on success, false if $menu param isn't supplied or term does not exist.
定义位置
相关方法
wp_update_nav_menu_objectwp_get_nav_menu_namewp_get_nav_menu_itemswp_get_nav_menuswp_get_nav_menu_to_edit
引入
3.0.0
弃用
-

wp_get_nav_menu_object: 这个函数为一个特定的菜单检索菜单对象。它需要一个参数,即菜单的ID或名称,并返回一个菜单对象。

返回一个导航菜单对象。

function wp_get_nav_menu_object( $menu ) {
	$menu_obj = false;

	if ( is_object( $menu ) ) {
		$menu_obj = $menu;
	}

	if ( $menu && ! $menu_obj ) {
		$menu_obj = get_term( $menu, 'nav_menu' );

		if ( ! $menu_obj ) {
			$menu_obj = get_term_by( 'slug', $menu, 'nav_menu' );
		}

		if ( ! $menu_obj ) {
			$menu_obj = get_term_by( 'name', $menu, 'nav_menu' );
		}
	}

	if ( ! $menu_obj || is_wp_error( $menu_obj ) ) {
		$menu_obj = false;
	}

	/**
	 * Filters the nav_menu term retrieved for wp_get_nav_menu_object().
	 *
	 * @since 4.3.0
	 *
	 * @param WP_Term|false      $menu_obj Term from nav_menu taxonomy, or false if nothing had been found.
	 * @param int|string|WP_Term $menu     The menu ID, slug, name, or object passed to wp_get_nav_menu_object().
	 */
	return apply_filters( 'wp_get_nav_menu_object', $menu_obj, $menu );
}

常见问题

FAQs
查看更多 >