Создание своего HTML кода для меню wp_nav_menu()

Пример расширения класса Walker_Nav_Menu, для создания своего произвольного HTML кода который выводится функцией wp_nav_menu(). Наш HTML код будет написан специально для нашей темы.

Ниже код своего произвольного класса, который строит меню. Он добавляет глубину меню и четные/нечетные CSS классы к элементам меню (обоим ul и li):

Чтобы не изобретать велосипед, копируем код класса Walker_Nav_Menu{} и просто изменяем его как нам нужно.

/**
 * Пользовательский класс walker для навигационных меню.
 */
class My_Walker_Nav_Menu extends Walker_Nav_Menu {

	/**
	 * Добавляет классы к подменю (ul).
	 *
	 * @return void
	 */
	function start_lvl( &$output, $depth = 0, $args = null ) {
		// классы, зависящие от уровня вложенности
		$indent = ( $depth > 0  ? str_repeat( "\t", $depth ) : '' ); // отступ в коде
		$display_depth = ( $depth + 1); // потому что первый уровень подменю считается как 0
		$classes = [
			'sub-menu',
			( $display_depth % 2 ? 'menu-odd' : 'menu-even' ),
			( $display_depth >= 2 ? 'sub-sub-menu' : '' ),
			'menu-depth-' . $display_depth,
		];
		$class_names = implode( ' ', $classes );

		$output .= "\n" . $indent . '<ul class="' . $class_names . '">' . "\n";
	}

	//

	/**
	 * Добавляет основные классы для li и ссылок.
	 *
	 * @return void
	 */
	function start_el( &$output, $data_object, $depth = 0, $args = null, $current_object_id = 0 ) {
		$item = $data_object; // используем более описательное имя для использования внутри этого метода.

		$indent = ( $depth > 0 ? str_repeat( "\t", $depth ) : '' ); // отступ в коде

		// классы, зависящие от уровня вложенности
		$depth_classes = [
			( $depth == 0 ? 'main-menu-item' : 'sub-menu-item' ),
			( $depth >= 2 ? 'sub-sub-menu-item' : '' ),
			( $depth % 2 ? 'menu-item-odd' : 'menu-item-even' ),
			'menu-item-depth-' . $depth,
		];
		$depth_class_names = esc_attr( implode( ' ', $depth_classes ) );

		// переданные классы
		$classes = empty( $item->classes ) ? [] : (array) $item->classes;
		$class_names = esc_attr( implode( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item ) ) );

		// создание HTML
		$output .= $indent . '<li id="nav-menu-item-'. $item->ID . '" class="' . $depth_class_names . ' ' . $class_names . '">';

		// атрибуты ссылки
		$attributes  = ! empty( $item->attr_title ) ? ' title="'  . esc_attr( $item->attr_title ) .'"' : '';
		$attributes .= ! empty( $item->target )     ? ' target="' . esc_attr( $item->target     ) .'"' : '';
		$attributes .= ! empty( $item->xfn )        ? ' rel="'    . esc_attr( $item->xfn        ) .'"' : '';
		$attributes .= ! empty( $item->url )        ? ' href="'   . esc_attr( $item->url        ) .'"' : '';
		$attributes .= ' class="menu-link ' . ( $depth > 0 ? 'sub-menu-link' : 'main-menu-link' ) . '"';

		$item_output = strtr( '{BEFORE}<a{ATTRIBUTES}>{LINK_BEFORE}{TITLE}{LINK_AFTER}</a>{AFTER}', [
			'{BEFORE}'      => $args->before,
			'{ATTRIBUTES}'  => $attributes,
			'{LINK_BEFORE}' => $args->link_before,
			'{TITLE}'       => apply_filters( 'the_title', $item->title, $item->ID ),
			'{LINK_AFTER}'  => $args->link_after,
			'{AFTER}'       => $args->after,
		] );

		$output .= apply_filters( 'walker_nav_menu_start_el', $item_output, $item, $depth, $args );
	}

}

Теперь, когда класс готов, используем его в функции wp_nav_menu(). Для этого нужно указать экземпляр нашего класса в параметре walker.

function my_nav_menu( $args ) {

	$args = array_merge( [
		'container'       => 'div',
		'container_id'    => 'top-navigation-primary',
		'container_class' => 'top-navigation',
		'menu_class'      => 'menu main-menu menu-depth-0 menu-even',
		'echo'            => false,
		'items_wrap'      => '<ul id="%1$s" class="%2$s">%3$s</ul>',
		'depth'           => 10,
		'walker'          => new My_Walker_Nav_Menu()
	], $args );

	echo wp_nav_menu( $args );
}

Теперь там, где нужно выводить меню используем нашу функцию:

my_nav_menu( [ 'theme_location'  => 'navigation_menu_primary' ] );