wp_get_nav_menus

The timeline below displays how wordpress function wp_get_nav_menus has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.4

/**
 * Returns all navigation menu objects.
 *
 * @since 3.0.0
 * @since 4.1.0 Default value of the 'orderby' argument was changed from 'none'
 *              to 'name'.
 *
 * @param array $args Optional. Array of arguments passed on to get_terms().
 *                    Default empty array.
 * @return WP_Term[] An array of menu objects.
 */
function wp_get_nav_menus($args = array())
{
    $defaults = array('taxonomy' => 'nav_menu', 'hide_empty' => false, 'orderby' => 'name');
    $args = wp_parse_args($args, $defaults);
    /**
     * Filters the navigation menu objects being returned.
     *
     * @since 3.0.0
     *
     * @see get_terms()
     *
     * @param WP_Term[] $menus An array of menu objects.
     * @param array     $args  An array of arguments used to retrieve menu objects.
     */
    return apply_filters('wp_get_nav_menus', get_terms($args), $args);
}

WordPress Version: 5.3

/**
 * Returns all navigation menu objects.
 *
 * @since 3.0.0
 * @since 4.1.0 Default value of the 'orderby' argument was changed from 'none'
 *              to 'name'.
 *
 * @param array $args Optional. Array of arguments passed on to get_terms().
 *                    Default empty array.
 * @return array Menu objects.
 */
function wp_get_nav_menus($args = array())
{
    $defaults = array('taxonomy' => 'nav_menu', 'hide_empty' => false, 'orderby' => 'name');
    $args = wp_parse_args($args, $defaults);
    /**
     * Filters the navigation menu objects being returned.
     *
     * @since 3.0.0
     *
     * @see get_terms()
     *
     * @param array $menus An array of menu objects.
     * @param array $args  An array of arguments used to retrieve menu objects.
     */
    return apply_filters('wp_get_nav_menus', get_terms($args), $args);
}

WordPress Version: 4.6

/**
 * Returns all navigation menu objects.
 *
 * @since 3.0.0
 * @since 4.1.0 Default value of the 'orderby' argument was changed from 'none'
 *              to 'name'.
 *
 * @param array $args Optional. Array of arguments passed on to get_terms().
 *                    Default empty array.
 * @return array Menu objects.
 */
function wp_get_nav_menus($args = array())
{
    $defaults = array('hide_empty' => false, 'orderby' => 'name');
    $args = wp_parse_args($args, $defaults);
    /**
     * Filters the navigation menu objects being returned.
     *
     * @since 3.0.0
     *
     * @see get_terms()
     *
     * @param array $menus An array of menu objects.
     * @param array $args  An array of arguments used to retrieve menu objects.
     */
    return apply_filters('wp_get_nav_menus', get_terms('nav_menu', $args), $args);
}

WordPress Version: 4.1

/**
 * Returns all navigation menu objects.
 *
 * @since 3.0.0
 * @since 4.1.0 Default value of the 'orderby' argument was changed from 'none'
 *              to 'name'.
 *
 * @param array $args Optional. Array of arguments passed on to {@see get_terms()}.
 *                    Default empty array.
 * @return array Menu objects.
 */
function wp_get_nav_menus($args = array())
{
    $defaults = array('hide_empty' => false, 'orderby' => 'name');
    $args = wp_parse_args($args, $defaults);
    /**
     * Filter the navigation menu objects being returned.
     *
     * @since 3.0.0
     *
     * @see get_terms()
     *
     * @param array $menus An array of menu objects.
     * @param array $args  An array of arguments used to retrieve menu objects.
     */
    return apply_filters('wp_get_nav_menus', get_terms('nav_menu', $args), $args);
}

WordPress Version: 3.9

/**
 * Returns all navigation menu objects.
 *
 * @since 3.0.0
 *
 * @param array $args Array of arguments passed on to get_terms().
 * @return array menu objects
 */
function wp_get_nav_menus($args = array())
{
    $defaults = array('hide_empty' => false, 'orderby' => 'none');
    $args = wp_parse_args($args, $defaults);
    /**
     * Filter the navigation menu objects being returned.
     *
     * @since 3.0.0
     *
     * @see get_terms()
     *
     * @param array $menus An array of menu objects.
     * @param array $args  An array of arguments used to retrieve menu objects.
     */
    return apply_filters('wp_get_nav_menus', get_terms('nav_menu', $args), $args);
}

WordPress Version: 3.7

/**
 * Returns all navigation menu objects.
 *
 * @since 3.0.0
 *
 * @param array $args Array of arguments passed on to get_terms().
 * @return array menu objects
 */
function wp_get_nav_menus($args = array())
{
    $defaults = array('hide_empty' => false, 'orderby' => 'none');
    $args = wp_parse_args($args, $defaults);
    return apply_filters('wp_get_nav_menus', get_terms('nav_menu', $args), $args);
}