Как мне создать собственную систему меню / подменю с помощью wp_get_nav_menu_items в WordPress?

Для тех, кто занимается чем-то подобным, вот мое решение:

Краткий пример кода по сути

Вот код в github gist для всех, кто хочет принять участие в действии копирования и вставки.

TL;DR

TL; DR Перебрать список, развернуть, если есть подменю, закрыть, если мы дойдем до конца подменю и меню.

Полное объяснение кода

Сначала получите элементы меню в виде плоского массива:

<?php
$menu_name = 'main_nav';
$locations = get_nav_menu_locations();
$menu = wp_get_nav_menu_object( $locations[ $menu_name ] );
$menuitems = wp_get_nav_menu_items( $menu->term_id, array( 'order' => 'DESC' ) );
?>

Затем переберите массив пунктов меню:

<nav>
<ul class="main-nav">
    <?php
    $count = 0;
    $submenu = false;

    foreach( $menuitems as $item ):
        // set up title and url
        $title = $item->title;
        $link = $item->url;

        // item does not have a parent so menu_item_parent equals 0 (false)
        if ( !$item->menu_item_parent ):

        // save this id for later comparison with sub-menu items
        $parent_id = $item->ID;
    ?>

Напишите первый родительский элемент <li>:

    <li class="item">
        <a href="<?php echo $link; ?>" class="title">
            <?php echo $title; ?>
        </a>
    <?php endif; ?>

Убедитесь, что родительский идентификатор этого элемента соответствует сохраненному родительскому идентификатору:

        <?php if ( $parent_id == $item->menu_item_parent ): ?>

Запустите подменю <ul> и установите для флага $submenu значение true для дальнейшего использования:

            <?php if ( !$submenu ): $submenu = true; ?>
            <ul class="sub-menu">
            <?php endif; ?>

Напишите пункт подменю:

                <li class="item">
                    <a href="<?php echo $link; ?>" class="title"><?php echo $title; ?></a>
                </li>

Если следующий элемент не имеет того же родительского идентификатора и у нас объявлено подменю, закройте подменю <ul>

            <?php if ( $menuitems[ $count + 1 ]->menu_item_parent != $parent_id && $submenu ): ?>
            </ul>
            <?php $submenu = false; endif; ?>

        <?php endif; ?>

Опять же, если следующий элемент в массиве не имеет того же родительского идентификатора, закройте <li>

    <?php if ( $menuitems[ $count + 1 ]->menu_item_parent != $parent_id ): ?>
    </li>                           
    <?php $submenu = false; endif; ?>

<?php $count++; endforeach; ?>

  </ul>
</nav>

Лучше всего создать собственный класс Walker, чтобы адаптировать выходные данные к вашим потребностям. Что-то вроде этого:

class Excerpt_Walker extends Walker_Nav_Menu
{
    function start_el(&$output, $item, $depth, $args)
    {
        global $wp_query;
        $indent = ( $depth ) ? str_repeat( "\t", $depth ) : '';

        $class_names = $value = '';

        $classes = empty( $item->classes ) ? array() : (array) $item->classes;
        $classes[] = 'menu-item-' . $item->ID;

        $class_names = join( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item, $args ) );
        $class_names = ' class="' . esc_attr( $class_names ) . '"';

        $id = apply_filters( 'nav_menu_item_id', 'menu-item-'. $item->ID, $item, $args );
        $id = strlen( $id ) ? ' id="' . esc_attr( $id ) . '"' : '';

        $output .= $indent . '<li' . $id . $value . $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        ) .'"' : '';

        $item_output = $args->before;
        $item_output .= '<a'. $attributes .'>';

        $item_output .= $args->link_before . apply_filters( 'the_title', $item->title, $item->ID ) . $args->link_after;

        /*GET THE EXCERPT*/
        $q = new WP_Query(array('post__in'=>$item->object_id));
        if($q->have_posts()) : while($q->have_posts()) : $q->the_post();
            $item_output .= '<span class="menu-excerpt">'.get_the_excerpt().'</span>';
        endwhile;endif;
        /*****************/

        $item_output .= '</a>';
        $item_output .= $args->after;

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

А потом назовите это так:

<?php
wp_nav_menu(array('walker' => new Excerpt_Walker()));
?>

Все до и после маркера GET THE EXCERPT в моем примере было прямой копией функции start_el в wp-includes / nav-menu-template.php. В моем примере используется WP_Query, чтобы определить, есть ли отрывок в сообщении / странице, и помещается отрывок между тегами span после заголовка ссылки.

Идея заключалась бы в том, чтобы теги span появлялись только при наведении курсора, что можно сделать с помощью CSS.

Больше информации о ходунках здесь:

Кодекс меню WP Nav

Использование класса Walker

Еще один достойный пример использования класса Walker