wp_nav_menu

Примеры использования

Изменение HTML содержимого навигационного меню

function custom_nav_menu( $nav_menu, $args ) {
    // Изменение HTML содержимого навигационного меню
    return $nav_menu;
}
add_filter( 'wp_nav_menu', 'custom_nav_menu', 10, 2 );

В данном примере хук ‘wp_nav_menu’ используется для изменения HTML содержимого навигационного меню. Функция ‘custom_nav_menu’ принимает два параметра: $nav_menu (строка) — HTML содержимое навигационного меню, и $args (stdClass) — объект, содержащий аргументы функции wp_nav_menu(). Функция должна вернуть измененное HTML содержимое меню.

Создание кастомного класса для элементов меню

function custom_menu_class( $args ) {
    // Создание кастомного класса для элементов меню
    $args->menu_class = 'custom-menu-class';
    return $args;
}
add_filter( 'wp_nav_menu_args', 'custom_menu_class' );

В данном примере хук ‘wp_nav_menu_args’ используется для создания кастомного класса для элементов меню. Функция ‘custom_menu_class’ принимает один параметр $args (stdClass) — объект, содержащий аргументы функции wp_nav_menu(). В данном примере устанавливается значение свойства ‘menu_class’ в ‘custom-menu-class’.

Добавление атрибута aria-label для навигационного элемента

function custom_menu_aria_label( $args ) {
    // Добавление атрибута aria-label для навигационного элемента
    $args->container_aria_label = 'Main Menu';
    return $args;
}
add_filter( 'wp_nav_menu_args', 'custom_menu_aria_label' );

В данном примере хук ‘wp_nav_menu_args’ используется для добавления атрибута aria-label для навигационного элемента. Функция ‘custom_menu_aria_label’ принимает один параметр $args (stdClass) — объект, содержащий аргументы функции wp_nav_menu(). В данном примере устанавливается значение свойства ‘container_aria_label’ в ‘Main Menu’.

Установка callback функции в случае отсутствия меню

function custom_menu_fallback( $args ) {
    // Установка callback функции в случае отсутствия меню
    $args->fallback_cb = 'custom_menu_callback';
    return $args;
}
add_filter( 'wp_nav_menu_args', 'custom_menu_fallback' );
function custom_menu_callback() {
    // Callback функция для отображения меню по умолчанию
    echo 'No menu found.';
}

В данном примере хук ‘wp_nav_menu_args’ используется для установки callback функции в случае отсутствия меню. Функция ‘custom_menu_fallback’ принимает один параметр $args (stdClass) — объект, содержащий аргументы функции wp_nav_menu(). В данном примере устанавливается значение свойства ‘fallback_cb’ в ‘custom_menu_callback’. Функция ‘custom_menu_callback’ является callback функцией, которая будет вызвана в случае отсутствия меню и выведет сообщение ‘No menu found.’

Изменение текста перед и после ссылки

function custom_menu_link_text( $item_output, $item, $depth, $args ) {
    // Изменение текста перед и после ссылки
    $item_output = '<span class="before-link">Before</span>' . $item_output . '<span class="after-link">After</span>';
    return $item_output;
}
add_filter( 'walker_nav_menu_start_el', 'custom_menu_link_text', 10, 4 );

В данном примере хук ‘walker_nav_menu_start_el’ используется для изменения текста перед и после ссылки. Функция ‘custom_menu_link_text’ принимает четыре параметра: $item_output (строка) — HTML код ссылки, $item (object) — объект элемента меню, $depth (int) — уровень вложенности элемента меню, $args (stdClass) — объект, содержащий аргументы функции wp_nav_menu(). В данном примере текст ‘Before’ добавляется перед ссылкой, а текст ‘After’ добавляется после ссылки.

Изменение текста перед и после ссылочного текста

function custom_menu_link_text( $item_output, $item, $depth, $args ) {
    // Изменение текста перед и после ссылочного текста
    $item_output = str_replace( '</a>', '<span class="before-link-text">Before</span></a><span class="after-link-text">After</span>', $item_output );
    return $item_output;
}
add_filter( 'walker_nav_menu_start_el', 'custom_menu_link_text', 10, 4 );

В данном примере хук ‘walker_nav_menu_start_el’ используется для изменения текста перед и после ссылочного текста. Функция ‘custom_menu_link_text’ принимает четыре параметра: $item_output (строка) — HTML код ссылки, $item (object) — объект элемента меню, $depth (int) — уровень вложенности элемента меню, $args (stdClass) — объект, содержащий аргументы функции wp_nav_menu(). В данном примере текст ‘Before’ добавляется перед ссылочным текстом, а текст ‘After’ добавляется после ссылочного текста.

Отключение вывода меню на экран

function custom_menu_echo( $args ) {
    // Отключение вывода меню на экран
    $args->echo = false;
    return $args;
}
add_filter( 'wp_nav_menu_args', 'custom_menu_echo' );

В данном примере хук ‘wp_nav_menu_args’ используется для отключения вывода меню на экран. Функция ‘custom_menu_echo’ принимает один параметр $args (stdClass) — объект, содержащий аргументы функции wp_nav_menu(). В данном примере устанавливается значение свойства ‘echo’ в false.

Ограничение уровня вложенности меню

function custom_menu_depth( $args ) {
    // Ограничение уровня вложенности меню
    $args->depth = 1;
    return $args;
}
add_filter( 'wp_nav_menu_args', 'custom_menu_depth' );

В данном примере хук ‘wp_nav_menu_args’ используется для ограничения уровня вложенности меню. Функция ‘custom_menu_depth’ принимает один параметр $args (stdClass) — объект, содержащий аргументы функции wp_nav_menu(). В данном примере устанавливается значение свойства ‘depth’ в 1.

Использование кастомного класса для обхода меню

class Custom_Walker_Nav_Menu extends Walker_Nav_Menu {
    // Использование кастомного класса для обхода меню
}
$args = array(
    'walker' => new Custom_Walker_Nav_Menu()
);
wp_nav_menu( $args );

В данном примере создается кастомный класс ‘Custom_Walker_Nav_Menu’, который наследуется от базового класса ‘Walker_Nav_Menu’. Затем создается объект этого класса и передается в аргумент ‘walker’ функции wp_nav_menu(). Это позволяет использовать кастомный класс для обхода меню.

Выбор тематической области для меню

$args = array(
    'theme_location' => 'primary'
);
wp_nav_menu( $args );

В данном примере используется аргумент ‘theme_location’ для выбора тематической области для меню. Значение ‘primary’ указывает на регистрированную тематическую область с именем ‘primary’. Меню, связанное с этой тематической областью, будет выведено на экран.

Настройка обертки для элементов списка

$args = array(
    'items_wrap' => '<ul id="%1$s" class="%2$s">%3$s</ul>'
);
wp_nav_menu( $args );

В данном примере используется аргумент ‘items_wrap’ для настройки обертки для элементов списка. Значение ‘

%3$s

‘ определяет формат обертки, где %1$s заменяется на ID меню, %2$s — на CSS класс меню, а %3$s — на HTML код элементов списка.

Управление пробелами в HTML меню

$args = array(
    'item_spacing' => 'discard'
);
wp_nav_menu( $args );

В данном примере используется аргумент ‘item_spacing’ для управления пробелами в HTML меню. Значение ‘discard’ указывает на отбрасывание пробелов между элементами меню. Это позволяет уменьшить размер HTML кода меню.