Descriere pentru elementele de meniu? Walker personalizat pentru wp_nav_menu()

Ai nevoie de un walker personalizat pentru meniul de navigare.

Practic, adaugi un parametru 'walker' la opțiunile wp_nav_menu() și apelezi o instanță a unei clase îmbunătățite:

wp_nav_menu(
    array (
        'menu'            => 'main-menu',
        'container'       => FALSE,
        'container_id'    => FALSE,
        'menu_class'      => '',
        'menu_id'         => FALSE,
        'depth'           => 1,
        'walker'          => new Description_Walker
    )
);

Clasa Description_Walker extinde Walker_Nav_Menu și modifică funcția start_el( &$output, $item, $depth, $args ) pentru a căuta $item->description.

Un exemplu de bază:

/**
 * Creează o listă HTML de elemente de meniu de navigare.
 * Înlocuiește Walker-ul nativ, folosind descrierea.
 *
 * @see    https://wordpress.stackexchange.com/q/14037/
 * @author fuxia
 */
class Description_Walker extends Walker_Nav_Menu
{
    /**
     * Începe generarea elementului.
     *
     * @param  string $output Trimis prin referință. Folosit pentru a adăuga conținut suplimentar.
     * @param  object $item   Obiect de date al elementului de meniu.
     * @param  int $depth     Adâncimea elementului de meniu. Poate fi folosită pentru padding.
     * @param  array|object $args    Șiruri suplimentare. De fapt, întotdeauna o 
                                     instanță a stdClass. Dar acesta este WordPress.
     * @return void
     */
    function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 )
    {
        $classes     = empty ( $item->classes ) ? array () : (array) $item->classes;

        $class_names = join(
            ' '
        ,   apply_filters(
                'nav_menu_css_class'
            ,   array_filter( $classes ), $item
            )
        );

        ! empty ( $class_names )
            and $class_names = ' class="'. esc_attr( $class_names ) . '"';

        $output .= "<li id='menu-item-$item->ID' $class_names>";

        $attributes  = '';

        ! empty( $item->attr_title )
            and $attributes .= ' title="'  . esc_attr( $item->attr_title ) .'"';
        ! empty( $item->target )
            and $attributes .= ' target="' . esc_attr( $item->target     ) .'"';
        ! empty( $item->xfn )
            and $attributes .= ' rel="'    . esc_attr( $item->xfn        ) .'"';
        ! empty( $item->url )
            and $attributes .= ' href="'   . esc_attr( $item->url        ) .'"';

        // inserează descrierea doar pentru elementele de nivel superior
        // poți modifica acest aspect
        $description = ( ! empty ( $item->description ) and 0 == $depth )
            ? '<small class="nav_desc">' . esc_attr( $item->description ) . '</small>' : '';

        $title = apply_filters( 'the_title', $item->title, $item->ID );

        $item_output = $args->before
            . "<a $attributes>"
            . $args->link_before
            . $title
            . '</a> '
            . $args->link_after
            . $description
            . $args->after;

        // Deoarece $output este trimis prin referință, nu este nevoie să returnăm nimic.
        $output .= apply_filters(
            'walker_nav_menu_start_el'
        ,   $item_output
        ,   $item
        ,   $depth
        ,   $args
        );
    }
}

Sau, alternativ cum a comentat @nevvermind, poți moșteni toate funcționalitățile funcției start_el a părintelui și doar să adaugi descrierea la $output:

function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 ) 
{
    parent::start_el( $output, $item, $depth, $args );
    $output .= sprintf( 
        '<i>%s</i>', 
        esc_html( $item->description ) 
    );
}

Exemplu de rezultat:

Acum activează câmpul de descriere în wp-admin/nav-menus.php pentru a putea edita acest câmp. Dacă nu faci asta, WP va arunca întregul conținut al postării în el.

Lecturi suplimentare:

• Bug-uri asociate
• Exemplu similar cu markup și formatare diferită
• Activează caseta de descriere în ecranul de gestionare a meniurilor programatic
• Colectează descrierea elementului pentru utilizare ulterioară

Și asta e tot.