Описание nav_menu_description
— Filter
Хук nav_menu_description позволяет изменить или добавить описание к пунктам меню в WordPress. Он срабатывает при выводе меню и позволяет настроить отображение описаний для каждого пункта меню, что может улучшить пользовательский опыт и SEO-позиции
Примеры использования
Пример добавления описания к пункту меню:
add_filter('nav_menu_description', function($description, $item_id) {
if ($item_id == 42) {
$description = 'Это описание для пункта меню';
}
return $description;
}, 10, 2);
В этом примере мы добавляем описание к пункту меню с ID 42
Пример изменения описания для нескольких пунктов меню:
add_filter('nav_menu_description', function($description, $item_id) {
if (in_array($item_id, [42, 43])) {
$description = 'Общее описание для нескольких пунктов';
}
return $description;
}, 10, 2);
Здесь мы изменяем описание для пунктов меню с ID 42 и 43
Пример добавления HTML-кода в описание:
add_filter('nav_menu_description', function($description, $item_id) {
if ($item_id == 42) {
$description = '<span class="custom-class">Это описание для пункта меню</span>';
}
return $description;
}, 10, 2);
Мы добавляем HTML-код с классом для стилизации описания
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо настроить описания пунктов меню для улучшения навигации и SEO
– Производительность
Хук не должен существенно влиять на производительность, так как изменения касаются только вывода текста
– Предупреждения
Следите за тем, чтобы добавляемый HTML-код был безопасным и не нарушал структуру меню
Альтернативы
Тип: filter
Этот хук позволяет изменять заголовок пункта меню, включая возможность добавления описания прямо в заголовок
Используйте его, если хотите изменить заголовок пункта меню, а не только его описание
