W3cubDocs

/WordPress

WP_Customize_Nav_Menus::render_nav_menu_partial( WP_Customize_Partial $partial, array $nav_menu_args )

Render a specific menu via wp_nav_menu() using the supplied arguments.

Description

See also

Parameters

$partial

(WP_Customize_Partial) (Required) Partial.

$nav_menu_args

(array) (Required) Nav menu args supplied as container context.

Return

(string|false)

Source

File: wp-includes/class-wp-customize-nav-menus.php 

public function render_nav_menu_partial( $partial, $nav_menu_args ) {
		unset( $partial );

		if ( ! isset( $nav_menu_args['args_hmac'] ) ) {
			// Error: missing_args_hmac.
			return false;
		}

		$nav_menu_args_hmac = $nav_menu_args['args_hmac'];
		unset( $nav_menu_args['args_hmac'] );

		ksort( $nav_menu_args );
		if ( ! hash_equals( $this->hash_nav_menu_args( $nav_menu_args ), $nav_menu_args_hmac ) ) {
			// Error: args_hmac_mismatch.
			return false;
		}

		ob_start();
		wp_nav_menu( $nav_menu_args );
		$content = ob_get_clean();

		return $content;
	}

Uses

Uses Description
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::hash_nav_menu_args()

Hashes (hmac) the nav menu arguments to ensure they are not tampered with when submitted in the Ajax request.
wp-includes/compat.php: hash_equals()

Timing attack safe string comparison
wp-includes/nav-menu-template.php: wp_nav_menu()

Displays a navigation menu.

Changelog

Version Description
4.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_nav_menus/render_nav_menu_partial