nav_menu_item_title
Позволяет изменить заголовок пункта меню (анкор ссылки).
Использование
add_filter( 'nav_menu_item_title', 'wp_kama_nav_menu_item_title_filter', 10, 4 ); /** * Function for `nav_menu_item_title` filter-hook. * * @param string $title The menu item's title. * @param WP_Post $menu_item The current menu item object. * @param stdClass $args An object of wp_nav_menu() arguments. * @param int $depth Depth of menu item. Used for padding. * * @return string */ function wp_kama_nav_menu_item_title_filter( $title, $menu_item, $args, $depth ){ // filter... 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 271
$title = apply_filters( 'nav_menu_item_title', $title, $menu_item, $args, $depth );