nav_menu_item_args │ хук-фільтр │ WP 4.4.0

Дозволяє змінити параметри (аргументи) окремого елемента меню навігації (wp_nav_menu).

Використання

add_filter( 'nav_menu_item_args', 'wp_kama_nav_menu_item_args_filter', 10, 3);

/**
 * Function for `nav_menu_item_args` filter-hook.
 *
 * @param stdClass $args An object of wp_nav_menu() arguments.
 * @param WP_Post $menu_item Menu item data object.
 * @param int $depth Відомості про меню. Використовується для padding.
 *
 * @return stdClass
 */
function wp_kama_nav_menu_item_args_filter( $args, $menu_item, $depth ){

	// Filter...
	return $args;
}

$args (stdClass)

Об’єкт з аргументами, що передаються у функцію wp_nav_menu() .

Наприклад:

stdClass Object
(
	[menu] => WP_Term Object
		(
			[term_id] => 22
			[name] => Друге меню
			[slug] => vtoroye-menyu
			[term_group] => 0
			[term_taxonomy_id] => 22
			[taxonomy] => nav_menu
			[description] =>
			[parent] => 0
			[count] => 3
			[filter] => raw
		)

	[container] => div
	[container_class] =>
	[container_id] =>
	[menu_class] => primary-menu
	[menu_id] =>
	[echo] => 1
	[fallback_cb] => wp_page_menu
	[before] =>
	[after] =>
	[link_before] =>
	[link_after] =>
	[items_wrap] => <ul id="%1$s" class="%2$s">%3$s</ul>
	[item_spacing] => preserve
	[depth] => 0
	[walker] =>
	[theme_location] => primary
)

$item (WP_Post)

Об’єкт із даними пункту меню. Наприклад:

WP_Post Object
(
	[ID] => 268
	[post_author] => 1
	[post_date] => 2018-04-07 09:46:17
	[post_date_gmt] => 2018-04-07 06:46:17
	[post_content] =>
	[post_title] =>
	[post_excerpt] =>
	[post_status] => publish
	[comment_status] => closed
	[ping_status] => closed
	[post_password] =>
	[post_name] => 268
	[to_ping] =>
	[pinged] =>
	[post_modified] => 2018-04-18 01:21:48
	[post_modified_gmt] => 2018-04-17 22:21:48
	[post_content_filtered] =>
	[post_parent] => 0
	[guid] => http://wp-test.ru/?p=268
	[menu_order] => 1
	[post_type] => nav_menu_item
	[post_mime_type] =>
	[comment_count] => 0
	[filter] => raw
	[db_id] => 268
	[menu_item_parent] => 0
	[object_id] => 113
	[object] => post
	[type] => post_type
	[type_label] => Запис
	[url] => http://wp-test.ru/post-105
	[title] => Запис 105
	[target] =>
	[attr_title] =>
	[description] =>
	[classes] => Array
		(
			[0] =>
			[1] => menu-item
			[2] => menu-item-type-post_type
			[3] => menu-item-object-post
		)

	[xfn] =>
	[current] =>
	[current_item_ancestor] =>
	[current_item_parent] =>
)

$depth (число)

Рівень пункту меню. Доданий до версії 4.1.0. Використовується для відступів. Верхні пункти меню мають $depth = 0, вкладені у яких $depth = 1 тощо.

Приклади

#1 Додавання іконок до пунктів меню

Додає іконку до посилань меню, прикріплену до області меню primary:

function change_menu_item_args( $args ) {
	if ( $args->theme_location == 'primary' ) {
		$args->link_before = '<span class="dashicons dashicons-admin-links"></span>';
	}

	return $args;
}

add_filter( 'nav_menu_item_args', 'change_menu_item_args');

Додає іконку до посилань всіх меню, де пункт меню – сторінка, решта елементів виведеться як завжди (без іконки):

function change_menu_item_args( $args, $item ) {
	if ( $item->object == 'page' ) {
		$args->link_before = '<span class="dashicons dashicons-admin-links"></span>';
	}

	return $args;
}

add_filter( 'nav_menu_item_args', 'change_menu_item_args', 10, 2);

Додає іконку до посилань верхнього рівня у всіх меню:

function change_menu_item_args( $args, $item, $depth ) {
	if ( $depth === 0 ) {
		$args->link_before = '<span class="dashicons dashicons-admin-links"></span>';
	}

	return $args;
}

add_filter( 'nav_menu_item_args', 'change_menu_item_args', 10, 3);

Додає іконки до посилань пунктів меню, які задовольняють всі три умови:

function change_menu_item_args( $args, $item, $depth ) {
	if ( $args->theme_location == 'primary' && $item->object == 'page' && $depth === 0 ) {
		$args->link_before = '<span class="dashicons dashicons-admin-links"></span>';
	}

	return $args;
}

add_filter( 'nav_menu_item_args', 'change_menu_item_args', 10, 3);