nav_menu_item_title хук-фильтр . WP 4.4.0
Позволяет изменить заголовок пункта меню (анкор ссылки).
Использование
add_filter( 'nav_menu_item_title', 'filter_function_name_2880', 10, 4 ); function filter_function_name_2880( $title, $item, $args, $depth ){ // Изменяем... return $title; }
- $title(строка)
- Заголовок пункта меню.
- $item(WP_Post)
Объект текущего пункта меню. Пример:
- $args(stdClass)
Объект с аргументами из функции wp_nav_menu(). Пример:
- $depth(число)
- Уровень пункта меню. Добавлен в версии 4.1.0. Используется для отступов. Верхние пункты меню имеют $depth = 0, вложенные в них $depth = 1 и так далее.
Примеры
#1 Добавить иконку перед заголовком пункта меню
В примере используется шрифтовая иконка из набора dashicons .
add_filter( 'nav_menu_item_title', 'filter_nav_menu_item_title', 10, 4 ); function filter_nav_menu_item_title( $title, $item, $args, $depth ) { $title = '<span class="dashicons dashicons-wordpress-alt"></span> ' . $title; return $title; }
Аналогичный результат может быть получен при выводе меню:
wp_nav_menu( [ 'link_before' => '<span class="dashicons dashicons-wordpress-alt"></span> ', ] );
Список изменений
С версии 4.4.0 | Введена. |
Где вызывается хук
nav_menu_item_title
wp-includes/class-walker-nav-menu.php 225
$title = apply_filters( 'nav_menu_item_title', $title, $item, $args, $depth );