Ticket #29890: 29890.3.diff

src/wp-includes/nav-menu-template.php

@@ -151 +151 @@
                 $item_output = $args->before;
                 $item_output .= '<a'. $attributes .'>';
                 /** This filter is documented in wp-includes/post-template.php */
-                $item_output .= $args->link_before . apply_filters( 'the_title', $item->title, $item->ID ) . $args->link_after;
+                $item_output .= $args->link_before;
+                $item_output .= apply_filters( 'the_title', $item->title, $item->ID );
+                if ( $args->show_description ) {
+                        $item_output .= ' <span class="menu-item-description">' . $item->description . '</span>';
+                }
+                $item_output .= $args->link_after;
                 $item_output .= '</a>';
                 $item_output .= $args->after;
 
@@ -220 +225 @@
  *                                          in order to be selectable by the user.
  *     @type string        $items_wrap      How the list items should be wrapped. Default is a ul with an id and class.
  *                                          Uses printf() format with numbered placeholders.
+ *     @type bool          $show_description Whether to show menu item descriptions. Default false.
  * }
  * @return mixed Menu output if $echo is false, false if there are no items or no menu was found.
  */
@@ -228 +234 @@
 
         $defaults = array( 'menu' => '', 'container' => 'div', 'container_class' => '', 'container_id' => '', 'menu_class' => 'menu', 'menu_id' => '',
         'echo' => true, 'fallback_cb' => 'wp_page_menu', 'before' => '', 'after' => '', 'link_before' => '', 'link_after' => '', 'items_wrap' => '<ul id="%1$s" class="%2$s">%3$s</ul>',
-        'depth' => 0, 'walker' => '', 'theme_location' => '' );
+        'depth' => 0, 'walker' => '', 'theme_location' => '', 'show_description' => false );
 
         $args = wp_parse_args( $args, $defaults );
         /**