wppaste
WordPress

apply_filters( 'widget_nav_menu_args', array $nav_menu_args, WP_Term $nav_menu, array $args, array $instance )

Since
4.2.0, 4.4.0
Filters the arguments for the Navigation Menu widget.

Compatibility

WordPress
since 4.4.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$nav_menu_argsarray
{ An array of arguments passed to wp_nav_menu() to retrieve a navigation menu.
@type callable|bool $fallback_cb Callback to fire if the menu doesn't exist. Default empty.
@type mixed $menu Menu ID, slug, or name.
}
  • $fallback_cbcallable|bool

    Callback to fire if the menu doesn't exist. Default empty.
  • $menumixed

    Menu ID, slug, or name.
$nav_menuWP_Term
Nav menu object for the current menu.
$argsarray
Display arguments for the current widget.
$instancearray
Array of settings for the current widget.

Where this hook fires · 1

  • wp-includes/widgets/class-wp-nav-menu-widget.php:109WP_Nav_Menu_Widget::widget()

Source code

		 *     @type mixed         $menu        Menu ID, slug, or name.		 * }		 * @param WP_Term $nav_menu      Nav menu object for the current menu.		 * @param array   $args          Display arguments for the current widget.		 * @param array   $instance      Array of settings for the current widget.		 */		wp_nav_menu( apply_filters( 'widget_nav_menu_args', $nav_menu_args, $nav_menu, $args, $instance ) ); 		echo $args['after_widget'];	} 	/**	 * Handles updating settings for the current Navigation Menu widget instance.

Changelog

Introduced in 4.2.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

4.4.0
Added the $instance parameter.from the docblock
4.2.0
Introduced.from the docblock

About this page

Parsed data
Generated from the wordpress-develop 6.9.7 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.